Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
Made with Libxml2 Logo

Module entities from libxml2

Main Menu
Related links

Table of Contents

xmlEntityPtr	xmlAddDocEntity	(xmlDocPtr doc, 
				 const xmlChar * name, 
				 int type, 
				 const xmlChar * ExternalID, 
				 const xmlChar * SystemID, 
				 const xmlChar * content)


xmlEntityPtr	xmlGetDtdEntity	(xmlDocPtr doc, 
				 const xmlChar * name)


xmlEntityPtr	xmlAddDtdEntity	(xmlDocPtr doc, 
				 const xmlChar * name, 
				 int type, 
				 const xmlChar * ExternalID, 
				 const xmlChar * SystemID, 
				 const xmlChar * content)


void	xmlFreeEntitiesTable	(xmlEntitiesTablePtr table)


Structure xmlEntitiesTable
struct _xmlHashTable {
The content of this structure is not made public by the API.
}

xmlChar *	xmlEncodeSpecialChars	(xmlDocPtr doc, 
				 const xmlChar * input)


xmlEntityPtr	xmlGetDocEntity	(xmlDocPtr doc, 
				 const xmlChar * name)


const xmlChar *	xmlEncodeEntities	(xmlDocPtr doc, 
				 const xmlChar * input)


xmlEntityPtr	xmlGetPredefinedEntity	(const xmlChar * name)


void	xmlInitializePredefinedEntities	(void)


Typedef xmlEntitiesTable * xmlEntitiesTablePtr


xmlChar *	xmlEncodeEntitiesReentrant	(xmlDocPtr doc, 
				 const xmlChar * input)


Enum xmlEntityType {
    XML_INTERNAL_GENERAL_ENTITY = 1
    XML_EXTERNAL_GENERAL_PARSED_ENTITY = 2
    XML_EXTERNAL_GENERAL_UNPARSED_ENTITY = 3
    XML_INTERNAL_PARAMETER_ENTITY = 4
    XML_EXTERNAL_PARAMETER_ENTITY = 5
    XML_INTERNAL_PREDEFINED_ENTITY = 6
}


xmlEntitiesTablePtr	xmlCopyEntitiesTable	(xmlEntitiesTablePtr table)


xmlEntityPtr	xmlGetParameterEntity	(xmlDocPtr doc, 
				 const xmlChar * name)


void	xmlDumpEntitiesTable	(xmlBufferPtr buf, 
				 xmlEntitiesTablePtr table)


void	xmlDumpEntityDecl	(xmlBufferPtr buf, 
				 xmlEntityPtr ent)


void	xmlCleanupPredefinedEntities	(void)


xmlEntitiesTablePtr	xmlCreateEntitiesTable	(void)

Description

Function: xmlAddDocEntity

xmlEntityPtr	xmlAddDocEntity	(xmlDocPtr doc, 
				 const xmlChar * name, 
				 int type, 
				 const xmlChar * ExternalID, 
				 const xmlChar * SystemID, 
				 const xmlChar * content)

Register a new entity for this document.

doc:the document
name:the entity name
type:the entity type XML_xxx_yyy_ENTITY
ExternalID:the entity external ID if available
SystemID:the entity system ID if available
content:the entity content
Returns:a pointer to the entity or NULL in case of error

Function: xmlGetDtdEntity

xmlEntityPtr	xmlGetDtdEntity	(xmlDocPtr doc, 
				 const xmlChar * name)

Do an entity lookup in the DTD entity hash table and

doc:the document referencing the entity
name:the entity name
Returns:the corresponding entity, if found. Note: the first argument is the document node, not the DTD node. Returns A pointer to the entity structure or NULL if not found.

Function: xmlAddDtdEntity

xmlEntityPtr	xmlAddDtdEntity	(xmlDocPtr doc, 
				 const xmlChar * name, 
				 int type, 
				 const xmlChar * ExternalID, 
				 const xmlChar * SystemID, 
				 const xmlChar * content)

Register a new entity for this document DTD external subset.

doc:the document
name:the entity name
type:the entity type XML_xxx_yyy_ENTITY
ExternalID:the entity external ID if available
SystemID:the entity system ID if available
content:the entity content
Returns:a pointer to the entity or NULL in case of error

Function: xmlFreeEntitiesTable

void	xmlFreeEntitiesTable	(xmlEntitiesTablePtr table)

Deallocate the memory used by an entities hash table.

table:An entity table

Function: xmlEncodeSpecialChars

xmlChar *	xmlEncodeSpecialChars	(xmlDocPtr doc, 
				 const xmlChar * input)

Do a global encoding of a string, replacing the predefined entities this routine is reentrant, and result must be deallocated.

doc:the document containing the string
input:A string to convert to XML.
Returns:A newly allocated string with the substitution done.

Function: xmlGetDocEntity

xmlEntityPtr	xmlGetDocEntity	(xmlDocPtr doc, 
				 const xmlChar * name)

Do an entity lookup in the document entity hash table and

doc:the document referencing the entity
name:the entity name
Returns:the corresponding entity, otherwise a lookup is done in the predefined entities too. Returns A pointer to the entity structure or NULL if not found.

Function: xmlEncodeEntities

const xmlChar *	xmlEncodeEntities	(xmlDocPtr doc, 
				 const xmlChar * input)

TODO: remove xmlEncodeEntities, once we are not afraid of breaking binary compatibility People must migrate their code to xmlEncodeEntitiesReentrant ! This routine will issue a warning when encountered.

doc:the document containing the string
input:A string to convert to XML.
Returns:NULL

Function: xmlGetPredefinedEntity

xmlEntityPtr	xmlGetPredefinedEntity	(const xmlChar * name)

Check whether this name is an predefined entity.

name:the entity name
Returns:NULL if not, otherwise the entity

Function: xmlInitializePredefinedEntities

void	xmlInitializePredefinedEntities	(void)

Set up the predefined entities. Deprecated call

Function: xmlEncodeEntitiesReentrant

xmlChar *	xmlEncodeEntitiesReentrant	(xmlDocPtr doc, 
				 const xmlChar * input)

Do a global encoding of a string, replacing the predefined entities and non ASCII values with their entities and CharRef counterparts. Contrary to xmlEncodeEntities, this routine is reentrant, and result must be deallocated.

doc:the document containing the string
input:A string to convert to XML.
Returns:A newly allocated string with the substitution done.

Function: xmlCopyEntitiesTable

xmlEntitiesTablePtr	xmlCopyEntitiesTable	(xmlEntitiesTablePtr table)

Build a copy of an entity table.

table:An entity table
Returns:the new xmlEntitiesTablePtr or NULL in case of error.

Function: xmlGetParameterEntity

xmlEntityPtr	xmlGetParameterEntity	(xmlDocPtr doc, 
				 const xmlChar * name)

Do an entity lookup in the internal and external subsets and

doc:the document referencing the entity
name:the entity name
Returns:the corresponding parameter entity, if found. Returns A pointer to the entity structure or NULL if not found.

Function: xmlDumpEntitiesTable

void	xmlDumpEntitiesTable	(xmlBufferPtr buf, 
				 xmlEntitiesTablePtr table)

This will dump the content of the entity table as an XML DTD definition

buf:An XML buffer.
table:An entity table

Function: xmlDumpEntityDecl

void	xmlDumpEntityDecl	(xmlBufferPtr buf, 
				 xmlEntityPtr ent)

This will dump the content of the entity table as an XML DTD definition

buf:An XML buffer.
ent:An entity table

Function: xmlCleanupPredefinedEntities

void	xmlCleanupPredefinedEntities	(void)

Cleanup up the predefined entities table. Deprecated call

Function: xmlCreateEntitiesTable

xmlEntitiesTablePtr	xmlCreateEntitiesTable	(void)

create and initialize an empty entities hash table.

Returns:the xmlEntitiesTablePtr just created or NULL in case of error.

Daniel Veillard