XQC_StaticContext_s Struct Reference

The XQC_StaticContext struct provides a way to specify values for the static context of the query to be prepared. More...

#include <xqc.h>

List of all members.

Public Attributes
XQC_Error(*	create_child_context )(XQC_StaticContext *context, XQC_StaticContext **child_context)
	Creates a child context of the given static context.
XQC_Error(*	declare_ns )(XQC_StaticContext *context, const char *prefix, const char *uri)
	Adds a (prefix, uri) pair to the set of statically known namespaces of the given context.
XQC_Error(*	get_ns_by_prefix )(XQC_StaticContext *context, const char *prefix, const char **result_ns)
	Returns the namespace uri that belongs to the given prefix.
XQC_Error(*	set_default_element_and_type_ns )(XQC_StaticContext *context, const char *uri)
	Sets the value of the default namespace for elements and types.
XQC_Error(*	get_default_element_and_type_ns )(XQC_StaticContext *context, const char **uri)
XQC_Error(*	set_default_function_ns )(XQC_StaticContext *context, const char *uri)
	Sets the default namespace for functions.
XQC_Error(*	get_default_function_ns )(XQC_StaticContext *context, const char **uri)
	Returnsthe default namespace for functions set in this static context.
XQC_Error(*	set_xpath_compatib_mode )(XQC_StaticContext *context, XQC_XPath1Mode mode)
	Sets the XPath 1.0 compatibility mode to either XQC_XPATH1_0 or XQC_XPATH2_0.
XQC_Error(*	get_xpath_compatib_mode )(XQC_StaticContext *context, XQC_XPath1Mode *mode)
	Returns the XPath 1.0 compatibility that is set in the given static context.
XQC_Error(*	set_construction_mode )(XQC_StaticContext *context, XQC_ConstructionMode mode)
	Sets the construction mode to either XQC_PRESERVE_CONS or XQC_StaticContext.
XQC_Error(*	get_construction_mode )(XQC_StaticContext *context, XQC_ConstructionMode *mode)
	Returns the construction mode that is set in the given static context.
XQC_Error(*	set_ordering_mode )(XQC_StaticContext *context, XQC_OrderingMode mode)
	Sets the ordering mode to either XQC_ORDERED or XQC_UNORDERED.
XQC_Error(*	get_ordering_mode )(XQC_StaticContext *context, XQC_OrderingMode *mode)
	Returns the ordering mode that is set in the given static context.
XQC_Error(*	set_default_order_empty_sequences )(XQC_StaticContext *context, XQC_OrderEmptyMode mode)
	Sets the default order mode for empty sequences to either XQC_EMTPY_LEAST or XQC_EMPTY_GREATEST.
XQC_Error(*	get_default_order_empty_sequences )(XQC_StaticContext *context, XQC_OrderEmptyMode *mode)
	Returns the default order mode for empty sequences that is set in the given static context.
XQC_Error(*	set_boundary_space_policy )(XQC_StaticContext *context, XQC_BoundarySpaceMode mode)
	Sets the boundary space policy to either XQC_PRESERVE_SPACE or XQC_STRIP_SPACE.
XQC_Error(*	get_boundary_space_policy )(XQC_StaticContext *context, XQC_BoundarySpaceMode *mode)
	Returns the boundary space policy that is set in the given static context.
XQC_Error(*	set_copy_ns_mode )(XQC_StaticContext *context, XQC_PreserveMode preserve, XQC_InheritMode inherit)
	Sets the copy namespace mode which consists of the preserve and the inherit mode.
XQC_Error(*	get_copy_ns_mode )(XQC_StaticContext *context, XQC_PreserveMode *preserve, XQC_InheritMode *inherit)
	Returns the copy namespace mode as a pair consisting of the preserve and the inherit mode.
XQC_Error(*	set_base_uri )(XQC_StaticContext *context, const char *base_uri)
	Sets the base uri in the given static context.
XQC_Error(*	get_base_uri )(XQC_StaticContext *context, const char **base_uri)
	Returns the base uri that is set in the given static context.
XQC_Error(*	set_error_handler )(XQC_StaticContext *context, XQC_ErrorHandler *handler)
XQC_Error(*	get_error_handler )(const XQC_StaticContext *context, XQC_ErrorHandler **handler)
void *(*	get_interface )(const XQC_StaticContext *context, const char *name)
	Called to retrieve an implementation specific interface.
void(*	free )(XQC_StaticContext *context)
	Called to free the resources associated with the XQC_StaticContext.

---

Detailed Description

The XQC_StaticContext struct provides a way to specify values for the static context of the query to be prepared.

An XQC_StaticContext object is not thread-safe - threads should each use their own instance of a XQC_StaticContext object.

XQC_StaticContext objects are created by calling the XQC_Implementation::create_context() function. Once created, the user is responsible for freeing the object by calling the free() function. The XQC_StaticContext object should be freed before the XQC_Implementation object that created it.

---

Member Data Documentation

XQC_Error(* XQC_StaticContext_s::create_child_context)(XQC_StaticContext *context, XQC_StaticContext **child_context)

Creates a child context of the given static context.

A child context contains the same information as it's parent context but it allows the user to override and add information. The user is responsible for freeing the XQC_StaticContext object returned by calling XQC_StaticContext::free().

Parameters:

	context	The XQC_StaticContext that this function pointer is a member of
[out]	child_context	The newly created XQC_StaticContext object which is a child of the given context.

Return values:

	XQC_NO_ERROR
	XQC_INTERNAL_ERROR

XQC_Error(* XQC_StaticContext_s::declare_ns)(XQC_StaticContext *context, const char *prefix, const char *uri)

Adds a (prefix, uri) pair to the set of statically known namespaces of the given context.

Parameters:

	context	The XQC_StaticContext that this function pointer is a member of
	prefix	The prefix of the namespace to add to the given XQC_StaticContext.
	uri	The uri of the namespace to add to the given XQC_StaticContext.

Return values:

	XQC_NO_ERROR
	XQC_INTERNAL_ERROR

void(* XQC_StaticContext_s::free)(XQC_StaticContext *context)

Called to free the resources associated with the XQC_StaticContext.

Parameters:

context

The XQC_StaticContext that this function pointer is a member of

XQC_Error(* XQC_StaticContext_s::get_base_uri)(XQC_StaticContext *context, const char **base_uri)

Returns the base uri that is set in the given static context.

Parameters:

	context	The XQC_StaticContext that this function pointer is a member of
[out]	base_uri	The base uri that is set in the given context.

Return values:

	XQC_NO_ERROR
	XQC_INTERNAL_ERROR

XQC_Error(* XQC_StaticContext_s::get_boundary_space_policy)(XQC_StaticContext *context, XQC_BoundarySpaceMode *mode)

Returns the boundary space policy that is set in the given static context.

Parameters:

	context	The XQC_StaticContext that this function pointer is a member of
[out]	mode	The XQC_BoundarySpaceMode that is set in the given context.

Return values:

	XQC_NO_ERROR
	XQC_INTERNAL_ERROR

XQC_Error(* XQC_StaticContext_s::get_construction_mode)(XQC_StaticContext *context, XQC_ConstructionMode *mode)

Returns the construction mode that is set in the given static context.

Parameters:

	context	The XQC_StaticContext that this function pointer is a member of
[out]	mode	The XQC_ConstructionMode that is set in the given context.

Return values:

	XQC_NO_ERROR
	XQC_INTERNAL_ERROR

XQC_Error(* XQC_StaticContext_s::get_copy_ns_mode)(XQC_StaticContext *context, XQC_PreserveMode *preserve, XQC_InheritMode *inherit)

Returns the copy namespace mode as a pair consisting of the preserve and the inherit mode.

Parameters:

	context	The XQC_StaticContext that this function pointer is a member of
[out]	preserve	The XQC_PreserveMode that is set in the given context.
[out]	inherit	The XQC_InheritMode that is set in the given context.

Return values:

	XQC_NO_ERROR
	XQC_INTERNAL_ERROR

XQC_Error(* XQC_StaticContext_s::get_default_element_and_type_ns)(XQC_StaticContext *context, const char **uri)

Parameters:

	context	The XQC_StaticContext that this function pointer is a member of
[out]	uri	The uri of the default element and type namespace that is set in the given context.

Return values:

	XQC_NO_ERROR
	XQC_INTERNAL_ERROR

XQC_Error(* XQC_StaticContext_s::get_default_function_ns)(XQC_StaticContext *context, const char **uri)

Returnsthe default namespace for functions set in this static context.

Parameters:

	context	The XQC_StaticContext that this function pointer is a member of
[out]	uri	The uri of the default function namespace that is set in the given context.

Return values:

	XQC_NO_ERROR
	XQC_INTERNAL_ERROR

XQC_Error(* XQC_StaticContext_s::get_default_order_empty_sequences)(XQC_StaticContext *context, XQC_OrderEmptyMode *mode)

Returns the default order mode for empty sequences that is set in the given static context.

Parameters:

	context	The XQC_StaticContext that this function pointer is a member of
[out]	mode	The XQC_OrderEmptyMode that is set in the given context.

Return values:

	XQC_NO_ERROR
	XQC_INTERNAL_ERROR

XQC_Error(* XQC_StaticContext_s::get_error_handler)(const XQC_StaticContext *context, XQC_ErrorHandler **handler)

void*(* XQC_StaticContext_s::get_interface)(const XQC_StaticContext *context, const char *name)

Called to retrieve an implementation specific interface.

Parameters:

	context	The XQC_StaticContext that this function pointer is a member of
	name	The name that identifies the interface to return

Returns:

A pointer to the interface, or 0 if the name is not recognized by this implementation of XQC.

XQC_Error(* XQC_StaticContext_s::get_ns_by_prefix)(XQC_StaticContext *context, const char *prefix, const char **result_ns)

Returns the namespace uri that belongs to the given prefix.

Parameters:

	context	The XQC_StaticContext that this function pointer is a member of
	prefix	The prefix of the namespace to add to the given XQC_StaticContext.
[out]	result_ns	The namespace uri of the namespace registered with the given prefix, or 0 if none can be found.

Return values:

	XQC_NO_ERROR
	XQC_INTERNAL_ERROR

XQC_Error(* XQC_StaticContext_s::get_ordering_mode)(XQC_StaticContext *context, XQC_OrderingMode *mode)

Returns the ordering mode that is set in the given static context.

Parameters:

	context	The XQC_StaticContext that this function pointer is a member of
[out]	mode	The XQC_OrderingMode that is set in the given context.

Return values:

	XQC_NO_ERROR
	XQC_INTERNAL_ERROR

XQC_Error(* XQC_StaticContext_s::get_xpath_compatib_mode)(XQC_StaticContext *context, XQC_XPath1Mode *mode)

Returns the XPath 1.0 compatibility that is set in the given static context.

Parameters:

	context	The XQC_StaticContext that this function pointer is a member of
[out]	mode	The XQC_XPath1Mode that is set in the given context.

Return values:

	XQC_NO_ERROR
	XQC_INTERNAL_ERROR

XQC_Error(* XQC_StaticContext_s::set_base_uri)(XQC_StaticContext *context, const char *base_uri)

Sets the base uri in the given static context.

Parameters:

	context	The XQC_StaticContext that this function pointer is a member of
	base_uri	The base uri to set in the given context.

Return values:

	XQC_NO_ERROR
	XQC_INTERNAL_ERROR

XQC_Error(* XQC_StaticContext_s::set_boundary_space_policy)(XQC_StaticContext *context, XQC_BoundarySpaceMode mode)

Sets the boundary space policy to either XQC_PRESERVE_SPACE or XQC_STRIP_SPACE.

Parameters:

	context	The XQC_StaticContext that this function pointer is a member of
	mode	The XQC_BoundarySpaceMode to set in the given context.

Return values:

	XQC_NO_ERROR
	XQC_INTERNAL_ERROR

XQC_Error(* XQC_StaticContext_s::set_construction_mode)(XQC_StaticContext *context, XQC_ConstructionMode mode)

Sets the construction mode to either XQC_PRESERVE_CONS or XQC_StaticContext.

Parameters:

	context	The XQC_StaticContext that this function pointer is a member of
	mode	The XQC_ConstructionMode to set in the given context.

Return values:

	XQC_NO_ERROR
	XQC_INTERNAL_ERROR

XQC_Error(* XQC_StaticContext_s::set_copy_ns_mode)(XQC_StaticContext *context, XQC_PreserveMode preserve, XQC_InheritMode inherit)

Sets the copy namespace mode which consists of the preserve and the inherit mode.

Parameters:

	context	The XQC_StaticContext that this function pointer is a member of
	preserve	The XQC_PreserveMode to set in the given context.
	inherit	The XQC_InheritMode to set in the given context.

Return values:

	XQC_NO_ERROR
	XQC_INTERNAL_ERROR

XQC_Error(* XQC_StaticContext_s::set_default_element_and_type_ns)(XQC_StaticContext *context, const char *uri)

Sets the value of the default namespace for elements and types.

Parameters:

	context	The XQC_StaticContext that this function pointer is a member of
	uri	The uri of the default element and type namespace to set in the given context.

Return values:

	XQC_NO_ERROR
	XQC_INTERNAL_ERROR

XQC_Error(* XQC_StaticContext_s::set_default_function_ns)(XQC_StaticContext *context, const char *uri)

Sets the default namespace for functions.

Parameters:

	context	The XQC_StaticContext that this function pointer is a member of
	uri	The uri of the default function namespace to set in the given context.

Return values:

	XQC_NO_ERROR
	XQC_INTERNAL_ERROR

XQC_Error(* XQC_StaticContext_s::set_default_order_empty_sequences)(XQC_StaticContext *context, XQC_OrderEmptyMode mode)

Sets the default order mode for empty sequences to either XQC_EMTPY_LEAST or XQC_EMPTY_GREATEST.

Parameters:

	context	The XQC_StaticContext that this function pointer is a member of
	mode	The XQC_OrderEmptyMode to set in the given context.

Return values:

	XQC_NO_ERROR
	XQC_INTERNAL_ERROR

XQC_Error(* XQC_StaticContext_s::set_error_handler)(XQC_StaticContext *context, XQC_ErrorHandler *handler)

XQC_Error(* XQC_StaticContext_s::set_ordering_mode)(XQC_StaticContext *context, XQC_OrderingMode mode)

Sets the ordering mode to either XQC_ORDERED or XQC_UNORDERED.

Parameters:

	context	The XQC_StaticContext that this function pointer is a member of
	mode	The XQC_OrderingMode to set in the given context.

Return values:

	XQC_NO_ERROR
	XQC_INTERNAL_ERROR

XQC_Error(* XQC_StaticContext_s::set_xpath_compatib_mode)(XQC_StaticContext *context, XQC_XPath1Mode mode)

Sets the XPath 1.0 compatibility mode to either XQC_XPATH1_0 or XQC_XPATH2_0.

Parameters:

	context	The XQC_StaticContext that this function pointer is a member of
	mode	The XQC_XPath1Mode to set in the given context.

Return values:

	XQC_NO_ERROR
	XQC_INTERNAL_ERROR

---

The documentation for this struct was generated from the following file:

• xqc.h