XQC_Sequence_s Struct Reference

#include <xqc.h>

List of all members.

Public Attributes
XQC_Error(*	next )(XQC_Sequence *sequence)
	Moves the XQC_Sequence so that the current item is positioned at the next item in the sequence.
void *(*	get_interface )(const XQC_Sequence *sequence, const char *name)
	Called to retrieve an implementation specific interface.
void(*	free )(XQC_Sequence *sequence)
	Called to free the resources associated with the XQC_Sequence.
Functions on the current item
XQC_Error(*	item_type )(const XQC_Sequence *sequence, XQC_ItemType *type)
	Returns an item type enumeration for the type of the current item.
XQC_Error(*	type_name )(const XQC_Sequence *sequence, const char **uri, const char **name)
	Returns the type name for the current item as a (URI, localname) pair.
XQC_Error(*	string_value )(const XQC_Sequence *sequence, const char **value)
	Returns the string value of the current item in the sequence - this is equivalent to calling fn:string() (http://www.w3.org/TR/xpath-functions/#func-string) on the current item.
XQC_Error(*	integer_value )(const XQC_Sequence *sequence, int *value)
	Returns the value of the current item in the sequence as an integer - this is equivalent to calling fn:number() (http://www.w3.org/TR/xpath-functions/#func-number) on the current item, and casting the result to an int.
XQC_Error(*	double_value )(const XQC_Sequence *sequence, double *value)
	Returns the value of the current item in the sequence as a double - this is equivalent to calling fn:number() (http://www.w3.org/TR/xpath-functions/#func-number) on the current item.
XQC_Error(*	node_name )(const XQC_Sequence *sequence, const char **uri, const char **name)
	Returns the name for the current node as a (URI, localname) pair.

---

Detailed Description

Examples:

xqc-basic.c, and xqc-context-item.c.

---

Member Data Documentation

XQC_Error(* XQC_Sequence_s::next)(XQC_Sequence *sequence)

Moves the XQC_Sequence so that the current item is positioned at the next item in the sequence.

Parameters:

sequence

The XQC_Sequence that this function pointer is a member of

Return values:

	XQC_NO_ERROR	when the call is successful
	XQC_END_OF_SEQUENCE	when the end of the sequence is reached
	XQC_TYPE_ERROR
	XQC_DYNAMIC_ERROR

Examples:

xqc-basic.c, and xqc-context-item.c.

XQC_Error(* XQC_Sequence_s::item_type)(const XQC_Sequence *sequence, XQC_ItemType *type)

Returns an item type enumeration for the type of the current item.

Parameters:

	sequence	The XQC_Sequence that this function pointer is a member of
[out]	type	the XQC_ItemType of the current item

Return values:

	XQC_NO_ERROR
	XQC_NO_CURRENT_ITEM	if there is no current item, either because next() has not been called yet, or because the end of the sequence has been reached.

XQC_Error(* XQC_Sequence_s::type_name)(const XQC_Sequence *sequence, const char **uri, const char **name)

Returns the type name for the current item as a (URI, localname) pair.

Parameters:

	sequence	The XQC_Sequence that this function pointer is a member of
[out]	uri	The URI of the type of the current item. The memory for the string will be valid until a subsequent call to XQC_Sequence::next().
[out]	name	The localname of the type of the current item. The memory for the string will be valid until a subsequent call to XQC_Sequence::next().

Return values:

	XQC_NO_ERROR
	XQC_NO_CURRENT_ITEM	if there is no current item, either because next() has not been called yet, or because the end of the sequence has been reached.

XQC_Error(* XQC_Sequence_s::string_value)(const XQC_Sequence *sequence, const char **value)

Returns the string value of the current item in the sequence - this is equivalent to calling fn:string() (http://www.w3.org/TR/xpath-functions/#func-string) on the current item.

This is available for all item types.

Parameters:

	sequence	The XQC_Sequence that this function pointer is a member of
[out]	value	The string value of the current item. The memory for the string will be valid until a subsequent call to XQC_Sequence::next().

Return values:

	XQC_NO_ERROR
	XQC_NO_CURRENT_ITEM	if there is no current item, either because next() has not been called yet, or because the end of the sequence has been reached.

Examples:

xqc-basic.c, and xqc-context-item.c.

XQC_Error(* XQC_Sequence_s::integer_value)(const XQC_Sequence *sequence, int *value)

Returns the value of the current item in the sequence as an integer - this is equivalent to calling fn:number() (http://www.w3.org/TR/xpath-functions/#func-number) on the current item, and casting the result to an int.

This is available for all item types.

Parameters:

	sequence	The XQC_Sequence that this function pointer is a member of
[out]	value	The value of the current item as an int.

Return values:

	XQC_NO_ERROR
	XQC_NO_CURRENT_ITEM	if there is no current item, either because next() has not been called yet, or because the end of the sequence has been reached.

XQC_Error(* XQC_Sequence_s::double_value)(const XQC_Sequence *sequence, double *value)

Returns the value of the current item in the sequence as a double - this is equivalent to calling fn:number() (http://www.w3.org/TR/xpath-functions/#func-number) on the current item.

This is available for all item types.

Parameters:

	sequence	The XQC_Sequence that this function pointer is a member of
[out]	value	The value of the current item as a double.

Return values:

	XQC_NO_ERROR
	XQC_NO_CURRENT_ITEM	if there is no current item, either because next() has not been called yet, or because the end of the sequence has been reached.

XQC_Error(* XQC_Sequence_s::node_name)(const XQC_Sequence *sequence, const char **uri, const char **name)

Returns the name for the current node as a (URI, localname) pair.

Parameters:

	sequence	The XQC_Sequence that this function pointer is a member of
[out]	uri	The URI of the name of the current node. The memory for the string will be valid until a subsequent call to XQC_Sequence::next().
[out]	name	The localname of the name of the current node. The memory for the string will be valid until a subsequent call to XQC_Sequence::next().

Return values:

	XQC_NO_ERROR
	XQC_NO_CURRENT_ITEM	if there is no current item, either because next() has not been called yet, or because the end of the sequence has been reached.
	XQC_NOT_NODE	if the current item is not a node.

void*(* XQC_Sequence_s::get_interface)(const XQC_Sequence *sequence, const char *name)

Called to retrieve an implementation specific interface.

Parameters:

	sequence	The XQC_Sequence 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.

void(* XQC_Sequence_s::free)(XQC_Sequence *sequence)

Called to free the resources associated with the XQC_Sequence.

Parameters:

sequence

The XQC_Sequence that this function pointer is a member of

Examples:

xqc-basic.c, and xqc-context-item.c.

---

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

• xqc.h