Details
CHECK_TYPE()
#define CHECK_TYPE(typeval) |
xmlXPatherror ()
| ctxt : | |
| file : | |
| line : | |
| no : | |
xmlXPathDebugDumpObject ()
xmlXPathRegisterFunc ()
Register a new function. If f is NULL it unregisters the function
| ctxt : | the XPath context |
| name : | the function name |
| f : | the function implementation or NULL |
| Returns : | 0 in case of success, -1 in case of error |
xmlXPathRegisterFuncNS ()
Register a new function. If f is NULL it unregisters the function
| ctxt : | the XPath context |
| name : | the function name |
| ns_uri : | the function namespace URI |
| f : | the function implementation or NULL |
| Returns : | 0 in case of success, -1 in case of error |
xmlXPathRegisterVariable ()
Register a new variable value. If value is NULL it unregisters
+the variable
| ctxt : | the XPath context |
| name : | the variable name |
| value : | the variable value or NULL |
| Returns : | 0 in case of success, -1 in case of error |
xmlXPathRegisterVariableNS ()
Register a new variable value. If value is NULL it unregisters
+the variable
| ctxt : | the XPath context |
| name : | the variable name |
| ns_uri : | the variable namespace URI |
| value : | the variable value or NULL |
| Returns : | 0 in case of success, -1 in case of error |
xmlXPathFunctionLookup ()
Search in the Function array of the context for the given
+function.
| ctxt : | the XPath context |
| name : | the function name |
| Returns : | the xmlXPathFunction or NULL if not found |
xmlXPathFunctionLookupNS ()
Search in the Function array of the context for the given
+function.
| ctxt : | the XPath context |
| name : | the function name |
| ns_uri : | the function namespace URI |
| Returns : | the xmlXPathFunction or NULL if not found |
xmlXPathRegisteredFuncsCleanup ()
Cleanup the XPath context data associated to registered functions
xmlXPathVariableLookup ()
Search in the Variable array of the context for the given
+variable value.
| ctxt : | the XPath context |
| name : | the variable name |
| Returns : | the value or NULL if not found |
xmlXPathVariableLookupNS ()
Search in the Variable array of the context for the given
+variable value.
| ctxt : | the XPath context |
| name : | the variable name |
| ns_uri : | the variable namespace URI |
| Returns : | the value or NULL if not found |
xmlXPathRegisteredVariablesCleanup ()
Cleanup the XPath context data associated to registered variables
xmlXPathNewParserContext ()
Create a new xmlXPathParserContext
| str : | the XPath expression |
| ctxt : | the XPath context |
| Returns : | the xmlXPathParserContext just allocated. |
xmlXPathFreeParserContext ()
Free up an xmlXPathParserContext
| ctxt : | the context to free |
xmlXPathNewString ()
Create a new xmlXPathObjectPtr of type string and of value val
| val : | the xmlChar * value |
| Returns : | the newly created object. |
xmlXPathNewCString ()
Create a new xmlXPathObjectPtr of type string and of value val
| val : | the char * value |
| Returns : | the newly created object. |
xmlXPathNewFloat ()
Create a new xmlXPathObjectPtr of type double and of value val
| val : | the double value |
| Returns : | the newly created object. |
xmlXPathNewBoolean ()
Create a new xmlXPathObjectPtr of type boolean and of value val
| val : | the boolean value |
| Returns : | the newly created object. |
xmlXPathNewNodeSet ()
Create a new xmlXPathObjectPtr of type NodeSet and initialize
+it with the single Node val
| val : | the NodePtr value |
| Returns : | the newly created object. |
xmlXPathNodeSetAdd ()
add a new xmlNodePtr ot an existing NodeSet
| cur : | the initial node set |
| val : | a new xmlNodePtr |
xmlXPathIdFunction ()
Implement the id() XPath function
+node-set id(object)
+The id function selects elements by their unique ID
+(see [5.2.1 Unique IDs]). When the argument to id is of type node-set,
+then the result is the union of the result of applying id to the
+string value of each of the nodes in the argument node-set. When the
+argument to id is of any other type, the argument is converted to a
+string as if by a call to the string function; the string is split
+into a whitespace-separated list of tokens (whitespace is any sequence
+of characters matching the production S); the result is a node-set
+containing the elements in the same document as the context node that
+have a unique ID equal to any of the tokens in the list.
| ctxt : | the XPath Parser context |
| nargs : | |
xmlXPathRoot ()
Initialize the context to the root of the document
| ctxt : | the XPath Parser context |
xmlXPathEvalExpr ()
[14] Expr ::= OrExpr
+[21] OrExpr ::= AndExpr
+| OrExpr 'or' AndExpr
Parse and evaluate an expression, then push the result on the stack
| ctxt : | the XPath Parser context |
xmlXPathParseName ()
parse an XML name
[4] NameChar ::= Letter | Digit | '.' | '-' | '_' | ':' |
+CombiningChar | Extender
[5] Name ::= (Letter | '_' | ':') (NameChar)*
| ctxt : | the XPointer Parser context |
| Returns : | the namespace name or NULL |
xmlXPathStringEvalNumber ()
double xmlXPathStringEvalNumber (const xmlChar *str); |
[30] Number ::= Digits ('.' Digits?)?
+| '.' Digits
+[31] Digits ::= [0-9]+
Parse and evaluate a Number in the string
+In complement of the Number expression, this function also handles
+negative values : '-' Number.
| str : | A string to scan |
| Returns : | the double value. |
xmlXPathInit ()
void xmlXPathInit (void); |
Initialize the XPath environment
xmlXPathStringFunction ()
Implement the string() XPath function
+string string(object?)
+he string function converts an object to a string as follows:
+- A node-set is converted to a string by returning the value of
+the node in the node-set that is first in document order.
+If the node-set is empty, an empty string is returned.
+- A number is converted to a string as follows
++ NaN is converted to the string NaN
++ positive zero is converted to the string 0
++ negative zero is converted to the string 0
++ positive infinity is converted to the string Infinity
++ negative infinity is converted to the string -Infinity
++ if the number is an integer, the number is represented in
+decimal form as a Number with no decimal point and no leading
+zeros, preceded by a minus sign (-) if the number is negative
++ otherwise, the number is represented in decimal form as a
+Number including a decimal point with at least one digit
+before the decimal point and at least one digit after the
+decimal point, preceded by a minus sign (-) if the number
+is negative; there must be no leading zeros before the decimal
+point apart possibly from the one required digit immediatelyi
+before the decimal point; beyond the one required digit
+after the decimal point there must be as many, but only as
+many, more digits as are needed to uniquely distinguish the
+number from all other IEEE 754 numeric values.
+- The boolean false value is converted to the string false.
+The boolean true value is converted to the string true.
If the argument is omitted, it defaults to a node-set with the
+context node as its only member.
| ctxt : | the XPath Parser context |
| nargs : | |
xmlXPathRegisterAllFunctions ()
xmlXPathNodeSetCreate ()
Create a new xmlNodeSetPtr of type double and of value val
xmlXPathNodeSetMerge ()
Merges two nodesets, all nodes from val2 are added to val1
+if val1 is NULL, a new set is created and copied from val2
| val1 : | the first NodeSet or NULL |
| val2 : | the second NodeSet |
| Returns : | val1 once extended or NULL in case of error. |
xmlXPathNodeSetDel ()
Removes an xmlNodePtr from an existing NodeSet
| cur : | the initial node set |
| val : | an xmlNodePtr |
xmlXPathNodeSetRemove ()
Removes an entry from an existing NodeSet list.
| cur : | the initial node set |
| val : | the index to remove |
xmlXPathFreeNodeSet ()
Free the NodeSet compound (not the actual nodes !).
xmlXPathNewNodeSetList ()
Create a new xmlXPathObjectPtr of type NodeSet and initialize
+it with the Nodeset val
| val : | an existing NodeSet |
| Returns : | the newly created object. |
xmlXPathWrapNodeSet ()
Wrap the Nodeset val in a new xmlXPathObjectPtr
| val : | the NodePtr value |
| Returns : | the newly created object. |
xmlXPathFreeNodeSetList ()
Free up the xmlXPathObjectPtr obj but don't deallocate the objects in
+the list contrary to xmlXPathFreeObject().
xmlXPathFreeObject ()
Free up an xmlXPathObjectPtr object.
xmlXPathNewContext ()
Create a new xmlXPathContext
xmlXPathFreeContext ()
Free up an xmlXPathContext
xmlXPathEqualValues ()
Implement the equal operation on XPath objects content: arg1 == arg2
| ctxt : | the XPath Parser context |
| Returns : | 0 or 1 depending on the results of the test. |
xmlXPathCompareValues ()
Implement the compare operation on XPath objects:
+arg1 < arg2 (1, 1, ...
+arg1 <= arg2 (1, 0, ...
+arg1 > arg2 (0, 1, ...
+arg1 >= arg2 (0, 0, ...
When neither object to be compared is a node-set and the operator is
+<=, <, >=, >, then the objects are compared by converted both objects
+to numbers and comparing the numbers according to IEEE 754. The <
+comparison will be true if and only if the first number is less than the
+second number. The <= comparison will be true if and only if the first
+number is less than or equal to the second number. The > comparison
+will be true if and only if the first number is greater than the second
+number. The >= comparison will be true if and only if the first number
+is greater than or equal to the second number.
| ctxt : | the XPath Parser context |
| inf : | less than (1) or greater than (2) |
| strict : | is the comparison strict |
| Returns : | |
xmlXPathValueFlipSign ()
Implement the unary - operation on an XPath object
+The numeric operators convert their operands to numbers as if
+by calling the number function.
| ctxt : | the XPath Parser context |
xmlXPathAddValues ()
Implement the add operation on XPath objects:
+The numeric operators convert their operands to numbers as if
+by calling the number function.
| ctxt : | the XPath Parser context |
xmlXPathSubValues ()
Implement the substraction operation on XPath objects:
+The numeric operators convert their operands to numbers as if
+by calling the number function.
| ctxt : | the XPath Parser context |
xmlXPathMultValues ()
Implement the multiply operation on XPath objects:
+The numeric operators convert their operands to numbers as if
+by calling the number function.
| ctxt : | the XPath Parser context |
xmlXPathDivValues ()
Implement the div operation on XPath objects:
+The numeric operators convert their operands to numbers as if
+by calling the number function.
| ctxt : | the XPath Parser context |
xmlXPathModValues ()
Implement the div operation on XPath objects: arg1 / arg2
+The numeric operators convert their operands to numbers as if
+by calling the number function.
| ctxt : | the XPath Parser context |
xmlXPathLastFunction ()
Implement the last() XPath function
+number last()
+The last function returns the number of nodes in the context node list.
| ctxt : | the XPath Parser context |
| nargs : | |
xmlXPathPositionFunction ()
Implement the position() XPath function
+number position()
+The position function returns the position of the context node in the
+context node list. The first position is 1, and so the last positionr
+will be equal to last().
| ctxt : | the XPath Parser context |
| nargs : | |
xmlXPathCountFunction ()
Implement the count() XPath function
+number count(node-set)
| ctxt : | the XPath Parser context |
| nargs : | |
xmlXPathLocalNameFunction ()
Implement the local-name() XPath function
+string local-name(node-set?)
+The local-name function returns a string containing the local part
+of the name of the node in the argument node-set that is first in
+document order. If the node-set is empty or the first node has no
+name, an empty string is returned. If the argument is omitted it
+defaults to the context node.
| ctxt : | the XPath Parser context |
| nargs : | |
xmlXPathNamespaceURIFunction ()
Implement the namespace-uri() XPath function
+string namespace-uri(node-set?)
+The namespace-uri function returns a string containing the
+namespace URI of the expanded name of the node in the argument
+node-set that is first in document order. If the node-set is empty,
+the first node has no name, or the expanded name has no namespace
+URI, an empty string is returned. If the argument is omitted it
+defaults to the context node.
| ctxt : | the XPath Parser context |
| nargs : | |
xmlXPathStringLengthFunction ()
Implement the string-length() XPath function
+number string-length(string?)
+The string-length returns the number of characters in the string
+(see [3.6 Strings]). If the argument is omitted, it defaults to
+the context node converted to a string, in other words the value
+of the context node.
| ctxt : | the XPath Parser context |
| nargs : | |
xmlXPathConcatFunction ()
Implement the concat() XPath function
+string concat(string, string, string*)
+The concat function returns the concatenation of its arguments.
| ctxt : | the XPath Parser context |
| nargs : | |
xmlXPathContainsFunction ()
Implement the contains() XPath function
+boolean contains(string, string)
+The contains function returns true if the first argument string
+contains the second argument string, and otherwise returns false.
| ctxt : | the XPath Parser context |
| nargs : | |
xmlXPathStartsWithFunction ()
Implement the starts-with() XPath function
+boolean starts-with(string, string)
+The starts-with function returns true if the first argument string
+starts with the second argument string, and otherwise returns false.
| ctxt : | the XPath Parser context |
| nargs : | |
xmlXPathSubstringFunction ()
Implement the substring() XPath function
+string substring(string, number, number?)
+The substring function returns the substring of the first argument
+starting at the position specified in the second argument with
+length specified in the third argument. For example,
+substring("12345",2,3) returns "234". If the third argument is not
+specified, it returns the substring starting at the position specified
+in the second argument and continuing to the end of the string. For
+example, substring("12345",2) returns "2345". More precisely, each
+character in the string (see [3.6 Strings]) is considered to have a
+numeric position: the position of the first character is 1, the position
+of the second character is 2 and so on. The returned substring contains
+those characters for which the position of the character is greater than
+or equal to the second argument and, if the third argument is specified,
+less than the sum of the second and third arguments; the comparisons
+and addition used for the above follow the standard IEEE 754 rules. Thus:
+- substring("12345", 1.5, 2.6) returns "234"
+- substring("12345", 0, 3) returns "12"
+- substring("12345", 0 div 0, 3) returns ""
+- substring("12345", 1, 0 div 0) returns ""
+- substring("12345", -42, 1 div 0) returns "12345"
+- substring("12345", -1 div 0, 1 div 0) returns ""
| ctxt : | the XPath Parser context |
| nargs : | |
xmlXPathSubstringBeforeFunction ()
Implement the substring-before() XPath function
+string substring-before(string, string)
+The substring-before function returns the substring of the first
+argument string that precedes the first occurrence of the second
+argument string in the first argument string, or the empty string
+if the first argument string does not contain the second argument
+string. For example, substring-before("1999/04/01","/") returns 1999.
| ctxt : | the XPath Parser context |
| nargs : | |
xmlXPathSubstringAfterFunction ()
Implement the substring-after() XPath function
+string substring-after(string, string)
+The substring-after function returns the substring of the first
+argument string that follows the first occurrence of the second
+argument string in the first argument string, or the empty stringi
+if the first argument string does not contain the second argument
+string. For example, substring-after("1999/04/01","/") returns 04/01,
+and substring-after("1999/04/01","19") returns 99/04/01.
| ctxt : | the XPath Parser context |
| nargs : | |
xmlXPathNormalizeFunction ()
Implement the normalize-space() XPath function
+string normalize-space(string?)
+The normalize-space function returns the argument string with white
+space normalized by stripping leading and trailing whitespace
+and replacing sequences of whitespace characters by a single
+space. Whitespace characters are the same allowed by the S production
+in XML. If the argument is omitted, it defaults to the context
+node converted to a string, in other words the value of the context node.
| ctxt : | the XPath Parser context |
| nargs : | |
xmlXPathTranslateFunction ()
Implement the translate() XPath function
+string translate(string, string, string)
+The translate function returns the first argument string with
+occurrences of characters in the second argument string replaced
+by the character at the corresponding position in the third argument
+string. For example, translate("bar","abc","ABC") returns the string
+BAr. If there is a character in the second argument string with no
+character at a corresponding position in the third argument string
+(because the second argument string is longer than the third argument
+string), then occurrences of that character in the first argument
+string are removed. For example, translate("--aaa--","abc-","ABC")
| ctxt : | the XPath Parser context |
| nargs : | |
xmlXPathNotFunction ()
Implement the not() XPath function
+boolean not(boolean)
+The not function returns true if its argument is false,
+and false otherwise.
| ctxt : | the XPath Parser context |
| nargs : | |
xmlXPathTrueFunction ()
Implement the true() XPath function
+boolean true()
| ctxt : | the XPath Parser context |
| nargs : | |
xmlXPathFalseFunction ()
Implement the false() XPath function
+boolean false()
| ctxt : | the XPath Parser context |
| nargs : | |
xmlXPathLangFunction ()
Implement the lang() XPath function
+boolean lang(string)
+The lang function returns true or false depending on whether the
+language of the context node as specified by xml:lang attributes
+is the same as or is a sublanguage of the language specified by
+the argument string. The language of the context node is determined
+by the value of the xml:lang attribute on the context node, or, if
+the context node has no xml:lang attribute, by the value of the
+xml:lang attribute on the nearest ancestor of the context node that
+has an xml:lang attribute. If there is no such attribute, then lang
| ctxt : | the XPath Parser context |
| nargs : | |
xmlXPathNumberFunction ()
Implement the number() XPath function
+number number(object?)
| ctxt : | the XPath Parser context |
| nargs : | |
xmlXPathSumFunction ()
Implement the sum() XPath function
+number sum(node-set)
+The sum function returns the sum of the values of the nodes in
+the argument node-set.
| ctxt : | the XPath Parser context |
| nargs : | |
xmlXPathFloorFunction ()
Implement the floor() XPath function
+number floor(number)
+The floor function returns the largest (closest to positive infinity)
+number that is not greater than the argument and that is an integer.
| ctxt : | the XPath Parser context |
| nargs : | |
xmlXPathCeilingFunction ()
Implement the ceiling() XPath function
+number ceiling(number)
+The ceiling function returns the smallest (closest to negative infinity)
+number that is not less than the argument and that is an integer.
| ctxt : | the XPath Parser context |
| nargs : | |
xmlXPathRoundFunction ()
Implement the round() XPath function
+number round(number)
+The round function returns the number that is closest to the
+argument and that is an integer. If there are two such numbers,
+then the one that is even is returned.
| ctxt : | the XPath Parser context |
| nargs : | |