catalog: interfaces to the Catalog handling system

Linux 4gvps.4gvps.com 3.10.0-1127.18.2.vz7.163.46 #1 SMP Fri Nov 20 21:47:55 MSK 2020 x86_64
SOFT : Apache PHP : 7.4.33
/usr/share/gtk-doc/html/libxml2/

38.135.39.45

[ NAME ]	[ SIZE ]	[ PERM ]	[ DATE ]	[ ACT ]
+FILE +DIR
general.html	5.342 KB	-rw-r--r--	2025-05-08 14:26	R E G D
home.png	0.639 KB	-rw-r--r--	2025-05-08 14:26	R E G D
index.html	4.22 KB	-rw-r--r--	2025-05-08 14:26	R E G D
left.png	0.448 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-DOCBparser.html	16.954 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-HTMLparser.html	56.733 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-HTMLtree.html	23.844 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-SAX.html	37.964 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-SAX2.html	38.729 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-c14n.html	13.229 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-catalog.html	35.692 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-chvalid.html	19.37 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-debugXML.html	32.536 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-dict.html	13.264 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-encoding.html	28.823 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-entities.html	22.576 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-globals.html	34.807 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-hash.html	41.069 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-list.html	24.969 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-nanoftp.html	21.878 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-nanohttp.html	16.225 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-parser.html	134.272 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-parserInternals.html	122.419 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-pattern.html	18.908 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-relaxng.html	34.404 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-schemasInternals.html	63.593 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-schematron.html	16.704 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-threads.html	12.594 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-tree.html	228.823 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-uri.html	18.002 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-valid.html	96.195 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-xinclude.html	15.547 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-xlink.html	16.923 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-xmlIO.html	56.148 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-xmlautomata.html	34.354 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-xmlerror.html	82.727 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-xmlexports.html	3.501 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-xmlmemory.html	23.449 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-xmlmodule.html	7.197 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-xmlreader.html	105.56 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-xmlregexp.html	41.028 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-xmlsave.html	14.494 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-xmlschemas.html	41.524 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-xmlschemastypes.html	43.413 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-xmlstring.html	34.29 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-xmlunicode.html	104.098 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-xmlversion.html	18.58 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-xmlwriter.html	109.45 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-xpath.html	60.825 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-xpathInternals.html	141.517 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2-xpointer.html	24.856 KB	-rw-r--r--	2025-05-08 14:26	R E G D
libxml2.devhelp	335.142 KB	-rw-r--r--	2025-05-08 14:26	R E G D
right.png	0.461 KB	-rw-r--r--	2025-05-08 14:26	R E G D
style.css	0.801 KB	-rw-r--r--	2025-05-08 14:26	R E G D
up.png	0.396 KB	-rw-r--r--	2025-05-08 14:26	R E G D
REQUEST EXIT

#define XML_CATALOG_PI; #define XML_CATALOGS_NAMESPACE; typedef enum xmlCatalogAllow; typedef enum xmlCatalogPrefer; typedef struct _xmlCatalog xmlCatalog; typedef xmlCatalog * xmlCatalogPtr; void xmlFreeCatalog (xmlCatalogPtr catal); void xmlLoadCatalogs (const char * pathss); xmlChar * xmlCatalogLocalResolve (void * catalogs,
const xmlChar * pubID,
const xmlChar * sysID); int xmlACatalogAdd (xmlCatalogPtr catal,
const xmlChar * type,
const xmlChar * orig,
const xmlChar * replace); xmlChar * xmlACatalogResolvePublic (xmlCatalogPtr catal,
const xmlChar * pubID); xmlCatalogAllow xmlCatalogGetDefaults (void); int xmlACatalogRemove (xmlCatalogPtr catal,
const xmlChar * value); xmlCatalogPrefer xmlCatalogSetDefaultPrefer (xmlCatalogPrefer prefer); xmlChar * xmlACatalogResolveURI (xmlCatalogPtr catal,
const xmlChar * URI); int xmlCatalogAdd (const xmlChar * type,
const xmlChar * orig,
const xmlChar * replace); xmlChar * xmlCatalogResolvePublic (const xmlChar * pubID); const xmlChar * xmlCatalogGetSystem (const xmlChar * sysID); void xmlInitializeCatalog (void); int xmlLoadCatalog (const char * filename); int xmlCatalogRemove (const xmlChar * value); int xmlCatalogIsEmpty (xmlCatalogPtr catal); void xmlACatalogDump (xmlCatalogPtr catal,
FILE * out); void xmlCatalogFreeLocal (void * catalogs); xmlChar * xmlACatalogResolve (xmlCatalogPtr catal,
const xmlChar * pubID,
const xmlChar * sysID); xmlChar * xmlCatalogResolveSystem (const xmlChar * sysID); xmlCatalogPtr xmlLoadSGMLSuperCatalog (const char * filename); int xmlCatalogConvert (void); const xmlChar * xmlCatalogGetPublic (const xmlChar * pubID); xmlCatalogPtr xmlLoadACatalog (const char * filename); xmlChar * xmlACatalogResolveSystem (xmlCatalogPtr catal,
const xmlChar * sysID); xmlChar * xmlCatalogLocalResolveURI (void * catalogs,
const xmlChar * URI); int xmlConvertSGMLCatalog (xmlCatalogPtr catal); void * xmlCatalogAddLocal (void * catalogs,
const xmlChar * URL); xmlCatalogPtr xmlNewCatalog (int sgml); xmlDocPtr xmlParseCatalogFile (const char * filename); int xmlCatalogSetDebug (int level); xmlChar * xmlCatalogResolve (const xmlChar * pubID,
const xmlChar * sysID); void xmlCatalogSetDefaults (xmlCatalogAllow allow); void xmlCatalogDump (FILE * out); void xmlCatalogCleanup (void); xmlChar * xmlCatalogResolveURI (const xmlChar * URI);

Details

Macro XML_CATALOGS_NAMESPACE

#define XML_CATALOGS_NAMESPACE;

The namespace for the XML Catalogs elements.

Macro XML_CATALOG_PI

#define XML_CATALOG_PI;

The specific XML Catalog Processing Instuction name.

Structure xmlCatalog

struct _xmlCatalog {
The content of this structure is not made public by the API.
} xmlCatalog;

Enum xmlCatalogAllow

enum xmlCatalogAllow {
    XML_CATA_ALLOW_NONE = 0
    XML_CATA_ALLOW_GLOBAL = 1
    XML_CATA_ALLOW_DOCUMENT = 2
    XML_CATA_ALLOW_ALL = 3
};

Enum xmlCatalogPrefer

enum xmlCatalogPrefer {
    XML_CATA_PREFER_NONE = 0
    XML_CATA_PREFER_PUBLIC = 1
    XML_CATA_PREFER_SYSTEM = 2
};

Typedef xmlCatalogPtr

xmlCatalog * xmlCatalogPtr;

xmlACatalogAdd ()

int	xmlACatalogAdd			(xmlCatalogPtr catal, 
					 const xmlChar * type, 
					 const xmlChar * orig, 
					 const xmlChar * replace)

Add an entry in the catalog, it may overwrite existing but different entries.

`catal`:	a Catalog
`type`:	the type of record to add to the catalog
`orig`:	the system, public or prefix to match
`replace`:	the replacement value for the match
`Returns`:	0 if successful, -1 otherwise

xmlACatalogDump ()

void	xmlACatalogDump			(xmlCatalogPtr catal, 
					 FILE * out)

Dump the given catalog to the given file.

`catal`:	a Catalog
`out`:	the file.

xmlACatalogRemove ()

int	xmlACatalogRemove		(xmlCatalogPtr catal, 
					 const xmlChar * value)

Remove an entry from the catalog

`catal`:	a Catalog
`value`:	the value to remove
`Returns`:	the number of entries removed if successful, -1 otherwise

xmlACatalogResolve ()

xmlChar *	xmlACatalogResolve	(xmlCatalogPtr catal, 
					 const xmlChar * pubID, 
					 const xmlChar * sysID)

Do a complete resolution lookup of an External Identifier

`catal`:	a Catalog
`pubID`:	the public ID string
`sysID`:	the system ID string
`Returns`:	the URI of the resource or NULL if not found, it must be freed by the caller.

xmlACatalogResolvePublic ()

xmlChar *	xmlACatalogResolvePublic	(xmlCatalogPtr catal, 
						 const xmlChar * pubID)

Try to lookup the catalog local reference associated to a public ID in that catalog

`catal`:	a Catalog
`pubID`:	the public ID string
`Returns`:	the local resource if found or NULL otherwise, the value returned must be freed by the caller.

xmlACatalogResolveSystem ()

xmlChar *	xmlACatalogResolveSystem	(xmlCatalogPtr catal, 
						 const xmlChar * sysID)

Try to lookup the catalog resource for a system ID

`catal`:	a Catalog
`sysID`:	the system ID string
`Returns`:	the resource if found or NULL otherwise, the value returned must be freed by the caller.

xmlACatalogResolveURI ()

xmlChar *	xmlACatalogResolveURI	(xmlCatalogPtr catal, 
					 const xmlChar * URI)

Do a complete resolution lookup of an URI

`catal`:	a Catalog
`URI`:	the URI
`Returns`:	the URI of the resource or NULL if not found, it must be freed by the caller.

xmlCatalogAdd ()

int	xmlCatalogAdd			(const xmlChar * type, 
					 const xmlChar * orig, 
					 const xmlChar * replace)

Add an entry in the catalog, it may overwrite existing but different entries. If called before any other catalog routine, allows to override the default shared catalog put in place by xmlInitializeCatalog();

`type`:	the type of record to add to the catalog
`orig`:	the system, public or prefix to match
`replace`:	the replacement value for the match
`Returns`:	0 if successful, -1 otherwise

xmlCatalogAddLocal ()

void *	xmlCatalogAddLocal		(void * catalogs, 
					 const xmlChar * URL)

Add the new entry to the catalog list

`catalogs`:	a document's list of catalogs
`URL`:	the URL to a new local catalog
`Returns`:	the updated list

xmlCatalogCleanup ()

void	xmlCatalogCleanup		(void)

Free up all the memory associated with catalogs

xmlCatalogConvert ()

int	xmlCatalogConvert		(void)

Convert all the SGML catalog entries as XML ones

Returns: the number of entries converted if successful, -1 otherwise

xmlCatalogDump ()

void	xmlCatalogDump			(FILE * out)

Dump all the global catalog content to the given file.

out: the file.

xmlCatalogFreeLocal ()

void	xmlCatalogFreeLocal		(void * catalogs)

Free up the memory associated to the catalog list

catalogs: a document's list of catalogs

xmlCatalogGetDefaults ()

xmlCatalogAllow	xmlCatalogGetDefaults	(void)

Used to get the user preference w.r.t. to what catalogs should be accepted

Returns: the current xmlCatalogAllow value

xmlCatalogGetPublic ()

const xmlChar *	xmlCatalogGetPublic	(const xmlChar * pubID)

Try to lookup the catalog reference associated to a public ID DEPRECATED, use xmlCatalogResolvePublic()

`pubID`:	the public ID string
`Returns`:	the resource if found or NULL otherwise.

xmlCatalogGetSystem ()

const xmlChar *	xmlCatalogGetSystem	(const xmlChar * sysID)

Try to lookup the catalog reference associated to a system ID DEPRECATED, use xmlCatalogResolveSystem()

`sysID`:	the system ID string
`Returns`:	the resource if found or NULL otherwise.

xmlCatalogIsEmpty ()

int	xmlCatalogIsEmpty		(xmlCatalogPtr catal)

Check is a catalog is empty

`catal`:	should this create an SGML catalog
`Returns`:	1 if the catalog is empty, 0 if not, amd -1 in case of error.

xmlCatalogLocalResolve ()

xmlChar *	xmlCatalogLocalResolve	(void * catalogs, 
					 const xmlChar * pubID, 
					 const xmlChar * sysID)

Do a complete resolution lookup of an External Identifier using a document's private catalog list

`catalogs`:	a document's list of catalogs
`pubID`:	the public ID string
`sysID`:	the system ID string
`Returns`:	the URI of the resource or NULL if not found, it must be freed by the caller.

xmlCatalogLocalResolveURI ()

xmlChar *	xmlCatalogLocalResolveURI	(void * catalogs, 
						 const xmlChar * URI)

Do a complete resolution lookup of an URI using a document's private catalog list

`catalogs`:	a document's list of catalogs
`URI`:	the URI
`Returns`:	the URI of the resource or NULL if not found, it must be freed by the caller.

xmlCatalogRemove ()

int	xmlCatalogRemove		(const xmlChar * value)

Remove an entry from the catalog

`value`:	the value to remove
`Returns`:	the number of entries removed if successful, -1 otherwise

xmlCatalogResolve ()

xmlChar *	xmlCatalogResolve	(const xmlChar * pubID, 
					 const xmlChar * sysID)

Do a complete resolution lookup of an External Identifier

`pubID`:	the public ID string
`sysID`:	the system ID string
`Returns`:	the URI of the resource or NULL if not found, it must be freed by the caller.

xmlCatalogResolvePublic ()

xmlChar *	xmlCatalogResolvePublic	(const xmlChar * pubID)

Try to lookup the catalog reference associated to a public ID

`pubID`:	the public ID string
`Returns`:	the resource if found or NULL otherwise, the value returned must be freed by the caller.

xmlCatalogResolveSystem ()

xmlChar *	xmlCatalogResolveSystem	(const xmlChar * sysID)

Try to lookup the catalog resource for a system ID

`sysID`:	the system ID string
`Returns`:	the resource if found or NULL otherwise, the value returned must be freed by the caller.

xmlCatalogResolveURI ()

xmlChar *	xmlCatalogResolveURI	(const xmlChar * URI)

Do a complete resolution lookup of an URI

`URI`:	the URI
`Returns`:	the URI of the resource or NULL if not found, it must be freed by the caller.

xmlCatalogSetDebug ()

int	xmlCatalogSetDebug		(int level)

Used to set the debug level for catalog operation, 0 disable debugging, 1 enable it

`level`:	the debug level of catalogs required
`Returns`:	the previous value of the catalog debugging level

xmlCatalogSetDefaultPrefer ()

xmlCatalogPrefer	xmlCatalogSetDefaultPrefer	(xmlCatalogPrefer prefer)

Allows to set the preference between public and system for deletion in XML Catalog resolution. C.f. section 4.1.1 of the spec Values accepted are XML_CATA_PREFER_PUBLIC or XML_CATA_PREFER_SYSTEM

`prefer`:	the default preference for delegation
`Returns`:	the previous value of the default preference for delegation

xmlCatalogSetDefaults ()

void	xmlCatalogSetDefaults		(xmlCatalogAllow allow)

Used to set the user preference w.r.t. to what catalogs should be accepted

allow: what catalogs should be accepted

xmlConvertSGMLCatalog ()

int	xmlConvertSGMLCatalog		(xmlCatalogPtr catal)

Convert all the SGML catalog entries as XML ones

`catal`:	the catalog
`Returns`:	the number of entries converted if successful, -1 otherwise

xmlFreeCatalog ()

void	xmlFreeCatalog			(xmlCatalogPtr catal)

Free the memory allocated to a Catalog

catal: a Catalog

xmlInitializeCatalog ()

void	xmlInitializeCatalog		(void)

Do the catalog initialization. this function is not thread safe, catalog initialization should preferably be done once at startup

xmlLoadACatalog ()

xmlCatalogPtr	xmlLoadACatalog		(const char * filename)

Load the catalog and build the associated data structures. This can be either an XML Catalog or an SGML Catalog It will recurse in SGML CATALOG entries. On the other hand XML Catalogs are not handled recursively.

`filename`:	a file path
`Returns`:	the catalog parsed or NULL in case of error

xmlLoadCatalog ()

int	xmlLoadCatalog			(const char * filename)

Load the catalog and makes its definitions effective for the default external entity loader. It will recurse in SGML CATALOG entries. this function is not thread safe, catalog initialization should preferably be done once at startup

`filename`:	a file path
`Returns`:	0 in case of success -1 in case of error

xmlLoadCatalogs ()

void	xmlLoadCatalogs			(const char * pathss)

Load the catalogs and makes their definitions effective for the default external entity loader. this function is not thread safe, catalog initialization should preferably be done once at startup

pathss: a list of directories separated by a colon or a space.

xmlLoadSGMLSuperCatalog ()

xmlCatalogPtr	xmlLoadSGMLSuperCatalog	(const char * filename)

Load an SGML super catalog. It won't expand CATALOG or DELEGATE references. This is only needed for manipulating SGML Super Catalogs like adding and removing CATALOG or DELEGATE entries.

`filename`:	a file path
`Returns`:	the catalog parsed or NULL in case of error

xmlNewCatalog ()

xmlCatalogPtr	xmlNewCatalog		(int sgml)

create a new Catalog.

`sgml`:	should this create an SGML catalog
`Returns`:	the xmlCatalogPtr or NULL in case of error

xmlParseCatalogFile ()

xmlDocPtr	xmlParseCatalogFile	(const char * filename)

parse an XML file and build a tree. It's like xmlParseFile() except it bypass all catalog lookups.

`filename`:	the filename
`Returns`:	the resulting document tree or NULL in case of error

catalog

Synopsis