| Gnome XML Library Reference Manual | |||
|---|---|---|---|
| <<< Previous Page | Home | Up | Next Page >>> |
#define XML_MAX_NAMELEN |
Identifiers can be longer, but this will be more costly at runtime.
#define INPUT_CHUNK |
The parser tries to always have that amount of input ready. One of the point is providing context when reporting errors.
#define IS_CHAR(c) |
Macro to check the following production in the XML spec:
[2] Char ::=
#define IS_BLANK(c) |
Macro to check the following production in the XML spec:
[3] S ::= (
#define IS_BASECHAR(c) |
Macro to check the following production in the XML spec:
[85] BaseChar ::= ... long list see REC ...
#define IS_DIGIT(c) |
Macro to check the following production in the XML spec:
[88] Digit ::= ... long list see REC ...
#define IS_COMBINING(c) |
Macro to check the following production in the XML spec:
[87] CombiningChar ::= ... long list see REC ...
#define IS_EXTENDER(c) |
Macro to check the following production in the XML spec:
[89] Extender ::=
#define IS_IDEOGRAPHIC(c) |
Macro to check the following production in the XML spec:
[86] Ideographic ::= [
#define IS_LETTER(c) |
Macro to check the following production in the XML spec:
[84] Letter ::= BaseChar | Ideographic
#define IS_PUBIDCHAR(c) |
Macro to check the following production in the XML spec:
[13] PubidChar ::=
int xmlIsBaseChar (int c); |
Check whether the character is allowed by the production [85] BaseChar ::= ... long list see REC ...
VI is your friend !
:1,$ s/\[
int xmlIsBlank (int c); |
Check whether the character is allowed by the production
[3] S ::= (
int xmlIsPubidChar (int c); |
Check whether the character is allowed by the production
[13] PubidChar ::=
int xmlIsLetter (int c); |
Check whether the character is allowed by the production [84] Letter ::= BaseChar | Ideographic
int xmlIsDigit (int c); |
Check whether the character is allowed by the production [88] Digit ::= ... long list see REC ...
int xmlIsIdeographic (int c); |
Check whether the character is allowed by the production
[86] Ideographic ::= [
int xmlIsExtender (int c); |
Check whether the character is allowed by the production
[89] Extender ::=
int xmlIsCombining (int c); |
Check whether the character is allowed by the production [87] CombiningChar ::= ... long list see REC ...
int xmlIsChar (int c); |
Check whether the character is allowed by the production
[2] Char ::=
xmlParserCtxtPtr xmlCreateFileParserCtxt (const char *filename); |
Create a parser context for a file content. Automatic support for ZLIB/Compress compressed document is provided by default if found at compile-time.
xmlParserCtxtPtr xmlCreateMemoryParserCtxt (const char *buffer, int size); |
Create a parser context for an XML in-memory document.
xmlParserCtxtPtr xmlNewParserCtxt (void); |
Allocate and initialize a new parser context.
xmlParserCtxtPtr xmlCreateEntityParserCtxt (const xmlChar *URL, const xmlChar *ID, const xmlChar *base); |
Create a parser context for an external entity Automatic support for ZLIB/Compress compressed document is provided by default if found at compile-time.
int xmlSwitchEncoding (xmlParserCtxtPtr ctxt, xmlCharEncoding enc); |
change the input functions when discovering the character encoding of a given entity.
int xmlSwitchToEncoding (xmlParserCtxtPtr ctxt, xmlCharEncodingHandlerPtr handler); |
change the input functions when discovering the character encoding of a given entity.
void xmlHandleEntity (xmlParserCtxtPtr ctxt, xmlEntityPtr entity); |
Default handling of defined entities, when should we define a new input stream ? When do we just handle that as a set of chars ?
OBSOLETE: to be removed at some point.
xmlParserInputPtr xmlNewStringInputStream (xmlParserCtxtPtr ctxt, const xmlChar *buffer); |
Create a new input stream based on a memory buffer.
xmlParserInputPtr xmlNewEntityInputStream (xmlParserCtxtPtr ctxt, xmlEntityPtr entity); |
Create a new input stream based on an xmlEntityPtr
void xmlPushInput (xmlParserCtxtPtr ctxt, xmlParserInputPtr input); |
xmlPushInput: switch to a new input stream which is stacked on top of the previous one(s).
xmlChar xmlPopInput (xmlParserCtxtPtr ctxt); |
xmlPopInput: the current input pointed by ctxt->input came to an end pop it and return the next char.
xmlParserInputPtr xmlNewInputFromFile (xmlParserCtxtPtr ctxt, const char *filename); |
Create a new input stream based on a file.
xmlParserInputPtr xmlNewInputStream (xmlParserCtxtPtr ctxt); |
Create a new input stream structure
| fIjf6}VRu/)&=_rdv yݜ[Q:k& wϒXsPL`sd 5D<
3<܈M^ptOBd[
5h8pg.M 4vȥX0*߃{% 1 A(>fKY8NLtlĐFVZDDUFVS7ۉrZw塚<)Kdۛ{"0˯Q[2)
"Co" F6Njo
7T8Y"2 V@ ͆ e[g -@5q}|r3R?fWKFDŽ 5* b u-l== Xmݹ$&6l(3x݆oT5yaqc`bydp3@qŵS+AD c-c@.& ZS
S!{|`^MGLUT]m\sItDwޑ2)~&=#!mߵ bx0p;/֝́ U:z
eĐ(è "{ڐ1.CF 5+ޜE'hǹHMީŅ/1ڴEֈ`B\|N |@U02ɱbO?7!٠hx n=8rvy)r6fw
| UĔ/
zt]}xf -P~9
'\hz ; F85C@ѻPc{aME{@)j ]g6W3*pxN߉=TgYO*݃lM& |
parse the XML standalone declaration
[32] SDDecl ::= S 'standalone' Eq (("'" ('yes' | 'no') "'") | ('"' ('yes' | 'no')'"'))
[ VC: Standalone Document Declaration ] TODO The standalone document declaration must have the value "no" if any external markup declarations contain declarations of: - attributes with default values, if elements to which these attributes apply appear in the document without specifications of values for these attributes, or - entities (other than amp, lt, gt, apos, quot), if references to those entities appear in the document, or - attributes with values subject to normalization, where the attribute appears in the document with a value which will change as a result of normalization, or - element types with element content, if white space occurs directly within any instance of those types.
void xmlParseXMLDecl (xmlParserCtxtPtr ctxt); |
parse an XML declaration header
[23] XMLDecl ::= '<?xml' VersionInfo EncodingDecl? SDDecl? S? '?>'
void xmlParseTextDecl (xmlParserCtxtPtr ctxt); |
parse an XML declaration header for external entities
[77] TextDecl ::= '<?xml' VersionInfo? EncodingDecl S? '?>'
Question: Seems that EncodingDecl is mandatory ? Is that a typo ?
void xmlParseMisc (xmlParserCtxtPtr ctxt); |
parse an XML Misc* optional field.
[27] Misc ::= Comment | PI | S
void xmlParseExternalSubset (xmlParserCtxtPtr ctxt, const xmlChar *ExternalID, const xmlChar *SystemID); |
parse Markup declarations from an external subset
[30] extSubset ::= textDecl? extSubsetDecl
[31] extSubsetDecl ::= (markupdecl | conditionalSect | PEReference | S) *
#define XML_SUBSTITUTE_BOTH |
Both general and parameter entities need to be substituted.
xmlChar* xmlDecodeEntities (xmlParserCtxtPtr ctxt, int len, int what, xmlChar end, xmlChar end2, xmlChar end3); |
This function is deprecated, we now always process entities content through xmlStringDecodeEntities
TODO: remove it in next major release.
[67] Reference ::= EntityRef | CharRef
[69] PEReference ::= '%' Name ';'
xmlChar* xmlStringDecodeEntities (xmlParserCtxtPtr ctxt, const xmlChar *str, int what, xmlChar end, xmlChar end2, xmlChar end3); |
Takes a entity string content and process to do the adequate substitutions.
[67] Reference ::= EntityRef | CharRef
[69] PEReference ::= '%' Name ';'
int nodePush (xmlParserCtxtPtr ctxt, xmlNodePtr value); |
Pushes a new element node on top of the node stack
int inputPush (xmlParserCtxtPtr ctxt, xmlParserInputPtr value); |
Pushes a new parser input on top of the input stack
xmlParserInputPtr inputPop (xmlParserCtxtPtr ctxt); |
Pops the top parser input from the input stack
int namePush (xmlParserCtxtPtr ctxt, xmlChar *value); |
Pushes a new element name on top of the name stack
int xmlSkipBlankChars (xmlParserCtxtPtr ctxt); |
skip all blanks character found at that point in the input streams. It pops up finished entities in the process if allowable at that point.
int xmlStringCurrentChar (xmlParserCtxtPtr ctxt, const xmlChar *cur, int *len); |
The current char value, if using UTF-8 this may actually span multiple bytes in the input buffer.
void xmlParserHandlePEReference (xmlParserCtxtPtr ctxt); |
[69] PEReference ::= '%' Name ';'
[ WFC: No Recursion ] A parsed entity must not contain a recursive reference to itself, either directly or indirectly.
[ WFC: Entity Declared ] In a document without any DTD, a document with only an internal DTD subset which contains no parameter entity references, or a document with "standalone='yes'", ... ... The declaration of a parameter entity must precede any reference to it...
[ VC: Entity Declared ] In a document with an external subset or external parameter entities with "standalone='no'", ... ... The declaration of a parameter entity must precede any reference to it...
[ WFC: In DTD ] Parameter-entity references may only appear in the DTD. NOTE: misleading but this is handled.
A PEReference may have been detected in the current input stream
the handling is done accordingly to
http://www.w3.org/TR/REC-xml
void xmlParserHandleReference (xmlParserCtxtPtr ctxt); |
TODO: Remove, now deprecated ... the test is done directly in the content parsing routines.
[67] Reference ::= EntityRef | CharRef
[68] EntityRef ::= '&' Name ';'
[ WFC: Entity Declared ] the Name given in the entity reference must match that in an entity declaration, except that well-formed documents need not declare any of the following entities: amp, lt, gt, apos, quot.
[ WFC: Parsed Entity ] An entity reference must not contain the name of an unparsed entity
[66] CharRef ::= '&#' [0-9]+ ';' |
'&
A PEReference may have been detected in the current input stream
the handling is done accordingly to
http://www.w3.org/TR/REC-xml
int xmlCheckLanguageID (const xmlChar *lang); |
Checks that the value conforms to the LanguageID production:
NOTE: this is somewhat deprecated, those productions were removed from the XML Second edition.
[33] LanguageID ::= Langcode ('-' Subcode)* [34] Langcode ::= ISO639Code | IanaCode | UserCode [35] ISO639Code ::= ([a-z] | [A-Z]) ([a-z] | [A-Z]) [36] IanaCode ::= ('i' | 'I') '-' ([a-z] | [A-Z])+ [37] UserCode ::= ('x' | 'X') '-' ([a-z] | [A-Z])+ [38] Subcode ::= ([a-z] | [A-Z])+
int xmlCurrentChar (xmlParserCtxtPtr ctxt, int *len); |
The current char value, if using UTF-8 this may actually span multiple
bytes in the input buffer. Implement the end of line normalization:
2.11 End-of-Line Handling
Wherever an external parsed entity or the literal entity value
of an internal parsed entity contains either the literal two-character
sequence "
int xmlCopyCharMultiByte (xmlChar *out, int val); |
append the char value in the array
void xmlParserInputShrink (xmlParserInputPtr in); |
This function removes used input for the parser.
void htmlInitAutoClose (void); |
Initialize the htmlStartCloseIndex for fast lookup of closing tags names. This is not reentrant. Call xmlInitParser() once before processing in case of use in multithreaded programs.
htmlParserCtxtPtr htmlCreateFileParserCtxt (const char *filename, const char *encoding); |
Create a parser context for a file content. Automatic support for ZLIB/Compress compressed document is provided by default if found at compile-time.
void (*xmlEntityReferenceFunc) (xmlEntityPtr ent, xmlNodePtr firstNode, xmlNodePtr lastNode); |
Callback function used when one needs to be able to track back the provenance of a chunk of nodes inherited from an entity replacement.
void xmlSetEntityReferenceFunc (xmlEntityReferenceFunc func); |
Set the function to call call back when a xml reference has been made