/*

[0] Fix | Delete

* Summary: set of utilities for the XSLT engine

[1] Fix | Delete

* Description: interfaces for the utilities module of the XSLT engine.

[2] Fix | Delete

* things like message handling, profiling, and other

[3] Fix | Delete

* generally useful routines.

[4] Fix | Delete

*

[5] Fix | Delete

* Copy: See Copyright for the status of this software.

[6] Fix | Delete

*

[7] Fix | Delete

* Author: Daniel Veillard

[8] Fix | Delete

*/

[9] Fix | Delete

[10] Fix | Delete

#ifndef __XML_XSLTUTILS_H__

[11] Fix | Delete

#define __XML_XSLTUTILS_H__

[12] Fix | Delete

[13] Fix | Delete

#include <libxslt/xsltconfig.h>

[14] Fix | Delete

#ifdef HAVE_STDARG_H

[15] Fix | Delete

#include <stdarg.h>

[16] Fix | Delete

#endif

[17] Fix | Delete

#include <libxml/xpath.h>

[18] Fix | Delete

#include <libxml/dict.h>

[19] Fix | Delete

#include <libxml/xmlerror.h>

[20] Fix | Delete

#include "xsltexports.h"

[21] Fix | Delete

#include "xsltInternals.h"

[22] Fix | Delete

[23] Fix | Delete

#ifdef __cplusplus

[24] Fix | Delete

extern "C" {

[25] Fix | Delete

#endif

[26] Fix | Delete

[27] Fix | Delete

/**

[28] Fix | Delete

* XSLT_TODO:

[29] Fix | Delete

*

[30] Fix | Delete

* Macro to flag unimplemented blocks.

[31] Fix | Delete

*/

[32] Fix | Delete

#define XSLT_TODO \

[33] Fix | Delete

xsltGenericError(xsltGenericErrorContext, \

[34] Fix | Delete

"Unimplemented block at %s:%d\n", \

[35] Fix | Delete

__FILE__, __LINE__);

[36] Fix | Delete

[37] Fix | Delete

/**

[38] Fix | Delete

* XSLT_STRANGE:

[39] Fix | Delete

*

[40] Fix | Delete

* Macro to flag that a problem was detected internally.

[41] Fix | Delete

*/

[42] Fix | Delete

#define XSLT_STRANGE \

[43] Fix | Delete

xsltGenericError(xsltGenericErrorContext, \

[44] Fix | Delete

"Internal error at %s:%d\n", \

[45] Fix | Delete

__FILE__, __LINE__);

[46] Fix | Delete

[47] Fix | Delete

/**

[48] Fix | Delete

* IS_XSLT_ELEM:

[49] Fix | Delete

*

[50] Fix | Delete

* Checks that the element pertains to XSLT namespace.

[51] Fix | Delete

*/

[52] Fix | Delete

#define IS_XSLT_ELEM(n) \

[53] Fix | Delete

(((n) != NULL) && ((n)->type == XML_ELEMENT_NODE) && \

[54] Fix | Delete

((n)->ns != NULL) && (xmlStrEqual((n)->ns->href, XSLT_NAMESPACE)))

[55] Fix | Delete

[56] Fix | Delete

/**

[57] Fix | Delete

* IS_XSLT_NAME:

[58] Fix | Delete

*

[59] Fix | Delete

* Checks the value of an element in XSLT namespace.

[60] Fix | Delete

*/

[61] Fix | Delete

#define IS_XSLT_NAME(n, val) \

[62] Fix | Delete

(xmlStrEqual((n)->name, (const xmlChar *) (val)))

[63] Fix | Delete

[64] Fix | Delete

/**

[65] Fix | Delete

* IS_XSLT_REAL_NODE:

[66] Fix | Delete

*

[67] Fix | Delete

* Check that a node is a 'real' one: document, element, text or attribute.

[68] Fix | Delete

*/

[69] Fix | Delete

#define IS_XSLT_REAL_NODE(n) \

[70] Fix | Delete

(((n) != NULL) && \

[71] Fix | Delete

(((n)->type == XML_ELEMENT_NODE) || \

[72] Fix | Delete

((n)->type == XML_TEXT_NODE) || \

[73] Fix | Delete

((n)->type == XML_CDATA_SECTION_NODE) || \

[74] Fix | Delete

((n)->type == XML_ATTRIBUTE_NODE) || \

[75] Fix | Delete

((n)->type == XML_DOCUMENT_NODE) || \

[76] Fix | Delete

((n)->type == XML_HTML_DOCUMENT_NODE) || \

[77] Fix | Delete

((n)->type == XML_COMMENT_NODE) || \

[78] Fix | Delete

((n)->type == XML_PI_NODE)))

[79] Fix | Delete

[80] Fix | Delete

/*

[81] Fix | Delete

* Our own version of namespaced atributes lookup.

[82] Fix | Delete

*/

[83] Fix | Delete

XSLTPUBFUN xmlChar * XSLTCALL

[84] Fix | Delete

xsltGetNsProp (xmlNodePtr node,

[85] Fix | Delete

const xmlChar *name,

[86] Fix | Delete

const xmlChar *nameSpace);

[87] Fix | Delete

XSLTPUBFUN const xmlChar * XSLTCALL

[88] Fix | Delete

xsltGetCNsProp (xsltStylesheetPtr style,

[89] Fix | Delete

xmlNodePtr node,

[90] Fix | Delete

const xmlChar *name,

[91] Fix | Delete

const xmlChar *nameSpace);

[92] Fix | Delete

XSLTPUBFUN int XSLTCALL

[93] Fix | Delete

xsltGetUTF8Char (const unsigned char *utf,

[94] Fix | Delete

int *len);

[95] Fix | Delete

[96] Fix | Delete

/*

[97] Fix | Delete

* XSLT Debug Tracing Tracing Types

[98] Fix | Delete

*/

[99] Fix | Delete

typedef enum {

[100] Fix | Delete

XSLT_TRACE_ALL = -1,

[101] Fix | Delete

XSLT_TRACE_NONE = 0,

[102] Fix | Delete

XSLT_TRACE_COPY_TEXT = 1<<0,

[103] Fix | Delete

XSLT_TRACE_PROCESS_NODE = 1<<1,

[104] Fix | Delete

XSLT_TRACE_APPLY_TEMPLATE = 1<<2,

[105] Fix | Delete

XSLT_TRACE_COPY = 1<<3,

[106] Fix | Delete

XSLT_TRACE_COMMENT = 1<<4,

[107] Fix | Delete

XSLT_TRACE_PI = 1<<5,

[108] Fix | Delete

XSLT_TRACE_COPY_OF = 1<<6,

[109] Fix | Delete

XSLT_TRACE_VALUE_OF = 1<<7,

[110] Fix | Delete

XSLT_TRACE_CALL_TEMPLATE = 1<<8,

[111] Fix | Delete

XSLT_TRACE_APPLY_TEMPLATES = 1<<9,

[112] Fix | Delete

XSLT_TRACE_CHOOSE = 1<<10,

[113] Fix | Delete

XSLT_TRACE_IF = 1<<11,

[114] Fix | Delete

XSLT_TRACE_FOR_EACH = 1<<12,

[115] Fix | Delete

XSLT_TRACE_STRIP_SPACES = 1<<13,

[116] Fix | Delete

XSLT_TRACE_TEMPLATES = 1<<14,

[117] Fix | Delete

XSLT_TRACE_KEYS = 1<<15,

[118] Fix | Delete

XSLT_TRACE_VARIABLES = 1<<16

[119] Fix | Delete

} xsltDebugTraceCodes;

[120] Fix | Delete

[121] Fix | Delete

/**

[122] Fix | Delete

* XSLT_TRACE:

[123] Fix | Delete

*

[124] Fix | Delete

* Control the type of xsl debugtrace messages emitted.

[125] Fix | Delete

*/

[126] Fix | Delete

#define XSLT_TRACE(ctxt,code,call) \

[127] Fix | Delete

if (ctxt->traceCode && (*(ctxt->traceCode) & code)) \

[128] Fix | Delete

call

[129] Fix | Delete

[130] Fix | Delete

XSLTPUBFUN void XSLTCALL

[131] Fix | Delete

xsltDebugSetDefaultTrace(xsltDebugTraceCodes val);

[132] Fix | Delete

XSLTPUBFUN xsltDebugTraceCodes XSLTCALL

[133] Fix | Delete

xsltDebugGetDefaultTrace(void);

[134] Fix | Delete

[135] Fix | Delete

/*

[136] Fix | Delete

* XSLT specific error and debug reporting functions.

[137] Fix | Delete

*/

[138] Fix | Delete

XSLTPUBVAR xmlGenericErrorFunc xsltGenericError;

[139] Fix | Delete

XSLTPUBVAR void *xsltGenericErrorContext;

[140] Fix | Delete

XSLTPUBVAR xmlGenericErrorFunc xsltGenericDebug;

[141] Fix | Delete

XSLTPUBVAR void *xsltGenericDebugContext;

[142] Fix | Delete

[143] Fix | Delete

XSLTPUBFUN void XSLTCALL

[144] Fix | Delete

xsltPrintErrorContext (xsltTransformContextPtr ctxt,

[145] Fix | Delete

xsltStylesheetPtr style,

[146] Fix | Delete

xmlNodePtr node);

[147] Fix | Delete

XSLTPUBFUN void XSLTCALL

[148] Fix | Delete

xsltMessage (xsltTransformContextPtr ctxt,

[149] Fix | Delete

xmlNodePtr node,

[150] Fix | Delete

xmlNodePtr inst);

[151] Fix | Delete

XSLTPUBFUN void XSLTCALL

[152] Fix | Delete

xsltSetGenericErrorFunc (void *ctx,

[153] Fix | Delete

xmlGenericErrorFunc handler);

[154] Fix | Delete

XSLTPUBFUN void XSLTCALL

[155] Fix | Delete

xsltSetGenericDebugFunc (void *ctx,

[156] Fix | Delete

xmlGenericErrorFunc handler);

[157] Fix | Delete

XSLTPUBFUN void XSLTCALL

[158] Fix | Delete

xsltSetTransformErrorFunc (xsltTransformContextPtr ctxt,

[159] Fix | Delete

void *ctx,

[160] Fix | Delete

xmlGenericErrorFunc handler);

[161] Fix | Delete

XSLTPUBFUN void XSLTCALL

[162] Fix | Delete

xsltTransformError (xsltTransformContextPtr ctxt,

[163] Fix | Delete

xsltStylesheetPtr style,

[164] Fix | Delete

xmlNodePtr node,

[165] Fix | Delete

const char *msg,

[166] Fix | Delete

...) LIBXSLT_ATTR_FORMAT(4,5);

[167] Fix | Delete

[168] Fix | Delete

XSLTPUBFUN int XSLTCALL

[169] Fix | Delete

xsltSetCtxtParseOptions (xsltTransformContextPtr ctxt,

[170] Fix | Delete

int options);

[171] Fix | Delete

/*

[172] Fix | Delete

* Sorting.

[173] Fix | Delete

*/

[174] Fix | Delete

[175] Fix | Delete

XSLTPUBFUN void XSLTCALL

[176] Fix | Delete

xsltDocumentSortFunction (xmlNodeSetPtr list);

[177] Fix | Delete

XSLTPUBFUN void XSLTCALL

[178] Fix | Delete

xsltSetSortFunc (xsltSortFunc handler);

[179] Fix | Delete

XSLTPUBFUN void XSLTCALL

[180] Fix | Delete

xsltSetCtxtSortFunc (xsltTransformContextPtr ctxt,

[181] Fix | Delete

xsltSortFunc handler);

[182] Fix | Delete

XSLTPUBFUN void XSLTCALL

[183] Fix | Delete

xsltDefaultSortFunction (xsltTransformContextPtr ctxt,

[184] Fix | Delete

xmlNodePtr *sorts,

[185] Fix | Delete

int nbsorts);

[186] Fix | Delete

XSLTPUBFUN void XSLTCALL

[187] Fix | Delete

xsltDoSortFunction (xsltTransformContextPtr ctxt,

[188] Fix | Delete

xmlNodePtr * sorts,

[189] Fix | Delete

int nbsorts);

[190] Fix | Delete

XSLTPUBFUN xmlXPathObjectPtr * XSLTCALL

[191] Fix | Delete

xsltComputeSortResult (xsltTransformContextPtr ctxt,

[192] Fix | Delete

xmlNodePtr sort);

[193] Fix | Delete

[194] Fix | Delete

/*

[195] Fix | Delete

* QNames handling.

[196] Fix | Delete

*/

[197] Fix | Delete

[198] Fix | Delete

XSLTPUBFUN const xmlChar * XSLTCALL

[199] Fix | Delete

xsltSplitQName (xmlDictPtr dict,

[200] Fix | Delete

const xmlChar *name,

[201] Fix | Delete

const xmlChar **prefix);

[202] Fix | Delete

XSLTPUBFUN const xmlChar * XSLTCALL

[203] Fix | Delete

xsltGetQNameURI (xmlNodePtr node,

[204] Fix | Delete

xmlChar **name);

[205] Fix | Delete

[206] Fix | Delete

XSLTPUBFUN const xmlChar * XSLTCALL

[207] Fix | Delete

xsltGetQNameURI2 (xsltStylesheetPtr style,

[208] Fix | Delete

xmlNodePtr node,

[209] Fix | Delete

const xmlChar **name);

[210] Fix | Delete

[211] Fix | Delete

/*

[212] Fix | Delete

* Output, reuse libxml I/O buffers.

[213] Fix | Delete

*/

[214] Fix | Delete

XSLTPUBFUN int XSLTCALL

[215] Fix | Delete

xsltSaveResultTo (xmlOutputBufferPtr buf,

[216] Fix | Delete

xmlDocPtr result,

[217] Fix | Delete

xsltStylesheetPtr style);

[218] Fix | Delete

XSLTPUBFUN int XSLTCALL

[219] Fix | Delete

xsltSaveResultToFilename (const char *URI,

[220] Fix | Delete

xmlDocPtr result,

[221] Fix | Delete

xsltStylesheetPtr style,

[222] Fix | Delete

int compression);

[223] Fix | Delete

XSLTPUBFUN int XSLTCALL

[224] Fix | Delete

xsltSaveResultToFile (FILE *file,

[225] Fix | Delete

xmlDocPtr result,

[226] Fix | Delete

xsltStylesheetPtr style);

[227] Fix | Delete

XSLTPUBFUN int XSLTCALL

[228] Fix | Delete

xsltSaveResultToFd (int fd,

[229] Fix | Delete

xmlDocPtr result,

[230] Fix | Delete

xsltStylesheetPtr style);

[231] Fix | Delete

XSLTPUBFUN int XSLTCALL

[232] Fix | Delete

xsltSaveResultToString (xmlChar **doc_txt_ptr,

[233] Fix | Delete

int * doc_txt_len,

[234] Fix | Delete

xmlDocPtr result,

[235] Fix | Delete

xsltStylesheetPtr style);

[236] Fix | Delete

[237] Fix | Delete

/*

[238] Fix | Delete

* XPath interface

[239] Fix | Delete

*/

[240] Fix | Delete

XSLTPUBFUN xmlXPathCompExprPtr XSLTCALL

[241] Fix | Delete

xsltXPathCompile (xsltStylesheetPtr style,

[242] Fix | Delete

const xmlChar *str);

[243] Fix | Delete

XSLTPUBFUN xmlXPathCompExprPtr XSLTCALL

[244] Fix | Delete

xsltXPathCompileFlags (xsltStylesheetPtr style,

[245] Fix | Delete

const xmlChar *str,

[246] Fix | Delete

int flags);

[247] Fix | Delete

[248] Fix | Delete

/*

[249] Fix | Delete

* Profiling.

[250] Fix | Delete

*/

[251] Fix | Delete

XSLTPUBFUN void XSLTCALL

[252] Fix | Delete

xsltSaveProfiling (xsltTransformContextPtr ctxt,

[253] Fix | Delete

FILE *output);

[254] Fix | Delete

XSLTPUBFUN xmlDocPtr XSLTCALL

[255] Fix | Delete

xsltGetProfileInformation (xsltTransformContextPtr ctxt);

[256] Fix | Delete

[257] Fix | Delete

XSLTPUBFUN long XSLTCALL

[258] Fix | Delete

xsltTimestamp (void);

[259] Fix | Delete

XSLTPUBFUN void XSLTCALL

[260] Fix | Delete

xsltCalibrateAdjust (long delta);

[261] Fix | Delete

[262] Fix | Delete

/**

[263] Fix | Delete

* XSLT_TIMESTAMP_TICS_PER_SEC:

[264] Fix | Delete

*

[265] Fix | Delete

* Sampling precision for profiling

[266] Fix | Delete

*/

[267] Fix | Delete

#define XSLT_TIMESTAMP_TICS_PER_SEC 100000l

[268] Fix | Delete

[269] Fix | Delete

/*

[270] Fix | Delete

* Hooks for the debugger.

[271] Fix | Delete

*/

[272] Fix | Delete

[273] Fix | Delete

typedef enum {

[274] Fix | Delete

XSLT_DEBUG_NONE = 0, /* no debugging allowed */

[275] Fix | Delete

XSLT_DEBUG_INIT,

[276] Fix | Delete

XSLT_DEBUG_STEP,

[277] Fix | Delete

XSLT_DEBUG_STEPOUT,

[278] Fix | Delete

XSLT_DEBUG_NEXT,

[279] Fix | Delete

XSLT_DEBUG_STOP,

[280] Fix | Delete

XSLT_DEBUG_CONT,

[281] Fix | Delete

XSLT_DEBUG_RUN,

[282] Fix | Delete

XSLT_DEBUG_RUN_RESTART,

[283] Fix | Delete

XSLT_DEBUG_QUIT

[284] Fix | Delete

} xsltDebugStatusCodes;

[285] Fix | Delete

[286] Fix | Delete

XSLTPUBVAR int xslDebugStatus;

[287] Fix | Delete

[288] Fix | Delete

typedef void (*xsltHandleDebuggerCallback) (xmlNodePtr cur, xmlNodePtr node,

[289] Fix | Delete

xsltTemplatePtr templ, xsltTransformContextPtr ctxt);

[290] Fix | Delete

typedef int (*xsltAddCallCallback) (xsltTemplatePtr templ, xmlNodePtr source);

[291] Fix | Delete

typedef void (*xsltDropCallCallback) (void);

[292] Fix | Delete

[293] Fix | Delete

XSLTPUBFUN void XSLTCALL

[294] Fix | Delete

xsltSetDebuggerStatus (int value);

[295] Fix | Delete

XSLTPUBFUN int XSLTCALL

[296] Fix | Delete

xsltGetDebuggerStatus (void);

[297] Fix | Delete

XSLTPUBFUN int XSLTCALL

[298] Fix | Delete

xsltSetDebuggerCallbacks (int no, void *block);

[299] Fix | Delete

XSLTPUBFUN int XSLTCALL

[300] Fix | Delete

xslAddCall (xsltTemplatePtr templ,

[301] Fix | Delete

xmlNodePtr source);

[302] Fix | Delete

XSLTPUBFUN void XSLTCALL

[303] Fix | Delete

xslDropCall (void);

[304] Fix | Delete

[305] Fix | Delete

#ifdef __cplusplus

[306] Fix | Delete

}

[307] Fix | Delete

#endif

[308] Fix | Delete

[309] Fix | Delete

#endif /* __XML_XSLTUTILS_H__ */

[310] Fix | Delete

[311] Fix | Delete

[312] Fix | Delete

[313] Fix | Delete