Lines Matching full:code
30 <code>XML::Parser</code>, Python's <code>xml.parsers.expat</code>, and
169 <dt><code><a href= "#XML_ParserCreate"
170 >XML_ParserCreate</a></code></dt>
173 <dt><code><a href= "#XML_SetElementHandler"
174 >XML_SetElementHandler</a></code></dt>
177 <dt><code><a href= "#XML_SetCharacterDataHandler"
178 >XML_SetCharacterDataHandler</a></code></dt>
181 <dt><code><a href= "#XML_Parse"
182 >XML_Parse</a></code></dt>
198 information. Finally it increments the global <code>Depth</code>
223 <code>Depth</code>.</p>
231 <p>Note the <code>XMLCALL</code> annotation used for the callbacks.
234 itself and the client code are different. Expat tries not to care
237 For code which uses Expat, however, the calling convention is
238 specified by the <code>XMLCALL</code> annotation on most platforms;
241 <p>The <code>XMLCALL</code> annotation was added in Expat 1.95.7, but
302 only one we'll mention here is the <code>--prefix</code> option. You
304 the <code>--help</code> option.</p>
307 gets installed in <code>/usr/local/lib</code> and the associated
308 header file in <code>/usr/local/include</code>. But if you were to
309 give the option, <code>--prefix=/home/me/mystuff</code>, then the
311 <code>/home/me/mystuff/lib</code> and
312 <code>/home/me/mystuff/include</code> respectively.</p>
320 <code>XML_UNICODE_WCHAR_T</code>. The symbols are:</p>
340 <code>XML_Char</code>. This is implied if
341 <code>XML_UNICODE_WCHAR_T</code> is defined.</dd>
344 <dd>If defined, causes the <code>XML_Char</code> character type to be
345 defined using the <code>wchar_t</code> type; otherwise, <code>unsigned
346 short</code> is used. Defining this implies
347 <code>XML_UNICODE</code>.</dd>
350 <dd>If defined, causes the <code>XML_Size</code> and <code>XML_Index</code>
353 <code><a href="#XML_GetCurrentByteIndex" >XML_GetCurrentByteIndex</a></code>,
354 <code><a href="#XML_GetCurrentLineNumber" >XML_GetCurrentLineNumber</a></code> and
355 <code><a href="#XML_GetCurrentColumnNumber" >XML_GetCurrentColumnNumber</a></code>
361 ensure are available for reporting via <code><a href=
362 "#XML_GetInputContext" >XML_GetInputContext</a></code>. This is
364 is not defined, the input context will not be available and <code><a
365 code> will
371 statically with the code that calls it; this is required to get all
376 <dd>If defined, makes the the additional function <code><a href=
377 "#XML_GetAttributeInfo" >XML_GetAttributeInfo</a></code> available
388 is to include the Expat header (<code>#include <expat.h></code>)
391 usually be done with the <code>-lexpat</code> argument. Otherwise,
408 <p>If you installed Expat in, say, <code>/home/me/mystuff</code>, then
421 <code>LD_LIBRARY_PATH</code> to <code>/home/me/mystuff/lib</code> (or
422 to <code>${LD_LIBRARY_PATH}:/home/me/mystuff/lib</code> if
431 parser object. However, only two of these (<code><a href=
432 "#XML_ParserCreate" >XML_ParserCreate</a></code> and <code><a href=
433 "#XML_ParserCreateNS" >XML_ParserCreateNS</a></code>) can be used for
437 memory associated with this object you must call <code><a href=
438 "#XML_ParserFree" >XML_ParserFree</a></code>. Note that if you have
441 calling <code>XML_ParserFree</code>.</p>
514 incremented depth <em>after</em> the main body of start tag code, then
524 the shared variables. You can then tell Expat (with the <code><a href=
525 "#XML_SetUserData" >XML_SetUserData</a></code> function) to pass a
529 <code>userData</code> and have type <code>void *</code> if the user
530 data is passed; it will have the type <code>XML_Parser</code> if the
532 be retrieved using <code><a href="#XML_GetUserData"
533 >XML_GetUserData</a></code>.</p>
537 content passed to the character data handler (set by <code><a href=
539 >XML_SetCharacterDataHandler</a></code>) needs to be accumulated. A
555 the value of the <code>version</code> pseudo-attribute in the XML
559 alternate processing), it should use the <code><a href=
560 "#XML_SetXmlDeclHandler" >XML_SetXmlDeclHandler</a></code> function to
563 version number of <code>"1.0"</code> is accepted:</p>
594 <p>When the parser is created using the <code><a href=
595 "#XML_ParserCreateNS" >XML_ParserCreateNS</a></code>, function, Expat
597 consumes <code>xmlns</code> and <code>xmlns:...</code> attributes,
603 ><code>XML_SetNamespaceDeclHandler</code></a>.</p>
608 separator character (which is the 2nd argument to <code><a href=
609 "#XML_ParserCreateNS" >XML_ParserCreateNS</a></code>), and the local
616 <p>However if <code><a href= "#XML_SetReturnNSTriplet"
617 >XML_SetReturnNSTriplet</a></code> has been called with a non-zero
618 <code>do_nst</code> parameter, then the expanded form for names with
623 for the end of a scope of a declaration with the <code><a href=
624 "#XML_SetNamespaceDeclHandler" >XML_SetNamespaceDeclHandler</a></code>
672 to the <code>UnknownEncodingHandler</code>. This handler gets passed
673 the encoding name and a pointer to an <code>XML_Encoding</code> data
675 <code>XML_STATUS_OK</code> if it knows how to deal with the
677 <code>XML_STATUS_ERROR</code>. The handler also gets passed a pointer
682 support by filling in the <code>XML_Encoding</code> structure.
696 <p><code>XML_Encoding</code> contains an array of integers that
703 function pointed at in the <code>XML_Encoding</code> structure. This
717 set no <code>ExternalEntityRefHandler</code>, then external entity
722 it is responsible for creating a subsidiary parser with <code><a href=
724 >XML_ExternalEntityParserCreate</a></code> that will do the job. This
725 returns an instance of <code>XML_Parser</code> that has handlers and
727 use <code><a href= "#XML_Parse" >XML_Parse</a></code> or <code><a
728 href= "#XML_ParseBuffer">XML_ParseBuffer</a></code> calls against this
735 you must call <code><a href= "#XML_SetParamEntityParsing"
736 >XML_SetParamEntityParsing</a></code> with one of the following
739 <dt><code>XML_PARAM_ENTITY_PARSING_NEVER</code></dt>
741 <dt><code>XML_PARAM_ENTITY_PARSING_UNLESS_STANDALONE</code></dt>
743 <code>standalone</code> was set to "yes" in the XML declaration.</dd>
744 <dt><code>XML_PARAM_ENTITY_PARSING_ALWAYS</code></dt>
782 the rough structure (in pseudo-code):</p>
806 <p>This C function could be used for the <code>parse_xml</code>
807 function mentioned in the pseudo-code above:</p>
849 <p>The corresponding <code>continue_parsing</code> function is
850 somewhat simpler, since it only need deal with the return code from
851 <code><a href= "#XML_ResumeParser">XML_ResumeParser</a></code>; it can
852 delegate the input handling to the <code>parse_xml</code>
879 become, what have we gained? Very simply, we can now use the <code><a
880 href= "#XML_StopParser" >XML_StopParser</a></code> function to stop
886 <p>To stop parsing from a handler function, use the <code><a href=
887 "#XML_StopParser" >XML_StopParser</a></code> function. This function
930 in XML. For instance, <code>'\xFF'</code> is not legal in UTF-8, and
931 <code>'\xFFFF'</code> is not legal in UTF-16. There is a special case when
932 <em>sep</em> is the null character <code>'\0'</code>: the namespace URI and
952 specified in <code>ms</code>. If <code>ms</code> is NULL, then use the
953 standard set of memory management functions. If <code>sep</code> is
966 Construct a new <code>XML_Parser</code> object for parsing an external
991 be used again. After this has been called, <code>parser</code> is
995 This function may not be used on a parser created using <code><a href=
997 ></code>; it will return <code>XML_FALSE</code> in that case. Returns
998 <code>XML_TRUE</code> on success. Your application is responsible for
1004 <p>To state the obvious: the three parsing functions <code><a href=
1005 "#XML_Parse" >XML_Parse</a></code>, <code><a href= "#XML_ParseBuffer">
1006 XML_ParseBuffer</a></code> and <code><a href= "#XML_GetBuffer">
1007 XML_GetBuffer</a></code> must not be called from within a handler
1010 functions from within an <code>XML_ExternalEntityRefHandler</code>,
1012 <code><a href= "#XML_ExternalEntityParserCreate"
1013 >XML_ExternalEntityParserCreate</a></code>.</p>
1015 <p>Note: the <code>len</code> argument passed to these functions
1037 Parse some more of the document. The string <code>s</code> is a buffer
1039 that are part of the document is indicated by <code>len</code>. This means
1040 that <code>s</code> doesn't have to be null terminated. It also means that
1041 if <code>len</code> is larger than the number of bytes in the block of
1042 memory that <code>s</code> points at, then a memory fault is likely. The
1043 <code>isFinal</code> parameter informs the parser that this is the last
1045 <code>len</code> is zero.)
1046 If a parse error occurred, it returns <code>XML_STATUS_ERROR</code>.
1047 Otherwise it returns <code>XML_STATUS_OK</code> value.
1057 This is just like <code><a href= "#XML_Parse" >XML_Parse</a></code>,
1059 buffer from Expat with the <code><a href= "#XML_GetBuffer"
1060 >XML_GetBuffer</a></code> function, the application can avoid double
1070 Obtain a buffer of size <code>len</code> to read a piece of the document
1073 <code><a href= "#XML_ParseBuffer" >XML_ParseBuffer</a></code>. A
1106 <p>Stops parsing, causing <code><a href= "#XML_Parse"
1107 >XML_Parse</a></code> or <code><a href= "#XML_ParseBuffer"
1108 >XML_ParseBuffer</a></code> to return. Must be called from within a
1109 call-back handler, except when aborting (when <code>resumable</code>
1110 is <code>XML_FALSE</code>) an already suspended parser. Some
1125 <code>resumable</code> is <code>XML_TRUE</code>. Returns
1126 <code>XML_STATUS_OK</code> when successful,
1127 <code>XML_STATUS_ERROR</code> otherwise. The possible error codes
1130 <dt><code>XML_ERROR_SUSPENDED</code></dt>
1132 <dt><code>XML_ERROR_FINISHED</code></dt>
1134 <dt><code>XML_ERROR_SUSPEND_PE</code></dt>
1143 <p>When <code>resumable</code> is <code>XML_TRUE</code> then parsing
1144 is <em>suspended</em>, that is, <code><a href= "#XML_Parse"
1145 >XML_Parse</a></code> and <code><a href= "#XML_ParseBuffer"
1146 >XML_ParseBuffer</a></code> return <code>XML_STATUS_SUSPENDED</code>.
1147 Otherwise, parsing is <em>aborted</em>, that is, <code><a href=
1148 "#XML_Parse" >XML_Parse</a></code> and <code><a href=
1149 "#XML_ParseBuffer" >XML_ParseBuffer</a></code> return
1150 <code>XML_STATUS_ERROR</code> with error code
1151 <code>XML_ERROR_ABORTED</code>.</p>
1157 implementation of that handler to call <code><a href=
1158 "#XML_StopParser" >XML_StopParser</a></code> on the parent parser
1161 <p>When suspended, parsing can be resumed by calling <code><a href=
1162 "#XML_ResumeParser" >XML_ResumeParser</a></code>.</p>
1172 <p>Resumes parsing after it has been suspended with <code><a href=
1173 "#XML_StopParser" >XML_StopParser</a></code>. Must not be called from
1174 within a handler call-back. Returns same status codes as <code><a
1175 href= "#XML_Parse">XML_Parse</a></code> or <code><a href=
1176 "#XML_ParseBuffer" >XML_ParseBuffer</a></code>. An additional error
1177 code, <code>XML_ERROR_NOT_SUSPENDED</code>, will be returned if the
1185 and it is up to the application to call <code><a href=
1186 "#XML_ResumeParser" >XML_ResumeParser</a></code> on it at the
1213 processed. The <code>status</code> parameter <em>must not</em> be
1225 to ignore all text not descended from a <code>para</code> element. One
1234 <code>XML_Char</code>. This type is conditionally defined in expat.h as
1235 either <code>char</code>, <code>wchar_t</code> or <code>unsigned short</code>.
1405 <p>See also <code><a
1406 href="#XML_DefaultCurrent">XML_DefaultCurrent</a></code>.</p>
1425 <p>See also <code><a
1426 href="#XML_DefaultCurrent">XML_DefaultCurrent</a></code>.</p>
1446 <code>XML_SetParamEntityParsing</code></a>.)</p>
1448 <p>The <code>context</code> parameter specifies the parsing context in
1449 the format expected by the <code>context</code> argument to <code><a
1451 >XML_ExternalEntityParserCreate</a></code>. <code>code</code> is
1453 to be parsed later, it must be copied. <code>context</code> is NULL
1457 <p>The <code>base</code> parameter is the base to use for relative
1458 system identifiers. It is set by <code><a
1459 href="#XML_SetBase">XML_SetBase</a></code> and may be NULL. The
1460 <code>publicId</code> parameter is the public id given in the entity
1461 declaration and may be NULL. <code>systemId</code> is the system
1466 integer). <code>XML_STATUS_OK</code> should be returned for successful
1468 <code>XML_STATUS_ERROR</code> indicates failure, and causes the
1470 <code>XML_ERROR_EXTERNAL_ENTITY_HANDLING</code> error.</p>
1475 <code><a href= "#XML_ExternalEntityParserCreate"
1476 >XML_ExternalEntityParserCreate</a></code>. Using the returned
1490 <code>arg</code> is not NULL, it is the new value passed to the
1491 handler set using <code><a href="#XML_SetExternalEntityRefHandler"
1492 >XML_SetExternalEntityRefHandler</a></code>; if <code>arg</code> is
1497 The type of <code>arg</code> and the type of the first argument to the
1499 <code>void *</code> to be passed to the handler, while the handler
1500 accepts an <code>XML_Parser</code>. This is a historical accident,
1502 causing compiler warnings for code that's known to work with this
1503 API. It is the responsibility of the application code to know the
1525 <a href="#XML_SetDefaultHandler"><code>XML_SetDefaultHandler</code></a>
1528 <p>The <code>is_parameter_entity</code> argument will be non-zero for
1557 <code><a href= "#XML_Parse" >XML_Parse</a></code> or <code><a href=
1558 "#XML_ParseBuffer" >XML_ParseBuffer</a></code> have been called on the
1560 with the given name, it should fill in the <code>info</code> data
1561 structure and return <code>XML_STATUS_OK</code>. Otherwise it
1562 should return <code>XML_STATUS_ERROR</code>. The handler will be called
1564 data pointer <code>encodingHandlerData</code> will be passed back to
1576 function is the data pointer from <code>XML_Encoding</code>. The
1580 <p>The function pointed at by <code>release</code> is called by the
1644 distinguish is that the <code>version</code> parameter will be NULL
1645 for text declarations. The <code>encoding</code> parameter may be NULL
1646 for an XML declaration. The <code>standalone</code> argument will
1667 before any external or internal subset is parsed. Both <code>sysid</code>
1668 and <code>pubid</code> may be NULL. The <code>has_internal_subset</code>
1739 <code><a href="#XML_FreeContentModel"
1740 >XML_FreeContentModel</a></code>.</p>
1742 <p>The <code>model</code> argument is the root of a tree of
1743 <code>XML_Content</code> nodes. If <code>type</code> equals
1744 <code>XML_CTYPE_EMPTY</code> or <code>XML_CTYPE_ANY</code>, then
1745 <code>quant</code> will be <code>XML_CQUANT_NONE</code>, and the other
1746 fields will be zero or NULL. If <code>type</code> is
1747 <code>XML_CTYPE_MIXED</code>, then <code>quant</code> will be
1748 <code>XML_CQUANT_NONE</code> or <code>XML_CQUANT_REP</code> and
1749 <code>numchildren</code> will contain the number of elements that are
1750 allowed to be mixed in and <code>children</code> points to an array of
1751 <code>XML_Content</code> structures that will all have type
1753 <code>XML_CTYPE_EMPTY</code>, <code>XML_CTYPE_ANY</code>, or
1754 <code>XML_CTYPE_MIXED</code>.</p>
1756 <p>For type <code>XML_CTYPE_NAME</code>, the <code>name</code> field
1757 points to the name and the <code>numchildren</code> and
1758 <code>children</code> fields will be zero and NULL. The
1759 <code>quant</code> field will indicate any quantifiers placed on the
1762 <p>Types <code>XML_CTYPE_CHOICE</code> and <code>XML_CTYPE_SEQ</code>
1764 <code>numchildren</code> field indicates how many nodes in the choice
1765 or sequence and <code>children</code> points to the nodes.</p>
1786 handler. The <code>elname</code> parameter returns the name of the
1788 is in the <code>attname</code> parameter. The attribute type is in the
1789 <code>att_type</code> parameter. It is the string representing the
1792 <p>The <code>dflt</code> parameter holds the default value. It will be
1794 distinguish these two cases by checking the <code>isrequired</code>
1797 <code>isrequired</code>, but they will have the non-NULL fixed value
1798 in the <code>dflt</code> parameter.</p>
1820 The <code>is_parameter_entity</code> argument will be non-zero in the
1823 <p>For internal entities (<code><!ENTITY foo "bar"></code>),
1824 <code>value</code> will be non-NULL and <code>systemId</code>,
1825 <code>publicId</code>, and <code>notationName</code> will all be NULL.
1827 provided in the <code>value_length</code> parameter. Do not use
1828 <code>value_length</code> to test for internal entities, since it is
1830 <code>value</code> is NULL.</p> <p>The <code>notationName</code>
1891 declaration. If this handler returns <code>XML_STATUS_ERROR</code>,
1892 then the parser will throw an <code>XML_ERROR_NOT_STANDALONE</code>
1899 functions return <code>XML_STATUS_ERROR</code> (a parse error has
1904 the parse functions to return <code>XML_STATUS_ERROR</code>.) The
1924 XML_ErrorString(enum XML_Error code);
1927 Return a string describing the error corresponding to code.
1928 The code should be one of the enums that can be returned from
1929 <code><a href= "#XML_GetErrorCode" >XML_GetErrorCode</a></code>.
1938 the values returned by <code><a href= "#XML_GetCurrentLineNumber"
1939 >XML_GetCurrentLineNumber</a></code> and <code><a href=
1940 "#XML_GetCurrentColumnNumber" >XML_GetCurrentColumnNumber</a></code>.
1949 <code>1</code>.
1967 <code>0</code> if the event is inside a reference to an internal
1982 <code>offset</code> to the offset within this buffer of the current
1983 parse position, and set the integer pointed at by <code>size</code> to
1995 <p>If <code>XML_CONTEXT_BYTES</code> is not defined, this will always
2013 <code>userData</code> when it is finished with the parser. So if you
2034 <code>userData</code> arguments. The user data can still be obtained
2035 using the <code><a href= "#XML_GetUserData"
2036 >XML_GetUserData</a></code> function.
2046 identifiers. The return value is <code>XML_STATUS_ERROR</code> if
2048 <code>XML_STATUS_OK</code>.
2069 <code>atts</code> array passed to the start tag handler of the first
2081 last call to <code><a href= "#XML_StartElementHandler"
2082 >XML_StartElementHandler</a></code>, or -1 if there is no ID
2100 Returns an array of <code>XML_AttrInfo</code> structures for the
2102 <code>XML_StartElementHandler</code> that were specified
2105 <code>XML_GetSpecifiedAttributeCount(parser) / 2</code>.
2116 It must not be called after <code><a href= "#XML_Parse"
2117 >XML_Parse</a></code> or <code><a href= "#XML_ParseBuffer"
2118 >XML_ParseBuffer</a></code> have been called on the given parser.
2119 Returns <code>XML_STATUS_OK</code> on success or
2120 <code>XML_STATUS_ERROR</code> on error.
2126 enum XML_ParamEntityParsing code);
2131 <code>code</code>.
2132 The choices for <code>code</code> are:
2134 <li><code>XML_PARAM_ENTITY_PARSING_NEVER</code></li>
2135 <li><code>XML_PARAM_ENTITY_PARSING_UNLESS_STANDALONE</code></li>
2136 <li><code>XML_PARAM_ENTITY_PARSING_ALWAYS</code></li>
2138 <b>Note:</b> If <code>XML_SetParamEntityParsing</code> is called after
2139 <code>XML_Parse</code> or <code>XML_ParseBuffer</code>, then it has
2153 after <code>XML_Parse</code> or <code>XML_ParseBuffer</code>.
2156 <p><b>Note:</b>One should not call <code>XML_SetHashSalt</code> with a
2158 that <code>XML_SetHashSalt</code> has <b>not</b> been called. Consequently
2172 declaration at all and <code>useDTD</code> is true, the
2174 <code>startDoctypeDeclHandler</code> and
2175 <code>endDoctypeDeclHandler</code> functions, if set, will not be
2177 <code><a href= "#XML_SetParamEntityParsing"
2178 >XML_SetParamEntityParsing</a></code>, will be honored.</p>
2181 external entity reference handler set via <code><a href=
2183 >XML_SetExternalEntityRefHandler</a></code> with both
2184 <code>publicId</code> and <code>systemId</code> set to NULL.</p>
2187 <code>XML_ERROR_CANT_CHANGE_FEATURE_ONCE_PARSING</code> and ignores
2188 <code>useDTD</code>. If called when Expat has been compiled without
2190 <code>XML_ERROR_FEATURE_REQUIRES_XML_DTD</code>. Otherwise, it
2191 returns <code>XML_ERROR_NONE</code>.</p>
2194 <code>useDTD == XML_TRUE</code> will make the parser behave as if
2207 <code><a href= "#XML_ParserCreateNS" >XML_ParserCreateNS</a></code>,
2208 i.e. when namespace processing is in effect. The <code>do_nst</code>
2210 namespace prefix. If this function is called with <code>do_nst</code>
2216 <code>do_nst</code> is zero, then namespaces are reported in the
2228 markup to be passed to the default handler set by <code><a
2229 href="#XML_SetDefaultHandler" >XML_SetDefaultHandler</a></code> or
2230 <code><a href="#XML_SetDefaultHandlerExpand"
2231 >XML_SetDefaultHandlerExpand</a></code>. It does nothing if there is
2240 Return the library version as a string (e.g. <code>"expat_1.95.1"</code>).
2259 <li><code>XML_MAJOR_VERSION</code></li>
2260 <li><code>XML_MINOR_VERSION</code></li>
2261 <li><code>XML_MICRO_VERSION</code></li>
2295 available from Expat. This function allows code that does need to
2298 <p>The return value is an array of <code>XML_Feature</code>,
2299 terminated by a record with a <code>feature</code> of
2300 <code>XML_FEATURE_END</code> and <code>name</code> of NULL,
2303 the type of character the <code>name</code> points to, records for the
2304 <code>XML_FEATURE_SIZEOF_XML_CHAR</code> and
2305 <code>XML_FEATURE_SIZEOF_XML_LCHAR</code> will be located at the
2306 beginning of the list, followed by <code>XML_FEATURE_UNICODE</code>
2307 and <code>XML_FEATURE_UNICODE_WCHAR_T</code>, if they are present at
2311 associated value, the <code>value</code> field is set to 0. At this
2315 <dt><code>XML_FEATURE_SIZEOF_XML_CHAR</code></dt>
2316 <dd>The number of bytes occupied by one <code>XML_Char</code>
2318 <dt><code>XML_FEATURE_SIZEOF_XML_LCHAR</code></dt>
2319 <dd>The number of bytes occupied by one <code>XML_LChar</code>
2321 <dt><code>XML_FEATURE_CONTEXT_BYTES</code></dt>
2323 reported by <code><a href= "#XML_GetInputContext"
2324 >XML_GetInputContext</a></code>.</dd>
2333 Function to deallocate the <code>model</code> argument passed to the
2334 <code>XML_ElementDeclHandler</code> callback set using <code><a
2335 href="#XML_SetElementDeclHandler" >XML_ElementDeclHandler</a></code>.
2339 <p>The following functions allow external code to share the memory
2340 allocator an <code>XML_Parser</code> has been configured to use. This
2342 parser object created by application code, or heavily layered
2352 Allocate <code>size</code> bytes of memory using the allocator the
2353 <code>parser</code> object has been configured to use. Returns a
2355 way must be freed using <code><a href="#XML_MemFree"
2356 >XML_MemFree</a></code>.
2364 Allocate <code>size</code> bytes of memory using the allocator the
2365 <code>parser</code> object has been configured to use.
2366 <code>ptr</code> must point to a block of memory allocated by <code><a
2367 href="#XML_MemMalloc" >XML_MemMalloc</a></code> or
2368 <code>XML_MemRealloc</code>, or be NULL. This function tries to
2369 expand the block pointed to by <code>ptr</code> if possible. Returns
2374 <code><a href="#XML_MemFree"
2375 >XML_MemFree</a></code>.
2383 Free a block of memory pointed to by <code>ptr</code>. The block must
2384 have been allocated by <code><a href="#XML_MemMalloc"
2385 >XML_MemMalloc</a></code> or <code>XML_MemRealloc</code>, or be NULL.
