#

## Module xpointer from libxml2

API Menu

- Main Menu
- Developer Menu
- Code Examples
- API Menu
- Parser API
- Tree API
- Reader API
- XML Guidelines
- ChangeLog

API Indexes

- Alphabetic
- Constructors
- Functions/Types
- Modules
- Symbols

Related links

- Mail archive
- XSLT libxslt
- DOM gdome2
- XML-DSig xmlsec
- FTP
- Windows binaries
- Solaris binaries
- MacOsX binaries
- lxml Python bindings
- Perl bindings
- C++ bindings
- PHP bindings
- Pascal bindings
- Ruby bindings
- Tcl bindings
- Bug Tracker

API to handle XML Pointers Base implementation was made accordingly to W3C Candidate Recommendation 7 June 2000

## Table of Contents

    Structure xmlLocationSet
    struct _xmlLocationSet

    Typedef xmlLocationSet * xmlLocationSetPtr

    xmlNodePtr	xmlXPtrBuildNodeList	(xmlXPathObjectPtr obj)

    xmlXPathObjectPtr	xmlXPtrEval	(const xmlChar * str,
    					 xmlXPathContextPtr ctx)

    void	xmlXPtrEvalRangePredicate	(xmlXPathParserContextPtr ctxt)

    void	xmlXPtrFreeLocationSet		(xmlLocationSetPtr obj)

    void	xmlXPtrLocationSetAdd		(xmlLocationSetPtr cur,
    					 xmlXPathObjectPtr val)

    xmlLocationSetPtr	xmlXPtrLocationSetCreate	(xmlXPathObjectPtr val)

    void	xmlXPtrLocationSetDel		(xmlLocationSetPtr cur,
    					 xmlXPathObjectPtr val)

    xmlLocationSetPtr	xmlXPtrLocationSetMerge	(xmlLocationSetPtr val1,
    						 xmlLocationSetPtr val2)

    void	xmlXPtrLocationSetRemove	(xmlLocationSetPtr cur,
    					 int val)

    xmlXPathObjectPtr	xmlXPtrNewCollapsedRange	(xmlNodePtr start)

    xmlXPathContextPtr	xmlXPtrNewContext	(xmlDocPtr doc,
    						 xmlNodePtr here,
    						 xmlNodePtr origin)

    xmlXPathObjectPtr	xmlXPtrNewLocationSetNodeSet	(xmlNodeSetPtr set)

    xmlXPathObjectPtr	xmlXPtrNewLocationSetNodes	(xmlNodePtr start,
    							 xmlNodePtr end)

    xmlXPathObjectPtr	xmlXPtrNewRange	(xmlNodePtr start,
    					 int startindex,
    					 xmlNodePtr end,
    					 int endindex)

    xmlXPathObjectPtr	xmlXPtrNewRangeNodeObject	(xmlNodePtr start,
    							 xmlXPathObjectPtr end)

    xmlXPathObjectPtr	xmlXPtrNewRangeNodePoint	(xmlNodePtr start,
    							 xmlXPathObjectPtr end)

    xmlXPathObjectPtr	xmlXPtrNewRangeNodes	(xmlNodePtr start,
    						 xmlNodePtr end)

    xmlXPathObjectPtr	xmlXPtrNewRangePointNode	(xmlXPathObjectPtr start,
    							 xmlNodePtr end)

    xmlXPathObjectPtr	xmlXPtrNewRangePoints	(xmlXPathObjectPtr start,
    						 xmlXPathObjectPtr end)

    void	xmlXPtrRangeToFunction		(xmlXPathParserContextPtr ctxt,
    					 int nargs)

    xmlXPathObjectPtr	xmlXPtrWrapLocationSet	(xmlLocationSetPtr val)

## Description

### Structure xmlLocationSet

    Structure xmlLocationSet
    struct _xmlLocationSet {
        int	locNr	: number of locations in the set
        int	locMax	: size of the array as allocated
        xmlXPathObjectPtr *	locTab	: array of locations
    }

### Function: xmlXPtrBuildNodeList

    xmlNodePtr	xmlXPtrBuildNodeList	(xmlXPathObjectPtr obj)

Build a node list tree copy of the XPointer result. This will drop Attributes and Namespace declarations.

`obj`: | the XPointer result from the evaluation.
`Returns`: | an xmlNodePtr list or NULL. the caller has to free the node tree.

### Function: xmlXPtrEval

    xmlXPathObjectPtr	xmlXPtrEval	(const xmlChar * str,
    					 xmlXPathContextPtr ctx)

Evaluate the XPath Location Path in the given context.

`str`: | the XPointer expression
`ctx`: | the XPointer context
`Returns`: | the xmlXPathObjectPtr resulting from the evaluation or NULL. the caller has to free the object.

### Function: xmlXPtrEvalRangePredicate

    void	xmlXPtrEvalRangePredicate	(xmlXPathParserContextPtr ctxt)

[8] Predicate ::= '[' PredicateExpr ']' [9] PredicateExpr ::= Expr Evaluate a predicate as in xmlXPathEvalPredicate() but for a Location Set instead of a node set

`ctxt`: | the XPointer Parser context

### Function: xmlXPtrFreeLocationSet

    void	xmlXPtrFreeLocationSet		(xmlLocationSetPtr obj)

Free the LocationSet compound (not the actual ranges !).

`obj`: | the xmlLocationSetPtr to free

### Function: xmlXPtrLocationSetAdd

    void	xmlXPtrLocationSetAdd		(xmlLocationSetPtr cur,
    					 xmlXPathObjectPtr val)

add a new xmlXPathObjectPtr to an existing LocationSet If the location already exist in the set @val is freed.

`cur`: | the initial range set
`val`: | a new xmlXPathObjectPtr

### Function: xmlXPtrLocationSetCreate

    xmlLocationSetPtr	xmlXPtrLocationSetCreate	(xmlXPathObjectPtr val)

Create a new xmlLocationSetPtr of type double and of value @val

`val`: | an initial xmlXPathObjectPtr, or NULL
`Returns`: | the newly created object.

### Function: xmlXPtrLocationSetDel

    void	xmlXPtrLocationSetDel		(xmlLocationSetPtr cur,
    					 xmlXPathObjectPtr val)

Removes an xmlXPathObjectPtr from an existing LocationSet

`cur`: | the initial range set
`val`: | an xmlXPathObjectPtr

### Function: xmlXPtrLocationSetMerge

    xmlLocationSetPtr	xmlXPtrLocationSetMerge	(xmlLocationSetPtr val1,
    						 xmlLocationSetPtr val2)

Merges two rangesets, all ranges from @val2 are added to @val1

`val1`: | the first LocationSet
`val2`: | the second LocationSet
`Returns`: | val1 once extended or NULL in case of error.

### Function: xmlXPtrLocationSetRemove

    void	xmlXPtrLocationSetRemove	(xmlLocationSetPtr cur,
    					 int val)

Removes an entry from an existing LocationSet list.

`cur`: | the initial range set
`val`: | the index to remove

### Function: xmlXPtrNewCollapsedRange

    xmlXPathObjectPtr	xmlXPtrNewCollapsedRange	(xmlNodePtr start)

Create a new xmlXPathObjectPtr of type range using a single nodes

`start`: | the starting and ending node
`Returns`: | the newly created object.

### Function: xmlXPtrNewContext

    xmlXPathContextPtr	xmlXPtrNewContext	(xmlDocPtr doc,
    						 xmlNodePtr here,
    						 xmlNodePtr origin)

Create a new XPointer context

`doc`: | the XML document
`here`: | the node that directly contains the XPointer being evaluated or NULL
`origin`: | the element from which a user or program initiated traversal of the link, or NULL.
`Returns`: | the xmlXPathContext just allocated.

### Function: xmlXPtrNewLocationSetNodeSet

    xmlXPathObjectPtr	xmlXPtrNewLocationSetNodeSet	(xmlNodeSetPtr set)

Create a new xmlXPathObjectPtr of type LocationSet and initialize it with all the nodes from @set

`set`: | a node set
`Returns`: | the newly created object.

### Function: xmlXPtrNewLocationSetNodes

    xmlXPathObjectPtr	xmlXPtrNewLocationSetNodes	(xmlNodePtr start,
    							 xmlNodePtr end)

Create a new xmlXPathObjectPtr of type LocationSet and initialize it with the single range made of the two nodes @start and @end

`start`: | the start NodePtr value
`end`: | the end NodePtr value or NULL
`Returns`: | the newly created object.

### Function: xmlXPtrNewRange

    xmlXPathObjectPtr	xmlXPtrNewRange	(xmlNodePtr start,
    					 int startindex,
    					 xmlNodePtr end,
    					 int endindex)

Create a new xmlXPathObjectPtr of type range

`start`: | the starting node
`startindex`: | the start index
`end`: | the ending point
`endindex`: | the ending index
`Returns`: | the newly created object.

### Function: xmlXPtrNewRangeNodeObject

    xmlXPathObjectPtr	xmlXPtrNewRangeNodeObject	(xmlNodePtr start,
    							 xmlXPathObjectPtr end)

Create a new xmlXPathObjectPtr of type range from a not to an object

`start`: | the starting node
`end`: | the ending object
`Returns`: | the newly created object.

### Function: xmlXPtrNewRangeNodePoint

    xmlXPathObjectPtr	xmlXPtrNewRangeNodePoint	(xmlNodePtr start,
    							 xmlXPathObjectPtr end)

Create a new xmlXPathObjectPtr of type range from a node to a point

`start`: | the starting node
`end`: | the ending point
`Returns`: | the newly created object.

### Function: xmlXPtrNewRangeNodes

    xmlXPathObjectPtr	xmlXPtrNewRangeNodes	(xmlNodePtr start,
    						 xmlNodePtr end)

Create a new xmlXPathObjectPtr of type range using 2 nodes

`start`: | the starting node
`end`: | the ending node
`Returns`: | the newly created object.

### Function: xmlXPtrNewRangePointNode

    xmlXPathObjectPtr	xmlXPtrNewRangePointNode	(xmlXPathObjectPtr start,
    							 xmlNodePtr end)

Create a new xmlXPathObjectPtr of type range from a point to a node

`start`: | the starting point
`end`: | the ending node
`Returns`: | the newly created object.

### Function: xmlXPtrNewRangePoints

    xmlXPathObjectPtr	xmlXPtrNewRangePoints	(xmlXPathObjectPtr start,
    						 xmlXPathObjectPtr end)

Create a new xmlXPathObjectPtr of type range using 2 Points

`start`: | the starting point
`end`: | the ending point
`Returns`: | the newly created object.

### Function: xmlXPtrRangeToFunction

    void	xmlXPtrRangeToFunction		(xmlXPathParserContextPtr ctxt,
    					 int nargs)

Implement the range-to() XPointer function Obsolete. range-to is not a real function but a special type of location step which is handled in xpath.c.

`ctxt`: | the XPointer Parser context
`nargs`: | the number of args

### Function: xmlXPtrWrapLocationSet

    xmlXPathObjectPtr	xmlXPtrWrapLocationSet	(xmlLocationSetPtr val)

Wrap the LocationSet @val in a new xmlXPathObjectPtr

`val`: | the LocationSet value
`Returns`: | the newly created object.

Daniel Veillard