rfm@gnu.org
)Copyright: (C) 2004 Free Software Foundation, Inc.
- Declared in:
- Foundation/NSXMLParser.h
Standards:
- MacOS-X
- NotOpenStep
- GNUstep
This class is a PRE-ALPHA implementation. You should be
prepared to track down and fix bugs and prefereably
contribute fixes back.
If you don't want to
do that, use the
GSXMLParser
class instead... This NSXMLParser class is
implemented as a wrapper round some of the
functionality of the more powerful GSXML
APis, and is intended as a MacOSX compatibility
feature.
This class implements an event driven parser handling the parsing process by sending messages to a delegate when certain parts of the XML document being parsed are encountered.
To use the class, you create and initialise an instance with a particular XML document, set the delegate of the instance, and send a -parse message to it. The delegate must then make use of the information it receives in the messages it gets from the parser.
The NSObject(NSXMLParserDelegateEventAdditions) informal protocol documents the methods which the delegate object may implement in order to handle the parsing process.
Method summary
Terminates the current parse operation and sends an error to the delegate of the parser.
Returns the delegate previously set using
-setDelegate:
or nil
if no delegate is set.
Convenience method fetching data from
anURL.
Initialises the parser with the specified xml data.
Parses the supplied data and returns
YES
on succdess, NO
otherwise.
Returns the last error produced by parsing (if any).
Sets the parser delegate (which is not retained).
Set flag to determine whether the namespaceURI and the qualified name of an element is provided in the [NSObject -parser:didStartElement:namespaceURI:qualifiedName:attributes:] and [NSObject -parser:didEndElement:namespaceURI:qualifiedName:] methods.
Sets a flag to specify whether the parser should call the [NSObject -parser:didStartMappingPrefix:toURI:] and [NSObject -parser:didEndMappingPrefix:] delegate methods.
Sets flag to determine if declarations of external entities are reported using [NSObject -parser:foundExternalEntityDeclarationWithName:publicID:systemID:]
Returns the value set by -setShouldProcessNamespaces:
Returns the value set by -setShouldReportNamespacePrefixes:
Returns the value set by -setShouldResolveExternalEntities:
- Declared in:
- Foundation/NSXMLParser.h
Standards:
- MacOS-X
- NotOpenStep
- GNUstep
Methods implemented by a delegate in order to make
use of the parser.
This is an informal protocol.
Description forthcoming.
Description forthcoming.
Called when the start of an element is encountered in the document, this provides the name of the element, a dictionary containing the attributes (if any) and (where namespaces are used) the namespace information for the element.
Description forthcoming.
Description forthcoming.
Description forthcoming.
Description forthcoming.
Description forthcoming.
Description forthcoming.
Description forthcoming.
Description forthcoming.
Description forthcoming.
Description forthcoming.
Description forthcoming.
Description forthcoming.
Description forthcoming.
Description forthcoming.
Description forthcoming.
Called when parsing ends.
Called when parsing begins.
- Declared in:
- Foundation/NSXMLParser.h
Standards:
- MacOS-X
- NotOpenStep
- GNUstep
Description forthcoming.
Method summaryReturns the current column number of the document being parsed.
Returns the current line number of the document being parsed.
Returns the public identifier of the external entity in the document being parsed.
Returns the system identifier of the external entity in the document being parsed.