mirror of
https://github.com/GNOME/libxml2.git
synced 2025-10-19 12:03:50 +08:00
670701075b
Add a new configuration flag that controls whether the outdated support
for XPointer locations (ranges and points) is enabled.
--with-xptr-locs # Autotools
LIBXML2_WITH_XPTR_LOCS # CMake
The latest spec for what it essentially an XPath extension seems to be
this working draft from 2002:
https://www.w3.org/TR/xptr-xpointer/
The xpointer() scheme is listed as "being reviewed" in the XPointer
registry since at least 2006. libxml2 seems to be the only modern
software that tries to implement this spec, but the code has many bugs
and quality issues.
The flag defaults to "off" and support for this extensions has to be
requested explicitly. The relevant API functions are deprecated.
138 lines
3.7 KiB
C
138 lines
3.7 KiB
C
/*
|
|
* Summary: API to handle XML Pointers
|
|
* Description: API to handle XML Pointers
|
|
* Base implementation was made accordingly to
|
|
* W3C Candidate Recommendation 7 June 2000
|
|
* http://www.w3.org/TR/2000/CR-xptr-20000607
|
|
*
|
|
* Added support for the element() scheme described in:
|
|
* W3C Proposed Recommendation 13 November 2002
|
|
* http://www.w3.org/TR/2002/PR-xptr-element-20021113/
|
|
*
|
|
* Copy: See Copyright for the status of this software.
|
|
*
|
|
* Author: Daniel Veillard
|
|
*/
|
|
|
|
#ifndef __XML_XPTR_H__
|
|
#define __XML_XPTR_H__
|
|
|
|
#include <libxml/xmlversion.h>
|
|
|
|
#ifdef LIBXML_XPTR_ENABLED
|
|
|
|
#include <libxml/tree.h>
|
|
#include <libxml/xpath.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#ifdef LIBXML_XPTR_LOCS_ENABLED
|
|
/*
|
|
* A Location Set
|
|
*/
|
|
typedef struct _xmlLocationSet xmlLocationSet;
|
|
typedef xmlLocationSet *xmlLocationSetPtr;
|
|
struct _xmlLocationSet {
|
|
int locNr; /* number of locations in the set */
|
|
int locMax; /* size of the array as allocated */
|
|
xmlXPathObjectPtr *locTab;/* array of locations */
|
|
};
|
|
|
|
/*
|
|
* Handling of location sets.
|
|
*/
|
|
|
|
XML_DEPRECATED
|
|
XMLPUBFUN xmlLocationSetPtr XMLCALL
|
|
xmlXPtrLocationSetCreate (xmlXPathObjectPtr val);
|
|
XML_DEPRECATED
|
|
XMLPUBFUN void XMLCALL
|
|
xmlXPtrFreeLocationSet (xmlLocationSetPtr obj);
|
|
XML_DEPRECATED
|
|
XMLPUBFUN xmlLocationSetPtr XMLCALL
|
|
xmlXPtrLocationSetMerge (xmlLocationSetPtr val1,
|
|
xmlLocationSetPtr val2);
|
|
XML_DEPRECATED
|
|
XMLPUBFUN xmlXPathObjectPtr XMLCALL
|
|
xmlXPtrNewRange (xmlNodePtr start,
|
|
int startindex,
|
|
xmlNodePtr end,
|
|
int endindex);
|
|
XML_DEPRECATED
|
|
XMLPUBFUN xmlXPathObjectPtr XMLCALL
|
|
xmlXPtrNewRangePoints (xmlXPathObjectPtr start,
|
|
xmlXPathObjectPtr end);
|
|
XML_DEPRECATED
|
|
XMLPUBFUN xmlXPathObjectPtr XMLCALL
|
|
xmlXPtrNewRangeNodePoint (xmlNodePtr start,
|
|
xmlXPathObjectPtr end);
|
|
XML_DEPRECATED
|
|
XMLPUBFUN xmlXPathObjectPtr XMLCALL
|
|
xmlXPtrNewRangePointNode (xmlXPathObjectPtr start,
|
|
xmlNodePtr end);
|
|
XML_DEPRECATED
|
|
XMLPUBFUN xmlXPathObjectPtr XMLCALL
|
|
xmlXPtrNewRangeNodes (xmlNodePtr start,
|
|
xmlNodePtr end);
|
|
XML_DEPRECATED
|
|
XMLPUBFUN xmlXPathObjectPtr XMLCALL
|
|
xmlXPtrNewLocationSetNodes (xmlNodePtr start,
|
|
xmlNodePtr end);
|
|
XML_DEPRECATED
|
|
XMLPUBFUN xmlXPathObjectPtr XMLCALL
|
|
xmlXPtrNewLocationSetNodeSet(xmlNodeSetPtr set);
|
|
XML_DEPRECATED
|
|
XMLPUBFUN xmlXPathObjectPtr XMLCALL
|
|
xmlXPtrNewRangeNodeObject (xmlNodePtr start,
|
|
xmlXPathObjectPtr end);
|
|
XML_DEPRECATED
|
|
XMLPUBFUN xmlXPathObjectPtr XMLCALL
|
|
xmlXPtrNewCollapsedRange (xmlNodePtr start);
|
|
XML_DEPRECATED
|
|
XMLPUBFUN void XMLCALL
|
|
xmlXPtrLocationSetAdd (xmlLocationSetPtr cur,
|
|
xmlXPathObjectPtr val);
|
|
XML_DEPRECATED
|
|
XMLPUBFUN xmlXPathObjectPtr XMLCALL
|
|
xmlXPtrWrapLocationSet (xmlLocationSetPtr val);
|
|
XML_DEPRECATED
|
|
XMLPUBFUN void XMLCALL
|
|
xmlXPtrLocationSetDel (xmlLocationSetPtr cur,
|
|
xmlXPathObjectPtr val);
|
|
XML_DEPRECATED
|
|
XMLPUBFUN void XMLCALL
|
|
xmlXPtrLocationSetRemove (xmlLocationSetPtr cur,
|
|
int val);
|
|
#endif /* LIBXML_XPTR_LOCS_ENABLED */
|
|
|
|
/*
|
|
* Functions.
|
|
*/
|
|
XMLPUBFUN xmlXPathContextPtr XMLCALL
|
|
xmlXPtrNewContext (xmlDocPtr doc,
|
|
xmlNodePtr here,
|
|
xmlNodePtr origin);
|
|
XMLPUBFUN xmlXPathObjectPtr XMLCALL
|
|
xmlXPtrEval (const xmlChar *str,
|
|
xmlXPathContextPtr ctx);
|
|
#ifdef LIBXML_XPTR_LOCS_ENABLED
|
|
XML_DEPRECATED
|
|
XMLPUBFUN void XMLCALL
|
|
xmlXPtrRangeToFunction (xmlXPathParserContextPtr ctxt,
|
|
int nargs);
|
|
XML_DEPRECATED
|
|
XMLPUBFUN xmlNodePtr XMLCALL
|
|
xmlXPtrBuildNodeList (xmlXPathObjectPtr obj);
|
|
XML_DEPRECATED
|
|
XMLPUBFUN void XMLCALL
|
|
xmlXPtrEvalRangePredicate (xmlXPathParserContextPtr ctxt);
|
|
#endif /* LIBXML_XPTR_LOCS_ENABLED */
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* LIBXML_XPTR_ENABLED */
|
|
#endif /* __XML_XPTR_H__ */
|