--- embedaddon/libxml2/doc/libxml2-api.xml 2013/07/22 01:22:22 1.1.1.2 +++ embedaddon/libxml2/doc/libxml2-api.xml 2014/06/15 19:53:35 1.1.1.3 @@ -372,10 +372,12 @@ Daniel Veillard + + @@ -715,10 +717,11 @@ + - + @@ -880,7 +883,7 @@ - internals routines exported by the parser. + internals routines and limits exported by the parser. this module exports a number of internal parsing routines they are not really all intended for applications but can prove useful doing low level processing. Daniel Veillard @@ -895,14 +898,17 @@ + + + @@ -1406,13 +1412,14 @@ this module describes the structures found in an tree resulting from an XML or HTML parsing, as well as the API provided for various processing on that tree Daniel Veillard - + - + + @@ -1475,7 +1482,7 @@ - + @@ -1486,7 +1493,7 @@ - + @@ -1496,6 +1503,7 @@ + @@ -1504,6 +1512,7 @@ + @@ -1541,8 +1550,9 @@ - + + @@ -1554,15 +1564,16 @@ - + - + + @@ -1608,6 +1619,7 @@ + @@ -1631,6 +1643,7 @@ + @@ -1638,6 +1651,7 @@ + @@ -1682,12 +1696,13 @@ - + + @@ -1922,9 +1937,11 @@ + + @@ -2030,7 +2047,7 @@ - + @@ -2274,6 +2291,7 @@ + @@ -2379,7 +2397,6 @@ - @@ -2449,7 +2466,7 @@ - + @@ -2576,6 +2593,7 @@ + @@ -2591,7 +2609,7 @@ - + @@ -2666,7 +2684,6 @@ - @@ -2674,6 +2691,7 @@ + @@ -2688,6 +2706,7 @@ + @@ -2730,6 +2749,7 @@ + @@ -3076,12 +3096,14 @@ + + @@ -3090,6 +3112,7 @@ + @@ -3396,6 +3419,7 @@ + @@ -3415,7 +3439,7 @@ - + @@ -3437,7 +3461,7 @@ - + @@ -3463,8 +3487,9 @@ - + + @@ -3527,6 +3552,7 @@ + @@ -3567,6 +3593,7 @@ + @@ -3601,6 +3628,7 @@ + @@ -3931,6 +3959,9 @@ Same as IS_PUBIDCHAR but for single-byte value + + Macro used to express that the API use the new buffers for xmlParserInputBuffer and xmlOutputBuffer. The change was introduced in 2.9.0. + Macro used to indicate to GCC this is an allocator function @@ -4020,6 +4051,9 @@ Macro to check that the libxml version in use is compatible with the version the software has been compiled against + + Whether the allocation hooks are per-thread + Whether the thread support is configured in @@ -4149,11 +4183,20 @@ A namespace declaration node. + + Maximum size allowed by the parser for a dictionary by default This is not a limitation of the parser but a safety boundary feature, use XML_PARSE_HUGE option to override it. Introduced in 2.9.0 + + + Maximum size allowed by the parser for ahead lookup This is an upper boundary enforced by the parser to avoid bad behaviour on "unfriendly' content Introduced in 2.9.0 + Identifiers can be longer, but this will be more costly at runtime. + + Maximum size allowed for a markup identitier This is not a limitation of the parser but a safety boundary feature, use XML_PARSE_HUGE option to override it. Note that with the use of parsing dictionaries overriding the limit may result in more runtime memory usage in face of "unfriendly' content Introduced in 2.9.0 + - Maximum size allowed for a single text node when building a tree. This is not a limitation of the parser but a safety boundary feature, use XML_PARSE_HUGE option to override it. + Maximum size allowed for a single text node when building a tree. This is not a limitation of the parser but a safety boundary feature, use XML_PARSE_HUGE option to override it. Introduced in 2.9.0 Special constant found in SAX2 blocks initialized fields @@ -4664,6 +4707,7 @@ + @@ -4710,7 +4754,6 @@ - @@ -4749,7 +4792,6 @@ - @@ -4888,6 +4930,7 @@ and not by parsing an instance'/> + @@ -4924,6 +4967,7 @@ and not by parsing an instance'/> + @@ -4939,6 +4983,7 @@ and not by parsing an instance'/> + @@ -4960,8 +5005,9 @@ and not by parsing an instance'/> - + + @@ -5081,6 +5127,7 @@ and not by parsing an instance'/> + @@ -5089,7 +5136,7 @@ crash if you try to modify the tree)'/> - + @@ -5827,6 +5874,7 @@ crash if you try to modify the tree)'/> + @@ -5970,6 +6018,10 @@ if necessary or NULL'/> A state int the automata description, + + + A pointer to a buffer structure, the actual structure internals are not public + @@ -6140,7 +6192,8 @@ set at the end of parsing'/> +* references done from that entity +* and if it contains '<''/> @@ -6287,8 +6340,8 @@ set at the end of parsing'/> - - + + @@ -6390,6 +6443,7 @@ actually an xmlCharEncoding'/> + @@ -6418,8 +6472,8 @@ actually an xmlCharEncoding'/> - - + + @@ -8507,6 +8561,43 @@ Could we use @subtypes for this?'/> + + Function to extract the content of a buffer + + + + + Function to extract the end of the content of a buffer + + + + + Read the value of a node @cur, this can be either the text carried directly by this node if it's a TEXT node or the aggregate string of the values carried by this node child's (TEXT and ENTITY_REF). Entity references are substituted. Fills up the buffer @buffer with this value + + + + + + defined(LIBXML_OUTPUT_ENABLED) + Dump an XML node, recursive behaviour,children are printed too. Note that @format = 1 provide node indenting only if xmlIndentTreeOutput = 1 or xmlKeepBlanksDefault(0) was called + + + + + + + + + Remove the beginning of an XML buffer. NOTE that this routine behaviour differs from xmlBufferShrink() as it will return 0 on error instead of -1 due to size_t being used as the return type. + + + + + + Function to get the length of a buffer + + + Add a string range to an XML buffer. if len == -1, the length of str is recomputed. @@ -9430,6 +9521,11 @@ Could we use @subtypes for this?'/> + + Get how much memory is used by a dictionary for strings Added in 2.9.0 + + + Add the @name to the dictionnary @dict if not present. @@ -9455,6 +9551,12 @@ Could we use @subtypes for this?'/> + + Set a size limit for the dictionary Added in 2.9.0 + + + + Query the number of elements installed in the hash @dict. @@ -9687,7 +9789,7 @@ Could we use @subtypes for this?'/> - + defined(LIBXML_REGEXP_ENABLED) && defined(LIBXML_EXPR_ENABLED) @@ -9696,7 +9798,7 @@ Could we use @subtypes for this?'/> - + defined(LIBXML_REGEXP_ENABLED) && defined(LIBXML_EXPR_ENABLED) @@ -9716,7 +9818,7 @@ Could we use @subtypes for this?'/> - + defined(LIBXML_REGEXP_ENABLED) && defined(LIBXML_EXPR_ENABLED) @@ -10132,7 +10234,7 @@ Could we use @subtypes for this?'/> - Get line number of @node. This requires activation of this option before invoking the parser by calling xmlLineNumbersDefault(1) + Get line number of @node. Try to override the limitation of lines being store in 16 bits ints if XML_PARSE_BIG_LINES parser option was used @@ -10536,7 +10638,7 @@ Could we use @subtypes for this?'/> - Do the dictionary mutex initialization. this function is not thread safe, initialization should preferably be done once at startup + Do the dictionary mutex initialization. this function is deprecated @@ -10984,14 +11086,14 @@ Could we use @subtypes for this?'/> defined(LIBXML_MODULES_ENABLED) - Opens a module/shared library given its name or path TODO: options are not yet implemented. + Opens a module/shared library given its name or path NOTE: that due to portability issues, behaviour can only be guaranteed with @name using ASCII. We canot guarantee that an UTF-8 string would work, which is why name is a const char * and not a const xmlChar * . TODO: options are not yet implemented. defined(LIBXML_MODULES_ENABLED) - Lookup for a symbol address in the given module + Lookup for a symbol address in the given module NOTE: that due to portability issues, behaviour can only be guaranteed with @name using ASCII. We canot guarantee that an UTF-8 string would work, which is why name is a const char * and not a const xmlChar * . @@ -11661,7 +11763,7 @@ Could we use @subtypes for this?'/> defined(LIBXML_OUTPUT_ENABLED) - Dump an XML node, recursive behaviour,children are printed too. Note that @format = 1 provide node indenting only if xmlIndentTreeOutput = 1 or xmlKeepBlanksDefault(0) was called + Dump an XML node, recursive behaviour,children are printed too. Note that @format = 1 provide node indenting only if xmlIndentTreeOutput = 1 or xmlKeepBlanksDefault(0) was called Since this is using xmlBuffer structures it is limited to 2GB and somehow deprecated, use xmlBufNodeDump() instead. @@ -11835,6 +11937,18 @@ Could we use @subtypes for this?'/> + + defined(LIBXML_OUTPUT_ENABLED) + Gives a pointer to the data currently held in the output buffer + + + + + defined(LIBXML_OUTPUT_ENABLED) + Gives the length of the data currently held in the output buffer + + + defined(LIBXML_OUTPUT_ENABLED) Write the content of the array in the output I/O buffer This routine handle the I18N transcoding from internal UTF-8 The buffer is lossless, i.e. will store in case of partial or delayed writes. @@ -12382,13 +12496,13 @@ Could we use @subtypes for this?'/> This function increase the input for the parser. It tries to preserve pointers to the input buffer, and keep already read data - + - This function refresh the input for the parser. It doesn't try to preserve pointers to the input buffer, and discard already read data - + This function was internal and is deprecated. + @@ -13008,7 +13122,7 @@ Could we use @subtypes for this?'/> - + defined(LIBXML_SCHEMAS_ENABLED) @@ -13917,6 +14031,21 @@ Could we use @subtypes for this?'/> + + defined(LIBXML_SCHEMAS_ENABLED) + Workaround to provide file error reporting information when this is not provided by current APIs + + + + + + defined(LIBXML_SCHEMAS_ENABLED) + Allows to set a locator function to the validation context, which will be used to provide file and line information since those are not provided as part of the SAX validation flow Setting @f to NULL disable the locator. + + + + + defined(LIBXML_SCHEMAS_ENABLED) Validate an input based on a flow of SAX event from the parser and forward the events to the @sax handler with the provided @user_data the user provided @sax handler must be a SAX2 one. @@ -13935,6 +14064,14 @@ Could we use @subtypes for this?'/> + + defined(LIBXML_SCHEMAS_ENABLED) + A schemas validation locator, a callback called by the validator. This is used when file or node informations are not available to find out what file and line number are affected + + + + + defined(LIBXML_SCHEMAS_ENABLED) Signature of a warning callback from an XSD validation @@ -14320,7 +14457,7 @@ Could we use @subtypes for this?'/> parse an XML qualified name string,i - + @@ -15133,6 +15270,13 @@ Could we use @subtypes for this?'/> + + defined(LIBXML_WRITER_ENABLED) + Set the character used for quoting attributes. + + + + defined(LIBXML_WRITER_ENABLED) Start an xml attribute. @@ -16799,7 +16943,7 @@ Could we use @subtypes for this?'/> - Unlink a node from it's current context, the node is not freed If one need to free the node, use xmlFreeNode() routine after the unlink to discard it. + Unlink a node from it's current context, the node is not freed If one need to free the node, use xmlFreeNode() routine after the unlink to discard it. Note that namespace nodes can't be unlinked as they do not have pointer to their parent. @@ -17031,7 +17175,7 @@ Could we use @subtypes for this?'/> - + defined(LIBXML_VALID_ENABLED) && defined(LIBXML_REGEXP_ENABLED) @@ -17765,6 +17909,14 @@ Could we use @subtypes for this?'/> + + defined(LIBXML_XPATH_ENABLED) + Evaluate the XPath Location Path in the given context. The node 'node' is set as the context node. The context node is not restored. + + + + + defined(LIBXML_XPATH_ENABLED) Implements the EXSLT - Sets leading() function: node-set set:leading (node-set, node-set) @nodes is sorted by document order, then #exslSetsNodeLeadingSorted is called. @@ -17782,14 +17934,14 @@ Could we use @subtypes for this?'/> defined(LIBXML_XPATH_ENABLED) add a new xmlNodePtr to an existing NodeSet - + defined(LIBXML_XPATH_ENABLED) add a new namespace node to an existing NodeSet - + @@ -17797,7 +17949,7 @@ Could we use @subtypes for this?'/> defined(LIBXML_XPATH_ENABLED) add a new xmlNodePtr to an existing NodeSet, optimized version when we are sure the node is not already in the set. - + @@ -18050,6 +18202,13 @@ Could we use @subtypes for this?'/> + + + defined(LIBXML_XPATH_ENABLED) + Sets 'node' as the context node. The node must be in the same document as that associated with the context. + + + defined(LIBXML_XPATH_ENABLED)