xmltree: XML Security Library Reference Manual

xmltree

xmltree — XML tree functions.

Stability Level

Stable, unless otherwise indicated

Functions

#define	xmlSecNodeGetName()
const xmlChar *	xmlSecGetDefaultLineFeed ()
void	xmlSecSetDefaultLineFeed ()
const xmlChar *	xmlSecGetNodeNsHref ()
xmlChar *	xmlSecGetNodeContentAndTrim ()
int	xmlSecGetNodeContentAsSize ()
int	xmlSecCheckNodeName ()
xmlNodePtr	xmlSecGetNextElementNode ()
xmlNodePtr	xmlSecFindSibling ()
xmlNodePtr	xmlSecFindChild ()
xmlNodePtr	xmlSecFindParent ()
xmlNodePtr	xmlSecFindNode ()
xmlNodePtr	xmlSecAddChild ()
xmlNodePtr	xmlSecEnsureEmptyChild ()
xmlNodePtr	xmlSecAddChildNode ()
xmlNodePtr	xmlSecAddNextSibling ()
xmlNodePtr	xmlSecAddPrevSibling ()
int	xmlSecReplaceNode ()
int	xmlSecReplaceNodeAndReturn ()
int	xmlSecReplaceContent ()
int	xmlSecReplaceContentAndReturn ()
int	xmlSecReplaceNodeBuffer ()
int	xmlSecReplaceNodeBufferAndReturn ()
int	xmlSecNodeEncodeAndSetContent ()
void	xmlSecAddIDs ()
xmlDocPtr	xmlSecCreateTree ()
int	xmlSecIsEmptyNode ()
int	xmlSecIsEmptyString ()
xmlChar *	xmlSecGetQName ()
int	xmlSecPrintXmlString ()
#define	xmlSecIsHex()
#define	xmlSecGetHex()
#define	xmlSecFromHex()
#define	xmlSecFromHex2()
#define	xmlSecToHex()
xmlSecQName2IntegerInfoConstPtr	xmlSecQName2IntegerGetInfo ()
int	xmlSecQName2IntegerGetInteger ()
int	xmlSecQName2IntegerGetIntegerFromString ()
xmlChar *	xmlSecQName2IntegerGetStringFromInteger ()
int	xmlSecQName2IntegerNodeRead ()
int	xmlSecQName2IntegerNodeWrite ()
int	xmlSecQName2IntegerAttributeRead ()
int	xmlSecQName2IntegerAttributeWrite ()
void	xmlSecQName2IntegerDebugDump ()
void	xmlSecQName2IntegerDebugXmlDump ()
xmlSecQName2BitMaskInfoConstPtr	xmlSecQName2BitMaskGetInfo ()
int	xmlSecQName2BitMaskGetBitMask ()
int	xmlSecQName2BitMaskNodesRead ()
int	xmlSecQName2BitMaskGetBitMaskFromString ()
xmlChar *	xmlSecQName2BitMaskGetStringFromBitMask ()
int	xmlSecQName2BitMaskNodesWrite ()
void	xmlSecQName2BitMaskDebugDump ()
void	xmlSecQName2BitMaskDebugXmlDump ()
LPWSTR	xmlSecWin32ConvertLocaleToUnicode ()
LPWSTR	xmlSecWin32ConvertUtf8ToUnicode ()
xmlChar *	xmlSecWin32ConvertUnicodeToUtf8 ()
xmlChar *	xmlSecWin32ConvertLocaleToUtf8 ()
char *	xmlSecWin32ConvertUtf8ToLocale ()
xmlChar *	xmlSecWin32ConvertTstrToUtf8 ()
LPTSTR	xmlSecWin32ConvertUtf8ToTstr ()

Types and Values

struct	xmlSecQName2IntegerInfo
typedef	xmlSecQName2IntegerInfoConstPtr
typedef	xmlSecBitMask
struct	xmlSecQName2BitMaskInfo
typedef	xmlSecQName2BitMaskInfoConstPtr

Description

Functions

xmlSecNodeGetName()

#define             xmlSecNodeGetName(node)

Macro. Returns node's name.

Parameters

node

the pointer to node.

xmlSecGetDefaultLineFeed ()

const xmlChar *
xmlSecGetDefaultLineFeed (void);

Gets the current default linefeed.

Returns

the current default linefeed.

xmlSecSetDefaultLineFeed ()

void
xmlSecSetDefaultLineFeed (const xmlChar *linefeed);

Sets the current default linefeed. The caller must ensure that the linefeed string exists for the lifetime of the program or until the new linefeed is set.

Parameters

linefeed

default linefeed.

xmlSecGetNodeNsHref ()

const xmlChar *
xmlSecGetNodeNsHref (const xmlNodePtr cur);

Get's node's namespace href.

Parameters

cur

the pointer to node.

Returns

node's namespace href.

xmlSecGetNodeContentAndTrim ()

xmlChar *
xmlSecGetNodeContentAndTrim (const xmlNodePtr cur);

Reads cur node content and trims it (both sides).

Parameters

cur

the pointer to XML node.

Returns

trimmed node content or NULL if an error occurs.

xmlSecGetNodeContentAsSize ()

int
xmlSecGetNodeContentAsSize (const xmlNodePtr cur,
                            xmlSecSize defValue,
                            xmlSecSize *res);

Reads cur node content and converts it to xmlSecSize value.

Parameters

cur	the pointer to XML node.
defValue	the default value that will be returned in `res` if there is no node content.
res	the pointer to the result value.

Returns

0 on success or -1 on error.

xmlSecCheckNodeName ()

int
xmlSecCheckNodeName (const xmlNodePtr cur,
                     const xmlChar *name,
                     const xmlChar *ns);

Checks that the node has a given name and a given namespace href.

Parameters

cur	the pointer to an XML node.
name	the name,
ns	the namespace href.

Returns

1 if the node matches or 0 otherwise.

xmlSecGetNextElementNode ()

xmlNodePtr
xmlSecGetNextElementNode (xmlNodePtr cur);

Seraches for the next element node.

Parameters

cur

the pointer to an XML node.

Returns

the pointer to next element node or NULL if it is not found.

xmlSecFindSibling ()

xmlNodePtr
xmlSecFindSibling (const xmlNodePtr cur,
                   const xmlChar *name,
                   const xmlChar *ns);

Searches cur and the next siblings of the cur node having given name and namespace href.

Parameters

cur	the pointer to XML node.
name	the name.
ns	the namespace href (may be NULL).

Returns

the pointer to the found node or NULL if an error occurs or node is not found.

xmlSecFindChild ()

xmlNodePtr
xmlSecFindChild (const xmlNodePtr parent,
                 const xmlChar *name,
                 const xmlChar *ns);

Searches a direct child of the parent node having given name and namespace href.

Parameters

parent	the pointer to XML node.
name	the name.
ns	the namespace href (may be NULL).

Returns

the pointer to the found node or NULL if an error occurs or node is not found.

xmlSecFindParent ()

xmlNodePtr
xmlSecFindParent (const xmlNodePtr cur,
                  const xmlChar *name,
                  const xmlChar *ns);

Searches the ancestors axis of the cur node for a node having given name and namespace href.

Parameters

cur	the pointer to an XML node.
name	the name.
ns	the namespace href (may be NULL).

Returns

the pointer to the found node or NULL if an error occurs or node is not found.

xmlSecFindNode ()

xmlNodePtr
xmlSecFindNode (const xmlNodePtr parent,
                const xmlChar *name,
                const xmlChar *ns);

Searches all children of the parent node having given name and namespace href.

Parameters

parent	the pointer to XML node.
name	the name.
ns	the namespace href (may be NULL).

Returns

the pointer to the found node or NULL if an error occurs or node is not found.

xmlSecAddChild ()

xmlNodePtr
xmlSecAddChild (xmlNodePtr parent,
                const xmlChar *name,
                const xmlChar *ns);

Adds a child to the node parent with given name and namespace ns .

Parameters

parent	the pointer to an XML node.
name	the new node name.
ns	the new node namespace.

Returns

pointer to the new node or NULL if an error occurs.

xmlSecEnsureEmptyChild ()

xmlNodePtr
xmlSecEnsureEmptyChild (xmlNodePtr parent,
                        const xmlChar *name,
                        const xmlChar *ns);

Searches a direct child of the parent node having given name and namespace href. If not found then element node with given name / namespace is added.

Parameters

parent	the pointer to XML node.
name	the name.
ns	the namespace href (may be NULL).

Returns

the pointer to the found or created node; or NULL if an error occurs.

xmlSecAddChildNode ()

xmlNodePtr
xmlSecAddChildNode (xmlNodePtr parent,
                    xmlNodePtr child);

Adds child node to the parent node.

Parameters

parent	the pointer to an XML node.
child	the new node.

Returns

pointer to the new node or NULL if an error occurs.

xmlSecAddNextSibling ()

xmlNodePtr
xmlSecAddNextSibling (xmlNodePtr node,
                      const xmlChar *name,
                      const xmlChar *ns);

Adds next sibling to the node node with given name and namespace ns .

Parameters

node	the pointer to an XML node.
name	the new node name.
ns	the new node namespace.

Returns

pointer to the new node or NULL if an error occurs.

xmlSecAddPrevSibling ()

xmlNodePtr
xmlSecAddPrevSibling (xmlNodePtr node,
                      const xmlChar *name,
                      const xmlChar *ns);

Adds prev sibling to the node node with given name and namespace ns .

Parameters

node	the pointer to an XML node.
name	the new node name.
ns	the new node namespace.

Returns

pointer to the new node or NULL if an error occurs.

xmlSecReplaceNode ()

int
xmlSecReplaceNode (xmlNodePtr node,
                   xmlNodePtr newNode);

Swaps the node and newNode in the XML tree.

Parameters

node	the current node.
newNode	the new node.

Returns

0 on success or a negative value if an error occurs.

xmlSecReplaceNodeAndReturn ()

int
xmlSecReplaceNodeAndReturn (xmlNodePtr node,
                            xmlNodePtr newNode,
                            xmlNodePtr *replaced);

Swaps the node and newNode in the XML tree.

Parameters

node	the current node.
newNode	the new node.
replaced	the replaced node, or release it if NULL is given

Returns

0 on success or a negative value if an error occurs.

xmlSecReplaceContent ()

int
xmlSecReplaceContent (xmlNodePtr node,
                      xmlNodePtr newNode);

Swaps the content of node and newNode .

Parameters

node	the current node.
newNode	the new node.

Returns

0 on success or a negative value if an error occurs.

xmlSecReplaceContentAndReturn ()

int
xmlSecReplaceContentAndReturn (xmlNodePtr node,
                               xmlNodePtr newNode,
                               xmlNodePtr *replaced);

Swaps the content of node and newNode .

Parameters

node	the current node.
newNode	the new node.
replaced	the replaced nodes, or release them if NULL is given

Returns

0 on success or a negative value if an error occurs.

xmlSecReplaceNodeBuffer ()

int
xmlSecReplaceNodeBuffer (xmlNodePtr node,
                         const xmlSecByte *buffer,
                         xmlSecSize size);

Swaps the node and the parsed XML data from the buffer in the XML tree.

Parameters

node	the current node.
buffer	the XML data.
size	the XML data size.

Returns

0 on success or a negative value if an error occurs.

xmlSecReplaceNodeBufferAndReturn ()

int
xmlSecReplaceNodeBufferAndReturn (xmlNodePtr node,
                                  const xmlSecByte *buffer,
                                  xmlSecSize size,
                                  xmlNodePtr *replaced);

Swaps the node and the parsed XML data from the buffer in the XML tree.

Parameters

node	the current node.
buffer	the XML data.
size	the XML data size.
replaced	the replaced nodes, or release them if NULL is given

Returns

0 on success or a negative value if an error occurs.

xmlSecNodeEncodeAndSetContent ()

int
xmlSecNodeEncodeAndSetContent (xmlNodePtr node,
                               const xmlChar *buffer);

Encodes "special" characters in the buffer and sets the result as the node content.

Parameters

node	the pointer to an XML node.
buffer	the pointer to the node content.

Returns

0 on success or a negative value if an error occurs.

xmlSecAddIDs ()

void
xmlSecAddIDs (xmlDocPtr doc,
              xmlNodePtr cur,
              const xmlChar **ids);

Walks thru all children of the cur node and adds all attributes from the ids list to the doc document IDs attributes hash.

Parameters

doc	the pointer to an XML document.
cur	the pointer to an XML node.
ids	the pointer to a NULL terminated list of ID attributes.

xmlSecCreateTree ()

xmlDocPtr
xmlSecCreateTree (const xmlChar *rootNodeName,
                  const xmlChar *rootNodeNs);

Creates a new XML tree with one root node rootNodeName .

Parameters

rootNodeName	the root node name.
rootNodeNs	the root node namespace (optional).

Returns

pointer to the newly created tree or NULL if an error occurs.

xmlSecIsEmptyNode ()

int
xmlSecIsEmptyNode (xmlNodePtr node);

Checks whether the node is empty (i.e. has only whitespaces children).

Parameters

node

the node to check

Returns

1 if node is empty, 0 otherwise or a negative value if an error occurs.

xmlSecIsEmptyString ()

int
xmlSecIsEmptyString (const xmlChar *str);

Checks whether the str is empty (i.e. has only whitespaces children).

Parameters

str

the string to check

Returns

1 if str is empty, 0 otherwise or a negative value if an error occurs.

xmlSecGetQName ()

xmlChar *
xmlSecGetQName (xmlNodePtr node,
                const xmlChar *href,
                const xmlChar *local);

Creates QName (prefix:local) from href and local in the context of the node . Caller is responsible for freeing returned string with xmlFree.

Parameters

node	the context node.
href	the QName href (can be NULL).
local	the QName local part.

Returns

qname or NULL if an error occurs.

xmlSecPrintXmlString ()

int
xmlSecPrintXmlString (FILE *fd,
                      const xmlChar *str);

Encodes the str (e.g. replaces '&' with '&') and writes it to fd .

Parameters

fd	the file descriptor to write the XML string to
str	the string

Returns

he number of bytes transmitted or a negative value if an error occurs.

xmlSecIsHex()

#define             xmlSecIsHex(c)

Macro. Returns 1 if c is a hex digit or 0 other wise.

Parameters

the character.

xmlSecGetHex()

#define xmlSecGetHex(ch)         xmlSecFromHex(ch)

Deprecated. Macro. Returns the hex value of the ch .

Parameters

the character,

xmlSecFromHex()

#define             xmlSecFromHex(ch)

Macro. Returns the hex value of the ch .

Parameters

the character,

xmlSecFromHex2()

#define xmlSecFromHex2(ch1, ch2)   ((xmlSecByte)((xmlSecFromHex(ch1) << 4) | (xmlSecFromHex(ch2))))

Macro. Returns the hex value of the pair (c1 c2 ).

Parameters

ch1	the first character,
ch2	the second character,

xmlSecToHex()

#define             xmlSecToHex(vv)

Macro. Returns the hex character of the vv .

Parameters

the value,

xmlSecQName2IntegerGetInfo ()

xmlSecQName2IntegerInfoConstPtr
xmlSecQName2IntegerGetInfo (xmlSecQName2IntegerInfoConstPtr info,
                            int intValue);

Maps integer intValue to a QName prefix.

Parameters

info	the qname<->integer mapping information.
intValue	the integer value.

Returns

the QName info that is mapped to intValue or NULL if such value is not found.

xmlSecQName2IntegerGetInteger ()

int
xmlSecQName2IntegerGetInteger (xmlSecQName2IntegerInfoConstPtr info,
                               const xmlChar *qnameHref,
                               const xmlChar *qnameLocalPart,
                               int *intValue);

Maps qname qname to an integer and returns it in intValue .

Parameters

info	the qname<->integer mapping information.
qnameHref	the qname href value.
qnameLocalPart	the qname local part value.
intValue	the pointer to result integer value.

Returns

0 on success or a negative value if an error occurs,

xmlSecQName2IntegerGetIntegerFromString ()

int
xmlSecQName2IntegerGetIntegerFromString
                               (xmlSecQName2IntegerInfoConstPtr info,
                                xmlNodePtr node,
                                const xmlChar *qname,
                                int *intValue);

Converts qname into integer in context of node .

Parameters

info	the qname<->integer mapping information.
node	the pointer to node.
qname	the qname string.
intValue	the pointer to result integer value.

Returns

0 on success or a negative value if an error occurs,

xmlSecQName2IntegerGetStringFromInteger ()

xmlChar *
xmlSecQName2IntegerGetStringFromInteger
                               (xmlSecQName2IntegerInfoConstPtr info,
                                xmlNodePtr node,
                                int intValue);

Creates qname string for intValue in context of given node . Caller is responsible for freeing returned string with xmlFree .

Parameters

info	the qname<->integer mapping information.
node	the pointer to node.
intValue	the integer value.

Returns

pointer to newly allocated string on success or NULL if an error occurs,

xmlSecQName2IntegerNodeRead ()

int
xmlSecQName2IntegerNodeRead (xmlSecQName2IntegerInfoConstPtr info,
                             xmlNodePtr node,
                             int *intValue);

Reads the content of node and converts it to an integer using mapping from info .

Parameters

info	the qname<->integer mapping information.
node	the pointer to node.
intValue	the pointer to result integer value.

Returns

0 on success or a negative value if an error occurs,

xmlSecQName2IntegerNodeWrite ()

int
xmlSecQName2IntegerNodeWrite (xmlSecQName2IntegerInfoConstPtr info,
                              xmlNodePtr node,
                              const xmlChar *nodeName,
                              const xmlChar *nodeNs,
                              int intValue);

Creates new child node in node and sets its value to intValue .

Parameters

info	the qname<->integer mapping information.
node	the parent node.
nodeName	the child node name.
nodeNs	the child node namespace.
intValue	the integer value.

Returns

0 on success or a negative value if an error occurs,

xmlSecQName2IntegerAttributeRead ()

int
xmlSecQName2IntegerAttributeRead (xmlSecQName2IntegerInfoConstPtr info,
                                  xmlNodePtr node,
                                  const xmlChar *attrName,
                                  int *intValue);

Gets the value of attrName atrtibute from node and converts it to integer according to info .

Parameters

info	the qname<->integer mapping information.
node	the element node.
attrName	the attribute name.
intValue	the pointer to result integer value.

Returns

0 on success or a negative value if an error occurs,

xmlSecQName2IntegerAttributeWrite ()

int
xmlSecQName2IntegerAttributeWrite (xmlSecQName2IntegerInfoConstPtr info,
                                   xmlNodePtr node,
                                   const xmlChar *attrName,
                                   int intValue);

Converts intValue to a qname and sets it to the value of attribute attrName in node .

Parameters

info	the qname<->integer mapping information.
node	the parent node.
attrName	the name of attribute.
intValue	the integer value.

Returns

0 on success or a negative value if an error occurs,

xmlSecQName2IntegerDebugDump ()

void
xmlSecQName2IntegerDebugDump (xmlSecQName2IntegerInfoConstPtr info,
                              int intValue,
                              const xmlChar *name,
                              FILE *output);

Prints intValue into output .

Parameters

info	the qname<->integer mapping information.
intValue	the integer value.
name	the value name to print.
output	the pointer to output FILE.

xmlSecQName2IntegerDebugXmlDump ()

void
xmlSecQName2IntegerDebugXmlDump (xmlSecQName2IntegerInfoConstPtr info,
                                 int intValue,
                                 const xmlChar *name,
                                 FILE *output);

Prints intValue into output in XML format.

Parameters

info	the qname<->integer mapping information.
intValue	the integer value.
name	the value name to print.
output	the pointer to output FILE.

xmlSecQName2BitMaskGetInfo ()

xmlSecQName2BitMaskInfoConstPtr
xmlSecQName2BitMaskGetInfo (xmlSecQName2BitMaskInfoConstPtr info,
                            xmlSecBitMask mask);

Converts mask to qname.

Parameters

info	the qname<->bit mask mapping information.
mask	the bit mask.

Returns

pointer to the qname info for mask or NULL if mask is unknown.

xmlSecQName2BitMaskGetBitMask ()

int
xmlSecQName2BitMaskGetBitMask (xmlSecQName2BitMaskInfoConstPtr info,
                               const xmlChar *qnameLocalPart,
                               const xmlChar *qnameHref,
                               xmlSecBitMask *mask);

Converts qnameLocalPart to mask .

Parameters

info	the qname<->bit mask mapping information.
qnameHref	the qname Href value.
qnameLocalPart	the qname LocalPart value.
mask	the pointer to result mask.

Returns

0 on success or a negative value if an error occurs,

xmlSecQName2BitMaskNodesRead ()

int
xmlSecQName2BitMaskNodesRead (xmlSecQName2BitMaskInfoConstPtr info,
                              xmlNodePtr *node,
                              const xmlChar *nodeName,
                              const xmlChar *nodeNs,
                              int stopOnUnknown,
                              xmlSecBitMask *mask);

Reads <nodeNs :nodeName > elements and puts the result bit mask into mask . When function exits, node points to the first element node after all the <nodeNs :nodeName > elements.

Parameters

info	the qname<->bit mask mapping information.
node	the start.
nodeName	the mask nodes name.
nodeNs	the mask nodes namespace.
stopOnUnknown	if this flag is set then function exits if unknown value was found.
mask	the pointer to result mask.

Returns

0 on success or a negative value if an error occurs,

xmlSecQName2BitMaskGetBitMaskFromString ()

int
xmlSecQName2BitMaskGetBitMaskFromString
                               (xmlSecQName2BitMaskInfoConstPtr info,
                                xmlNodePtr node,
                                const xmlChar *qname,
                                xmlSecBitMask *mask);

Converts qname into integer in context of node .

Parameters

info	the qname<->integer mapping information.
node	the pointer to node.
qname	the qname string.
mask	the pointer to result msk value.

Returns

0 on success or a negative value if an error occurs,

xmlSecQName2BitMaskGetStringFromBitMask ()

xmlChar *
xmlSecQName2BitMaskGetStringFromBitMask
                               (xmlSecQName2BitMaskInfoConstPtr info,
                                xmlNodePtr node,
                                xmlSecBitMask mask);

Creates qname string for mask in context of given node . Caller is responsible for freeing returned string with xmlFree .

Parameters

info	the qname<->integer mapping information.
node	the pointer to node.
mask	the mask.

Returns

pointer to newly allocated string on success or NULL if an error occurs,

xmlSecQName2BitMaskNodesWrite ()

int
xmlSecQName2BitMaskNodesWrite (xmlSecQName2BitMaskInfoConstPtr info,
                               xmlNodePtr node,
                               const xmlChar *nodeName,
                               const xmlChar *nodeNs,
                               xmlSecBitMask mask);

Writes <nodeNs :nodeName > elemnts with values from mask to node .

Parameters

info	the qname<->bit mask mapping information.
node	the parent element for mask nodes.
nodeName	the mask nodes name.
nodeNs	the mask nodes namespace.
mask	the bit mask.

Returns

0 on success or a negative value if an error occurs,

xmlSecQName2BitMaskDebugDump ()

void
xmlSecQName2BitMaskDebugDump (xmlSecQName2BitMaskInfoConstPtr info,
                              xmlSecBitMask mask,
                              const xmlChar *name,
                              FILE *output);

Prints debug information about mask to output .

Parameters

info	the qname<->bit mask mapping information.
mask	the bit mask.
name	the value name to print.
output	the pointer to output FILE.

xmlSecQName2BitMaskDebugXmlDump ()

void
xmlSecQName2BitMaskDebugXmlDump (xmlSecQName2BitMaskInfoConstPtr info,
                                 xmlSecBitMask mask,
                                 const xmlChar *name,
                                 FILE *output);

Prints debug information about mask to output in XML format.

Parameters

info	the qname<->bit mask mapping information.
mask	the bit mask.
name	the value name to print.
output	the pointer to output FILE.

xmlSecWin32ConvertLocaleToUnicode ()

LPWSTR
xmlSecWin32ConvertLocaleToUnicode (const char *str);

Converts input string from current system locale to Unicode.

Parameters

str

the string to convert.

Returns

a pointer to newly allocated string (must be freed with xmlFree) or NULL if an error occurs.

xmlSecWin32ConvertUtf8ToUnicode ()

LPWSTR
xmlSecWin32ConvertUtf8ToUnicode (const xmlChar *str);

Converts input string from UTF8 to Unicode.

Parameters

str

the string to convert.

Returns

a pointer to newly allocated string (must be freed with xmlFree) or NULL if an error occurs.

xmlSecWin32ConvertUnicodeToUtf8 ()

xmlChar *
xmlSecWin32ConvertUnicodeToUtf8 (LPCWSTR str);

Converts input string from Unicode to UTF8.

Parameters

str

the string to convert.

Returns

a pointer to newly allocated string (must be freed with xmlFree) or NULL if an error occurs.

xmlSecWin32ConvertLocaleToUtf8 ()

xmlChar *
xmlSecWin32ConvertLocaleToUtf8 (const char *str);

Converts input string from locale to UTF8.

Parameters

str

the string to convert.

Returns

a pointer to newly allocated string (must be freed with xmlFree) or NULL if an error occurs.

xmlSecWin32ConvertUtf8ToLocale ()

char *
xmlSecWin32ConvertUtf8ToLocale (const xmlChar *str);

Converts input string from UTF8 to locale.

Parameters

str

the string to convert.

Returns

a pointer to newly allocated string (must be freed with xmlFree) or NULL if an error occurs.

xmlSecWin32ConvertTstrToUtf8 ()

xmlChar *
xmlSecWin32ConvertTstrToUtf8 (LPCTSTR str);

Converts input string from TSTR (locale or Unicode) to UTF8.

Parameters

str

the string to convert.

Returns

a pointer to newly allocated string (must be freed with xmlFree) or NULL if an error occurs.

xmlSecWin32ConvertUtf8ToTstr ()

LPTSTR
xmlSecWin32ConvertUtf8ToTstr (const xmlChar *str);

Converts input string from UTF8 to TSTR (locale or Unicode).

Parameters

str

the string to convert.

Returns

a pointer to newly allocated string (must be freed with xmlFree) or NULL if an error occurs.

Types and Values

struct xmlSecQName2IntegerInfo

struct xmlSecQName2IntegerInfo {
    const xmlChar*      qnameHref;
    const xmlChar*      qnameLocalPart;
    int                 intValue;
};

QName <-> Integer conversion definition.

Members

const xmlChar *`qnameHref`;	the QName href
const xmlChar *`qnameLocalPart`;	the QName local
int `intValue`;	the integer value

xmlSecQName2IntegerInfoConstPtr

typedef const xmlSecQName2IntegerInfo *         xmlSecQName2IntegerInfoConstPtr;

Pointer to constant QName <-> Integer conversion definition.

xmlSecBitMask

typedef unsigned int                                    xmlSecBitMask;

Bitmask datatype.

struct xmlSecQName2BitMaskInfo

struct xmlSecQName2BitMaskInfo {
    const xmlChar*      qnameHref;
    const xmlChar*      qnameLocalPart;
    xmlSecBitMask       mask;
};

QName <-> Bitmask conversion definition.

Members

const xmlChar *`qnameHref`;	the QName href
const xmlChar *`qnameLocalPart`;	the QName local
xmlSecBitMask `mask`;	the bitmask value

xmlSecQName2BitMaskInfoConstPtr

typedef const xmlSecQName2BitMaskInfo*          xmlSecQName2BitMaskInfoConstPtr;

Pointer to constant QName <-> Bitmask conversion definition.