CFXMLNode Reference

Overview

A CFXMLNode object describes an individual XML construct—like a tag, or a comment, or a string of character data. CFXMLNode is intended to be used with the CFXMLParser and CFXMLTree opaque types.

Each CFXMLNode object contains three main pieces of information—the node's type, the data string, and a pointer to an additional information data structure. A CFXMLNode object’s type is one of the enumerations described in Node Type Code. The data string is always a CFString object; the meaning of the string is dependent on the node's type. The format of the additional data is also dependent on the node's type; in general, there is a custom structure for each type that requires additional data. See Node Type Code for the mapping from a node type to meaning of the data string, and structure of the additional information. Note that these structures are versioned and may change as the parser changes. The current version can always be identified by the kCFXMLNodeCurrentVersion constant; earlier versions can be identified and used by passing earlier values for the version number (although the older structures would have been removed from the header).

You create a CFXMLNode object using one of the create or copy functions. Use the CFXMLNodeGetTypeCode, CFXMLNodeGetString, and CFXMLNodeGetInfoPtr functions to get the node type, data string, and additional information respectively. Use the CFXMLNodeGetVersion function to get a node’s version number.

Data Types

CFXMLAttributeDeclarationInfo

Contains information about an element attribute definition.

struct CFXMLAttributeDeclarationInfo {
   CFStringRef attributeName;
   CFStringRef typeString;
   CFStringRef defaultString;
};
typedef struct CFXMLAttributeDeclarationInfo CFXMLAttributeDeclarationInfo;

Fields

attributeName

The name of the attribute.

typeString

Describes the declaration of a single attribute.

defaultString

The attribute's default value.

CFXMLAttributeListDeclarationInfo

Contains a list of the attributes associated with an element.

struct CFXMLAttributeListDeclarationInfo {
   CFIndex numberOfAttributes;
   CFXMLAttributeDeclarationInfo *attributes;
};
typedef struct CFXMLAttributeListDeclarationInfo  CFXMLAttributeListDeclarationInfo;

Fields

numberOfAttributes

The number of attributes in the array.

attributes

A C array of attributes.

CFXMLDocumentInfo

Contains the source URL and text encoding information for the XML document.

struct CFXMLDocumentInfo {
   CFURLRef sourceURL;
   CFStringEncoding encoding;
};
typedef struct CFXMLDocumentInfo CFXMLDocumentInfo;

Fields

sourceURL

The source URL of the XML document.

encoding

The text encoding of the XML document.

CFXMLDocumentTypeInfo

Contains the external ID of the DTD.

struct CFXMLDocumentTypeInfo {
   CFXMLExternalID externalID;
};
typedef struct CFXMLDocumentTypeInfo CFXMLDocumentTypeInfo;

Fields

externalID

The external ID of the DTD.

CFXMLElementInfo

Contains a list of element attributes packaged as CFDictionary key/value pairs.

struct CFXMLElementInfo {
   CFDictionaryRef attributes;
   CFArrayRef attributeOrder;
   Boolean isEmpty;
};
typedef struct CFXMLElementInfo CFXMLElementInfo;

Fields

attributes

The dictionary of attribute values.

attributeOrder

An array specifying the order in which the attributes appeared in the XML document.

isEmpty

A flag indicating whether the element was expressed in closed form.

CFXMLElementTypeDeclarationInfo

Contains a description of the element type.

struct CFXMLElementTypeDeclarationInfo {
   CFStringRef contentDescription;
};
typedef struct CFXMLElementTypeDeclarationInfo CFXMLElementTypeDeclarationInfo;

Fields

contentDescription

A textual description of the element type.

CFXMLEntityInfo

Contains information describing an XML entity.

struct CFXMLEntityInfo {
   CFXMLEntityTypeCode entityType;
   CFStringRef replacementText;
   CFXMLExternalID entityID;
   CFStringRef notationName;
};
typedef struct CFXMLEntityInfo CFXMLEntityInfo;

Fields

entityType

The entity type code.

replacementText

NULL if entityType is external or unparsed, otherwise the text that the entity should be replaced with.

entityID

entityID.systemID will be NULL if entityType is internal.

notationName

NULL if entityType is parsed.

CFXMLEntityReferenceInfo

Contains information describing an XML entity reference.

struct CFXMLEntityReferenceInfo {
   CFXMLEntityTypeCode entityType;
};
typedef struct CFXMLEntityReferenceInfo CFXMLEntityReferenceInfo;

Fields

entityType

The entity type code.

CFXMLExternalID

Contains the system and public IDs for an external entity reference.

struct CFXMLExternalID {
   CFURLRef systemID;
   CFStringRef publicID;
};
typedef struct CFXMLExternalID CFXMLExternalID;

Fields

systemID

The systemID URL.

publicID

The publicID string.

CFXMLNodeRef

A reference to a CFXMLNode object.

typedef const struct __CFXMLNode *CFXMLNodeRef;

CFXMLNotationInfo

Contains the external ID of the notation.

struct CFXMLNotationInfo {
   CFXMLExternalID externalID;
};
typedef struct CFXMLNotationInfo CFXMLNotationInfo;

Fields

externalID

The external ID of the notation.

CFXMLProcessingInstructionInfo

Contains the text of the processing instruction.

struct CFXMLProcessingInstructionInfo {
   CFStringRef dataString;
};
typedef struct CFXMLProcessingInstructionInfo CFXMLProcessingInstructionInfo;

Fields

dataString

The text of the processing instruction.

Constants

Entity Type Code

The entity type identification codes that the parser uses to describe XML entities.

enum CFXMLEntityTypeCode {
   kCFXMLEntityTypeParameter = 0,
   kCFXMLEntityTypeParsedInternal = 1,
   kCFXMLEntityTypeParsedExternal = 2,
   kCFXMLEntityTypeUnparsed = 3,
   kCFXMLEntityTypeCharacter = 4
};
typedef enum CFXMLEntityTypeCode CFXMLEntityTypeCode;

Constants

kCFXMLEntityTypeParameter

Implies a parsed, internal entity.

Available in OS X v10.0 and later.

Declared in CFXMLNode.h.

kCFXMLEntityTypeParsedInternal

Indicates a parsed, internal entity.

Available in OS X v10.0 and later.

Declared in CFXMLNode.h.

kCFXMLEntityTypeParsedExternal

Indicates a parsed, external entity.

Available in OS X v10.0 and later.

Declared in CFXMLNode.h.

kCFXMLEntityTypeUnparsed

Indicates an unparsed entity.

Available in OS X v10.0 and later.

Declared in CFXMLNode.h.

kCFXMLEntityTypeCharacter

Indicates a character entity type.

Available in OS X v10.0 and later.

Declared in CFXMLNode.h.

Node Current Version

The version of a CFXMLNode object.

enum {
   kCFXMLNodeCurrentVersion = 1
};

Constants

kCFXMLNodeCurrentVersion

The current version of CFXMLNode objects.

Available in OS X v10.0 and later.

Declared in CFXMLNode.h.

Node Type Code

The various XML data type identification codes that the parser uses to describe XML structures.

enum CFXMLNodeTypeCode {
   kCFXMLNodeTypeDocument = 1,
   kCFXMLNodeTypeElement = 2,
   kCFXMLNodeTypeAttribute = 3,
   kCFXMLNodeTypeProcessingInstruction = 4,
   kCFXMLNodeTypeComment = 5,
   kCFXMLNodeTypeText = 6,
   kCFXMLNodeTypeCDATASection = 7,
   kCFXMLNodeTypeDocumentFragment = 8,
   kCFXMLNodeTypeEntity = 9,
   kCFXMLNodeTypeEntityReference = 10,
   kCFXMLNodeTypeDocumentType = 11,
   kCFXMLNodeTypeWhitespace = 12,
   kCFXMLNodeTypeNotation = 13,
   kCFXMLNodeTypeElementTypeDeclaration = 14,
   kCFXMLNodeTypeAttributeListDeclaration = 15
};
typedef enum CFXMLNodeTypeCode CFXMLNodeTypeCode;

Constants

kCFXMLNodeTypeDocument

Indicates a document where the data string is NULL and the additional information is a pointer to a CFXMLDocumentInfo structure.

Available in OS X v10.0 and later.

Declared in CFXMLNode.h.

kCFXMLNodeTypeElement

Indicates an element where the data string is the name of the tag and the additional information is a pointer to a CFXMLElementInfo structure.

Available in OS X v10.0 and later.

Declared in CFXMLNode.h.

kCFXMLNodeTypeAttribute

Currently not used.

Available in OS X v10.0 and later.

Declared in CFXMLNode.h.

kCFXMLNodeTypeProcessingInstruction

Indicates a processing instruction where the data string is the name of the target and the additional information is a pointer to a CFXMLProcessingInstructionInfo structure.

Available in OS X v10.0 and later.

Declared in CFXMLNode.h.

kCFXMLNodeTypeComment

Indicates a comment section where the data string is the text of the comment and the additional information is NULL.

Available in OS X v10.0 and later.

Declared in CFXMLNode.h.

kCFXMLNodeTypeText

Indicates a text section where the data string is the text’s contents and the additional information is NULL.

Available in OS X v10.0 and later.

Declared in CFXMLNode.h.

kCFXMLNodeTypeCDATASection

Indicates a CDATA section where the data string is the text of the CDATA and the additional information is NULL.

Available in OS X v10.0 and later.

Declared in CFXMLNode.h.

kCFXMLNodeTypeDocumentFragment

Currently not used.

Available in OS X v10.0 and later.

Declared in CFXMLNode.h.

kCFXMLNodeTypeEntity

Indicates an entity where the data string is the name of the entity and the additional information is a pointer to a CFXMLEntityInfo structure.

Available in OS X v10.0 and later.

Declared in CFXMLNode.h.

kCFXMLNodeTypeEntityReference

Indicates an entity reference where the data string is the name of the referenced entity and the additional information is a pointer to a CFXMLEntityReferenceInfo structure.

Available in OS X v10.0 and later.

Declared in CFXMLNode.h.

kCFXMLNodeTypeDocumentType

Indicates a document type where the data string is the name given to the top-level element and the additional information is a pointer to a CFXMLDocumentTypeInfo structure.

Available in OS X v10.0 and later.

Declared in CFXMLNode.h.

kCFXMLNodeTypeWhitespace

Indicates white space where the data string is the text of the white space and the additional information is NULL.

Available in OS X v10.0 and later.

Declared in CFXMLNode.h.

kCFXMLNodeTypeNotation

Indicates a notation where the data string is the notation name and the additional information is a pointer to a CFXMLNotationInfo structure.

Available in OS X v10.0 and later.

Declared in CFXMLNode.h.

kCFXMLNodeTypeElementTypeDeclaration

Indicates an element type declaration where the data string is the tag name and the additional information is a pointer to a CFXMLElementTypeDeclarationInfo structure.

Available in OS X v10.0 and later.

Declared in CFXMLNode.h.

kCFXMLNodeTypeAttributeListDeclaration

Indicates an attribute list declaration where the data string is the tag name and the additional information is a pointer to a CFXMLAttributeListDeclarationInfo structure.

Available in OS X v10.0 and later.

Declared in CFXMLNode.h.