Classes
class	DOMStringHelper

struct	c_wstr_functor

struct	DOMStringHashFunction
	Hash functor for DOMStrings. More...

struct	XalanMapKeyTraits< XalanDOMString >

struct	DOMStringPointerHashFunction
	Hash functor for DOMStrings. More...

struct	XalanMapKeyTraits< XalanDOMString * >

struct	XalanMapKeyTraits< const XalanDOMString * >

struct	DOMStringEqualsFunction
	Equals functor for DOMStrings. More...

struct	DOMStringNotEqualsFunction
	Not equals functor for DOMStrings. More...

struct	DOMStringLessThanFunction
	Less than functor for DOMStrings. More...

struct	DOMStringPointerEqualToFunction
	Equal to functor for DOMStrings. More...

struct	DOMStringPointerLessThanFunction
	Less than functor for DOMStrings. More...

struct	DOMStringLessThanIgnoreCaseASCIIFunction
	Less than functor for DOMStrings which ignores case for the characters a-z and A-Z. More...

struct	DOMStringLessThanOrEqualFunction
	Less than or equal functor for DOMStrings. More...

struct	DOMStringGreaterThanFunction
	Greater than functor for DOMStrings. More...

struct	DOMStringGreaterThanOrEqualFunction
	Greater than or equal functor for DOMStrings. More...

struct	less_no_case_ascii_wide_string
	This functor is designed to compare 0-terminated wide strings in a case-insensitive manner. More...

Macros
#define	XALAN_STATIC_UCODE_STRING(str) str

Functions
template<class InputIteratorType , class OutputIteratorType >
OutputIteratorType	XalanCopy (InputIteratorType begin, InputIteratorType end, OutputIteratorType iterator)

template<class InputIteratorType , class OutputIteratorType , class UnaryFunction >
OutputIteratorType	XalanTransform (InputIteratorType begin, InputIteratorType end, OutputIteratorType iterator, UnaryFunction function)

const XalanDOMChar *	c_wstr (const XalanDOMString &theString)
	Get the underlying representation of the target XalanDOMString as a null-terminated string. More...

const char *	c_str (const CharVectorType &theString)
	Get the underlying representation of the target CharVectorType as a null-terminated string. More...

const XalanDOMChar *	c_wstr (const XalanDOMChar *theString)
	Get the underlying representation of the wide string as a UNICODE null-terminated string. More...

const XalanDOMChar *	toCharArray (const XalanDOMString &theString)
	Get the underlying representation of the target XalanDOMString as an array of XalanDOMChar, not guaranteed to be null-terminated. More...

const XalanDOMChar *	toCharArray (const XalanDOMChar *theString)
	Get the underlying representation of a XalanDOMChar. More...

const char *	toCharArray (const CharVectorType &theString)
	Get the underlying representation of the target CharVectorType as a pointer to an array of characters. More...

void	reserve (XalanDOMString &theString, XalanDOMString::size_type theCount)
	Reserve some space in the string for more efficient concatenation... More...

XalanDOMString::size_type	length (const XalanDOMString &theString)
	Get the length of a XalanDOMString. More...

XalanDOMString::size_type	length (const XalanDOMChar *theString)
	Get the length of a null-terminated string of XalanDOMChar characters. More...

XalanDOMString::size_type	length (const char *theString)
	Get the length of a null-terminated string. More...

bool	isEmpty (const XalanDOMString &str)
	Determines if the target string contains any elements. More...

XalanDOMString::size_type	indexOf (const XalanDOMChar *theString, XalanDOMChar theChar)
	Simulates the java String method indexOf(). More...

XalanDOMString::size_type	indexOf (const XalanDOMChar *theString, XalanDOMString::size_type theStringLength, XalanDOMChar theChar)
	Simulates the java String method indexOf(). More...

XalanDOMString::size_type	indexOf (const XalanDOMString &theString, XalanDOMChar theChar)
	Simulates the java String method indexOf(). More...

	indexOf (const XalanDOMChar theString, XalanDOMString::size_type theStringLength, const XalanDOMChar theSubstring, XalanDOMString::size_type theSubstringLength)
	Simulates the java String method indexOf(). More...

	indexOf (const XalanDOMChar theString, const XalanDOMChar theSubstring)
	Simulates the java String method indexOf(). More...

	indexOf (const XalanDOMString &theString, const XalanDOMString &theSubstring)
	Simulates the java String method indexOf(). More...

	lastIndexOf (const XalanDOMChar *theString, XalanDOMChar theChar)
	Simulates the java String method lastIndexOf(). More...

XalanDOMString::size_type	lastIndexOf (const XalanDOMString &theString, XalanDOMChar theChar)
	Simulates the java String method lastIndexOf(). More...

	startsWith (const XalanDOMChar theString, XalanDOMString::size_type theStringLength, const XalanDOMChar theSubstring, XalanDOMString::size_type theSubstringLength)
	Simulates the java String method startsWith(). More...

bool	startsWith (const XalanDOMChar theString, const XalanDOMChar theSubstring)
	Simulates the java String method startsWith(). More...

bool	startsWith (const XalanDOMChar *theString, const XalanDOMString &theSubstring)
	Simulates the java String method startsWith(). More...

bool	startsWith (const XalanDOMString &theString, const XalanDOMChar *theSubstring)
	Simulates the java String method startsWith(). More...

bool	startsWith (const XalanDOMString &theString, const XalanDOMChar *theSubstring, XalanDOMString::size_type theSubstringLength)
	Simulates the java String method startsWith(). More...

bool	startsWith (const XalanDOMString &theString, const XalanDOMString &theSubstring)
	Simulates the java String method startsWith(). More...

	endsWith (const XalanDOMChar theString, XalanDOMString::size_type theStringLength, const XalanDOMChar theSubstring, XalanDOMString::size_type theSubstringLength)
	Simulates the java String method endsWith(). More...

bool	endsWith (const XalanDOMChar theString, const XalanDOMChar theSubstring)
	Simulates the java String method endsWith(). More...

bool	endsWith (const XalanDOMString &theString, const XalanDOMString &theSubstring)
	Simulates the java String method endsWith(). More...

	PointerToDOMString (const void *theValue, XalanDOMString &theResult)
	Converts a pointer into a XalanDOMString. More...

	DoubleToDOMString (double theValue, XalanDOMString &theResult)
	Converts a double value into a XalanDOMString. More...

	LongToHexDOMString (long theValue, XalanDOMString &theResult)
	Converts a long value into a XalanDOMString. More...

	UnsignedLongToHexDOMString (unsigned long theValue, XalanDOMString &theResult)
	Converts an unsigned long value and appends the result to a XalanDOMString. More...

	LongToDOMString (long theValue, XalanDOMString &theResult)
	Converts a long value into a XalanDOMString. More...

	UnsignedLongToDOMString (unsigned long theValue, XalanDOMString &theResult)
	Converts an unsigned long value and appends the result to a XalanDOMString. More...

	WideStringToInt (const XalanDOMChar *theString)
	Converts a wide string into an integer value. More...

	WideStringToLong (const XalanDOMChar *theString)
	Converts a wide string into a long value. More...

	WideStringToUnsignedLong (const XalanDOMChar *theString)
	Converts a wide string into an unsigned long value. More...

	WideStringToDouble (const XalanDOMChar *theString, MemoryManager &theMemoryManager)
	Converts a wide string into a double value. More...

int	DOMStringToInt (const XalanDOMString &theString)
	Converts a XalanDOMString into an integer value. More...

long	DOMStringToLong (const XalanDOMString &theString)
	Converts a XalanDOMString into a long value. More...

unsigned long	DOMStringToUnsignedLong (const XalanDOMString &theString)
	Converts a XalanDOMString into a long value. More...

double	DOMStringToDouble (const XalanDOMString &theString, MemoryManager &theMemoryManager)
	Converts a XalanDOMString into a double value. More...

	OutputString (XalanOutputStream &theStream, const CharVectorType &theString)
	Outputs the target string to the specified stream. More...

	OutputString (std::ostream &theStream, const CharVectorType &theString)
	Outputs the target string to the specified stream. More...

	OutputString (XalanOutputStream &theStream, const XalanDOMChar *theString)
	Outputs the target string to the specified stream. More...

	OutputString (std::ostream &theStream, const XalanDOMChar *theString, MemoryManager &theMemoryManager)
	Outputs the target string to the specified stream. More...

void	OutputString (XalanOutputStream &theStream, const XalanDOMString &theString)
	Outputs the target string to the specified stream. More...

void	OutputString (std::ostream &theStream, const XalanDOMString &theString, MemoryManager &theMemoryManager)
	Outputs the target string to the specified stream. More...

XalanOutputStream &	operator<< (XalanOutputStream &theStream, const CharVectorType &theString)
	Outputs the string to the specified stream. More...

std::ostream &	operator<< (std::ostream &theStream, const CharVectorType &theString)
	Outputs the string to the specified stream. More...

XalanOutputStream &	operator<< (XalanOutputStream &theStream, const XalanDOMChar *theString)
	Outputs the target string to the specified stream. More...

std::ostream &	operator<< (std::ostream &theStream, const XalanDOMChar *theString)
	Outputs the target string to the specified stream. More...

XalanOutputStream &	operator<< (XalanOutputStream &theStream, const XalanDOMString &theString)
	Outputs the target string to the specified stream. More...

std::ostream &	operator<< (std::ostream &theStream, const XalanDOMString &theString)
	Outputs the target string to the specified stream. More...

std::ostream &	operator<< (std::ostream &theStream, XalanDOMString &theString)
	Outputs the target string to the specified stream. More...

XalanDOMChar	charAt (const XalanDOMString &theString, XalanDOMString::size_type theIndex)
	Retrieves a character at a specified index in the target string. More...

bool	isXMLWhitespace (XalanDOMChar theChar)
	Determines whether character represents white space. More...

bool	isXMLDigit (XalanDOMChar theChar)
	Determines whether character represents a digit. More...

bool	isXMLLetterOrDigit (XalanDOMChar theChar)
	Determines whether character represents a letter or digit. More...

	substring (const XalanDOMChar *theString, XalanDOMString &theSubstring, XalanDOMString::size_type theStartIndex, XalanDOMString::size_type theEndIndex=XalanDOMString::npos)
	Simulates the java String method substring(). More...

	substring (const XalanDOMString &theString, XalanDOMString &theSubstring, XalanDOMString::size_type theStartIndex, XalanDOMString::size_type theEndIndex=XalanDOMString::npos)
	Simulates the java String method substring(). More...

	substring (const XalanDOMString &theString, XalanDOMString::size_type theStartIndex, XalanDOMString &theResult, XalanDOMString::size_type theEndIndex=XalanDOMString::npos)
	Simulates the java String method substring(). More...

XalanDOMChar	toLowerASCII (XalanDOMChar theChar)
	Converts ASCII alphabetic characters from upper case to lower case. More...

XalanDOMChar	toUpperASCII (XalanDOMChar theChar)
	Converts ASCII alphabetic characters from lower case to upper case. More...

	toLowerCaseASCII (const XalanDOMChar *theString, XalanDOMString &theResult)
	Converts ASCII alphabetic characters from upper case to lower case. More...

	toLowerCaseASCII (const XalanDOMString &theString, XalanDOMString &theResult)
	Converts ASCII alphabetic characters from upper case to lower case. More...

	toLowerCaseASCII (XalanDOMString &theString)
	Converts ASCII alphabetic characters from upper case to lower case. More...

	toUpperCaseASCII (const XalanDOMChar *theString, XalanDOMString &theResult)
	Converts ASCII alphabetic characters from lower case to upper case. More...

	toUpperCaseASCII (const XalanDOMString &theString, XalanDOMString &theResult)
	Converts ASCII alphabetic characters from lower case to upper case. More...

	toUpperCaseASCII (XalanDOMString &theString)
	Converts ASCII alphabetic characters from lower case to upper case. More...

	compare (const CharVectorType &theLHS, const CharVectorType &theRHS)
	Compare the contents of two strings. More...

	compare (const XalanDOMChar theLHS, XalanDOMString::size_type theLHSLength, const XalanDOMChar theRHS, XalanDOMString::size_type theRHSLength)
	Compare the contents of two character arrays. More...

int	compare (const XalanDOMChar theLHS, const XalanDOMChar theRHS)
	Compare the contents of two null-terminated strings. More...

int	compare (const XalanDOMString &theLHS, const XalanDOMString &theRHS)
	Compare the contents of two strings. More...

int	compare (const XalanDOMChar *theLHS, const XalanDOMString &theRHS)
	Compare the contents of two strings. More...

int	compare (const XalanDOMString &theLHS, const XalanDOMChar *theRHS)
	Compare the contents of two strings. More...

	compareIgnoreCaseASCII (const XalanDOMChar theLHS, XalanDOMString::size_type theLHSLength, const XalanDOMChar theRHS, XalanDOMString::size_type theRHSLength)
	Compare the contents of two arrays in a case insensitive manner. More...

int	compareIgnoreCaseASCII (const XalanDOMChar theLHS, const XalanDOMChar theRHS)
	Compare the contents of two strings, in a case insensitive manner. More...

int	compareIgnoreCaseASCII (const XalanDOMString &theLHS, const XalanDOMString &theRHS)
	Compare the contents of two strings, in a case insensitive manner. More...

int	compareIgnoreCaseASCII (const XalanDOMString &theLHS, const XalanDOMChar *theRHS)
	Compare the contents of two strings, in a case insensitive manner. More...

int	compareIgnoreCaseASCII (const XalanDOMChar *theLHS, const XalanDOMString &theRHS)
	Compare the contents of two strings, in a case insensitive manner. More...

	collationCompare (const XalanDOMChar theLHS, XalanDOMString::size_type theLHSLength, const XalanDOMChar theRHS, XalanDOMString::size_type theRHSLength)
	Compare the contents of two character arrays. More...

int	collationCompare (const XalanDOMChar theLHS, const XalanDOMChar theRHS)
	Compare the contents of two strings. More...

int	collationCompare (const XalanDOMString &theLHS, const XalanDOMString &theRHS)
	Compare the contents of two strings. More...

int	collationCompare (const XalanDOMChar *theLHS, const XalanDOMString &theRHS)
	Compare the contents of two strings. More...

int	collationCompare (const XalanDOMString &theLHS, const XalanDOMChar *theRHS)
	Compare the contents of two strings. More...

	equals (const XalanDOMChar theLHS, const XalanDOMChar theRHS, XalanDOMString::size_type theLength)
	Compare the contents of two arrays for equality. More...

bool	equals (const XalanDOMChar theLHS, XalanDOMString::size_type theLHSLength, const XalanDOMChar theRHS, XalanDOMString::size_type theRHSLength)
	Compare the contents of two arrays for equality. More...

bool	equals (const XalanDOMChar theLHS, const XalanDOMChar theRHS)
	Compare the contents of two strings for equality. More...

bool	equals (const XalanDOMString &theLHS, const XalanDOMString &theRHS)
	Compare the contents of two strings for equality. More...

bool	equals (const XalanDOMChar *theLHS, const XalanDOMString &theRHS)
	Compare the contents of two strings for equality. More...

bool	equals (const XalanDOMString &theLHS, const XalanDOMChar *theRHS)
	Compare the contents of two strings for equality. More...

bool	equals (const XalanDOMString &theLHS, const XalanDOMChar *theRHS, XalanDOMString::size_type theRHSLength)
	Compare the contents of two strings for equality. More...

	equalsIgnoreCaseASCII (const XalanDOMChar theLHS, const XalanDOMChar theRHS, XalanDOMString::size_type theLength)
	Compare the contents of two arrays for equality, without regard for case. More...

bool	equalsIgnoreCaseASCII (const XalanDOMChar theLHS, XalanDOMString::size_type theLHSLength, const XalanDOMChar theRHS, XalanDOMString::size_type theRHSLength)
	Compare the contents of two strings for equality, without regard for case. More...

bool	equalsIgnoreCaseASCII (const XalanDOMChar theLHS, const XalanDOMChar theRHS)
	Compare the contents of two strings for equality, without regard for case. More...

bool	equalsIgnoreCaseASCII (const XalanDOMString &theLHS, const XalanDOMString &theRHS)
	Compare the contents of two strings for equality, without regard for case Only the characters A-Z and a-z are considered. More...

bool	equalsIgnoreCaseASCII (const XalanDOMChar *theLHS, const XalanDOMString &theRHS)
	Compare the contents of two strings for equality, without regard for case. More...

bool	equalsIgnoreCaseASCII (const XalanDOMString &theLHS, const XalanDOMChar *theRHS)
	Compare the contents of two strings for equality, without regard for case. More...

bool	operator< (const CharVectorType &theLHS, const CharVectorType &theRHS)
	Implements operator< for CharVectorType. More...

bool	operator< (const XalanDOMString &theLHS, const XalanDOMString &theRHS)
	Implements operator< for DOMStrings. More...

XalanDOMString &	assign (XalanDOMString &theString, const XalanDOMString &theStringToAssign)
	Assign one string to another. More...

XalanDOMString &	assign (XalanDOMString &theString, const XalanDOMChar *theStringToAssign, XalanDOMString::size_type theStringToAssignLength=XalanDOMString::npos)
	Assign one string to another. More...

XalanDOMString &	append (XalanDOMString &theString, const XalanDOMString &theStringToAppend)
	Concatenate two strings. More...

XalanDOMString &	append (XalanDOMString &theString, const XalanDOMChar *theStringToAppend, XalanDOMString::size_type theStringToAppendLength=XalanDOMString::npos)
	Concatenate two strings. More...

XalanDOMString &	append (XalanDOMString &theString, const char *theStringToAppend, XalanDOMString::size_type theStringToAppendLength=XalanDOMString::npos)
	Concatenate two strings. More...

XalanDOMString &	append (XalanDOMString &theString, const XalanDOMChar theCharToAppend)
	Concatenate a string and a character. More...

XalanDOMString &	append (XalanDOMString &theString, char theCharToAppend)
	Concatenate a string and a character. More...

XalanDOMString &	insert (XalanDOMString &theString, XalanDOMString::size_type thePosition, const XalanDOMString &theStringToInsert)
	Insert a string into another string. More...

XalanDOMString &	insert (XalanDOMString &theString, XalanDOMString::size_type thePosition, const XalanDOMChar *theStringToInsert)
	Insert a string into another string. More...

	trim (const XalanDOMString &theString, XalanDOMString &theResult)
	Remove trailing whitespace. More...

void	clear (XalanDOMString &theString)
	Remove all elements from target string. More...

void	erase (XalanDOMString &theString)
	Remove all elements from target string. More...

void	releaseMemory (XalanDOMString &theString, MemoryManagerType &theManager)
	Remove all elements from target string and frees all allocated memory. More...

	CopyWideStringToVector (const XalanDOMChar *theString, CharVectorType &theVector)

	CopyStringToVector (const char *theString, CharVectorType &theVector)

	MakeXalanDOMCharVector (const char *data, XalanDOMCharVectorType &result, bool fTranscode=true)
	Utility function to make a null-terminated vector of XMLChs, from a null-terminated array of chars, via transcoding, if requested. More...

	MakeXalanDOMCharVector (const XalanDOMChar *data, XalanDOMCharVectorType &result)
	Utility function to make a null-terminated vector of XMLChs, from a null-terminated array of XalanDOMChar. More...

XalanDOMCharVectorType &	MakeXalanDOMCharVector (const XalanDOMString &data, XalanDOMCharVectorType &result)
	Utility function to make a null-terminated vector of XMLChs, from a XalanDOMString. More...

	isXMLWhitespace (const XalanDOMString &string)
	Determines if the string contains only whitespace. More...

	isXMLWhitespace (const XalanDOMChar ch[], XalanDOMString::size_type start, XalanDOMString::size_type length)
	Determines if a range in an array contains only whitespace. More...

bool	isXMLWhitespace (const XalanDOMChar *theString)
	Determines if a null-terminated string contains only whitespace. More...

Macro Definition Documentation

#define XALAN_STATIC_UCODE_STRING ( str ) str

Function Documentation

XalanDOMString& append	(	XalanDOMString &	theString,
		const XalanDOMString &	theStringToAppend
	)

Concatenate two strings.

Parameters

theString	target string
theStringToAppend	string to add to target

Returns: a reference to the target string

XalanDOMString& append	(	XalanDOMString &	theString,
		const XalanDOMChar *	theStringToAppend,
		XalanDOMString::size_type	theStringToAppendLength = `XalanDOMString::npos`
	)

Concatenate two strings.

Parameters

theString	target string
theStringToAppend	string to add to target
theStringToAppendLength	length of the string (XalanDOMString::npos implies the string is null-terminated)

Returns: a reference to the target string

XalanDOMString& append	(	XalanDOMString &	theString,
		const char *	theStringToAppend,
		XalanDOMString::size_type	theStringToAppendLength = `XalanDOMString::npos`
	)

Concatenate two strings.

Parameters

theString	target string
theStringToAppend	string to add to target
theStringToAppendLength	length of the string (XalanDOMString::npos implies the string is null-terminated)

Returns: string with contents of 'theStringToAppend' added to target string

XalanDOMString& append	(	XalanDOMString &	theString,
		const XalanDOMChar	theCharToAppend
	)

Concatenate a string and a character.

Parameters

theString	target string
theCharToAppend	the character to add to the target

Returns: string with the character appended

XalanDOMString& append	(	XalanDOMString &	theString,
		char	theCharToAppend
	)

Concatenate a string and a character.

Parameters

theString	target string
theCharToAppend	the character to add to the target

Returns: string with the character appended

XalanDOMString& assign	(	XalanDOMString &	theString,
		const XalanDOMString &	theStringToAssign
	)

Assign one string to another.

Parameters

theString	target string
theStringToAppend	string to assign
theStringToAppendLength	length of the string (XalanDOMString::npos implies the string is null-terminated)

Returns: a reference to the target string

XalanDOMString& assign	(	XalanDOMString &	theString,
		const XalanDOMChar *	theStringToAssign,
		XalanDOMString::size_type	theStringToAssignLength = `XalanDOMString::npos`
	)

Assign one string to another.

Parameters

theString	target string
theStringToAppend	string to assign
theStringToAppendLength	length of the string (XalanDOMString::npos implies the string is null-terminated)

Returns: a reference to the target string

const char* c_str ( const CharVectorType & theString )

Get the underlying representation of the target CharVectorType as a null-terminated string.

Parameters

theString target string

Returns: null-terminated string of chars

const XalanDOMChar* c_wstr ( const XalanDOMString & theString )

Get the underlying representation of the target XalanDOMString as a null-terminated string.

Parameters

theString target string

Returns: null-terminated string of XalanDOMChar

const XalanDOMChar* c_wstr ( const XalanDOMChar * theString )

Get the underlying representation of the wide string as a UNICODE null-terminated string.

This is here simply for consistency in the code. On certain platforms, compiler- generated wide strings will not contain Unicode code points. Another macro converts those into XalanDOMStrings, which are then transcoded. In these cases, the previous defined c_sstr() function gets called.

On platforms where the compiler does generate Unicode wide strings, this function will be called instead.

Parameters

theString target string

Returns: null-terminated string of XalanDOMChar

XalanDOMChar charAt	(	const XalanDOMString &	theString,
		XalanDOMString::size_type	theIndex
	)

Retrieves a character at a specified index in the target string.

Parameters

theString	target string
theIndex	index of character

Returns: character at specified index

void clear ( XalanDOMString & theString )

Remove all elements from target string.

Parameters

theString target string

collationCompare	(	const XalanDOMChar *	theLHS,
		XalanDOMString::size_type	theLHSLength,
		const XalanDOMChar *	theRHS,
		XalanDOMString::size_type	theRHSLength
	)

Compare the contents of two character arrays.

Parameters

theLHS	first array to compare
theLHSLength	the length of the first array
theRHS	second array to compare
theRHSLength	the length of the second array

Returns: Returns 0 for equal arrays, less than 0 if theLHS is less than theRHS, or greater than 0 if theRHS is greater than theLHS.

int collationCompare	(	const XalanDOMChar *	theLHS,
		const XalanDOMChar *	theRHS
	)

Compare the contents of two strings.

Parameters

theLHS	first string to compare
theRHS	second string to compare

Returns: Returns 0 for equal strings, less than 0 if theLHS is less than theRHS, or greater than 0 if theRHS is greater than theLHS.

See also: operator<(); compare()

int collationCompare	(	const XalanDOMString &	theLHS,
		const XalanDOMString &	theRHS
	)

Compare the contents of two strings.

Parameters

theLHS	first string to compare
theRHS	second string to compare

Returns: Returns 0 for equal strings, less than 0 if theLHS is less than theRHS, or greater than 0 if theRHS is greater than theLHS.

See also: operator<(); compare()

int collationCompare	(	const XalanDOMChar *	theLHS,
		const XalanDOMString &	theRHS
	)

Compare the contents of two strings.

Parameters

theLHS	first string to compare
theRHS	second string to compare

Returns: Returns 0 for equal strings, less than 0 if theLHS is less than theRHS, or greater than 0 if theRHS is greater than theLHS.

int collationCompare	(	const XalanDOMString &	theLHS,
		const XalanDOMChar *	theRHS
	)

Compare the contents of two strings.

Parameters

theLHS	first string to compare
theRHS	second string to compare

Returns: Returns 0 for equal strings, less than 0 if theLHS is less than theRHS, or greater than 0 if theRHS is greater than theLHS.

compare	(	const CharVectorType &	theLHS,
		const CharVectorType &	theRHS
	)

Compare the contents of two strings.

THIS FUNCTION DOES NOT COMPARE STRINGS LIKE strcmp() OR ANY OTHER "COLLATION" ALGORITHM.

Parameters

theLHS	first string to compare
theRHS	second string to compare

Returns: Returns 0 for equal strings, less than 0 if theLHS is less than theRHS, or greater than 0 if theRHS is greater than theLHS.

See also: operator<()

compare	(	const XalanDOMChar *	theLHS,
		XalanDOMString::size_type	theLHSLength,
		const XalanDOMChar *	theRHS,
		XalanDOMString::size_type	theRHSLength
	)

Compare the contents of two character arrays.

THIS FUNCTION DOES NOT COMPARE STRINGS LIKE strcmp() OR ANY OTHER "COLLATION" ALGORITHM.

Parameters

theLHS	first array to compare
theLHSLength	the length of the first array
theRHS	second array to compare
theRHSLength	the length of the second array

Returns: Returns 0 for equal arrays, less than 0 if theLHS is less than theRHS, or greater than 0 if theRHS is greater than theLHS.

int compare	(	const XalanDOMChar *	theLHS,
		const XalanDOMChar *	theRHS
	)

Compare the contents of two null-terminated strings.

THIS FUNCTION DOES NOT COMPARE STRINGS LIKE strcmp() OR ANY OTHER "COLLATION" ALGORITHM.

Parameters

theLHS	first string to compare
theRHS	second string to compare

Returns: Returns 0 for equal strings, less than 0 if theLHS is less than theRHS, or greater than 0 if theRHS is greater than theLHS.

int compare	(	const XalanDOMString &	theLHS,
		const XalanDOMString &	theRHS
	)

Compare the contents of two strings.

THIS FUNCTION DOES NOT COMPARE STRINGS LIKE strcmp() OR ANY OTHER "COLLATION" ALGORITHM.

Parameters

theLHS	first string to compare
theRHS	second string to compare

Returns: Returns 0 for equal strings, less than 0 if theLHS is less than theRHS, or greater than 0 if theRHS is greater than theLHS.

See also: operator<(); collationCompare()

int compare	(	const XalanDOMChar *	theLHS,
		const XalanDOMString &	theRHS
	)

Compare the contents of two strings.

THIS FUNCTION DOES NOT COMPARE STRINGS LIKE strcmp() OR ANY OTHER "COLLATION" ALGORITHM.

Parameters

theLHS	first string to compare
theRHS	second string to compare

Returns: Returns 0 for equal strings, less than 0 if theLHS is less than theRHS, or greater than 0 if theRHS is greater than theLHS.

int compare	(	const XalanDOMString &	theLHS,
		const XalanDOMChar *	theRHS
	)

Compare the contents of two strings.

THIS FUNCTION DOES NOT COMPARE STRINGS LIKE strcmp() OR ANY OTHER "COLLATION" ALGORITHM.

Parameters

theLHS	first string to compare
theRHS	second string to compare

Returns: Returns 0 for equal strings, less than 0 if theLHS is less than theRHS, or greater than 0 if theRHS is greater than theLHS.

compareIgnoreCaseASCII	(	const XalanDOMChar *	theLHS,
		XalanDOMString::size_type	theLHSLength,
		const XalanDOMChar *	theRHS,
		XalanDOMString::size_type	theRHSLength
	)

Compare the contents of two arrays in a case insensitive manner.

Only the characters a-z and A-Z are considered as characters with "case".

THIS FUNCTION DOES NOT COMPARE STRINGS LIKE strcmp() OR ANY OTHER "COLLATION" ALGORITHM.

Parameters

theLHS	first array to compare
theLHSLength	the length of the first array
theRHS	second array to compare
theRHSLength	the length of the second array

Returns: Returns 0 for equal arrays, less than 0 if theLHS is less than theRHS, or greater than 0 if theRHS is greater than theLHS.

int compareIgnoreCaseASCII	(	const XalanDOMChar *	theLHS,
		const XalanDOMChar *	theRHS
	)

Compare the contents of two strings, in a case insensitive manner.

Only the characters a-z and A-Z are considered as characters with "case".

THIS FUNCTION DOES NOT COMPARE STRINGS LIKE strcmp() OR ANY OTHER "COLLATION" ALGORITHM.

Parameters

theLHS	first string to compare
theRHS	second string to compare

Returns: Returns 0 for equal strings, less than 0 if theLHS is less than theRHS, or greater than 0 if theRHS is greater than theLHS.

int compareIgnoreCaseASCII	(	const XalanDOMString &	theLHS,
		const XalanDOMString &	theRHS
	)

Compare the contents of two strings, in a case insensitive manner.

Only the characters a-z and A-Z are considered as characters with "case".

THIS FUNCTION DOES NOT COMPARE STRINGS LIKE strcmp() OR ANY OTHER "COLLATION" ALGORITHM.

Parameters

theLHS	first string to compare
theRHS	second string to compare

Returns: Returns 0 for equal strings, less than 0 if theLHS is less than theRHS, or greater than 0 if theRHS is greater than theLHS.

See also: operator<; collationCompare

int compareIgnoreCaseASCII	(	const XalanDOMString &	theLHS,
		const XalanDOMChar *	theRHS
	)

Compare the contents of two strings, in a case insensitive manner.

Only the characters a-z and A-Z are considered as characters with "case".

THIS FUNCTION DOES NOT COMPARE STRINGS LIKE strcmp() OR ANY OTHER "COLLATION" ALGORITHM.

Parameters

theLHS	first string to compare
theRHS	second string to compare

Returns: Returns 0 for equal strings, less than 0 if theLHS is less than theRHS, or greater than 0 if theRHS is greater than theLHS.

int compareIgnoreCaseASCII	(	const XalanDOMChar *	theLHS,
		const XalanDOMString &	theRHS
	)

Compare the contents of two strings, in a case insensitive manner.

Only the characters a-z and A-Z are considered for the comparison.

THIS FUNCTION DOES NOT COMPARE STRINGS LIKE strcmp() OR ANY OTHER "COLLATION" ALGORITHM.

Parameters

theLHS	first string to compare
theRHS	second string to compare

Returns: Returns 0 for equal strings, less than 0 if theLHS is less than theRHS, or greater than 0 if theRHS is greater than theLHS.

CopyStringToVector	(	const char *	theString,
		CharVectorType &	theVector
	)

CopyWideStringToVector	(	const XalanDOMChar *	theString,
		CharVectorType &	theVector
	)

double DOMStringToDouble	(	const XalanDOMString &	theString,
		MemoryManager &	theMemoryManager
	)

Converts a XalanDOMString into a double value.

Parameters

theString	target string
theMemoryManager	The MemoryManager instance to use.

Returns: double value of target string

int DOMStringToInt ( const XalanDOMString & theString )

Converts a XalanDOMString into an integer value.

Parameters

theString target string

Returns: integer value of target string

long DOMStringToLong ( const XalanDOMString & theString )

Converts a XalanDOMString into a long value.

Parameters

theString target string

Returns: long value of target string

unsigned long DOMStringToUnsignedLong ( const XalanDOMString & theString )

Converts a XalanDOMString into a long value.

Parameters

theString target string

Returns: unsigned long value of target string

DoubleToDOMString	(	double	theValue,
		XalanDOMString &	theResult
	)

Converts a double value into a XalanDOMString.

Parameters

theValue	number to be converted
theResult	the string to append with the result

Returns: a reference to the passed string result.

endsWith	(	const XalanDOMChar *	theString,
		XalanDOMString::size_type	theStringLength,
		const XalanDOMChar *	theSubstring,
		XalanDOMString::size_type	theSubstringLength
	)

Simulates the java String method endsWith().

Parameters

theString	target string to search
theSubstring	substring searched for

Returns: true if the target string ends with the substring

bool endsWith	(	const XalanDOMChar *	theString,
		const XalanDOMChar *	theSubstring
	)

Simulates the java String method endsWith().

Parameters

theString	target string to search
theSubstring	substring searched for

Returns: true if the target string ends with the substring

bool endsWith	(	const XalanDOMString &	theString,
		const XalanDOMString &	theSubstring
	)

Simulates the java String method endsWith().

Parameters

theString	target string to search
theSubstring	substring searched for

Returns: true if the target string ends with the substring

equals	(	const XalanDOMChar *	theLHS,
		const XalanDOMChar *	theRHS,
		XalanDOMString::size_type	theLength
	)

Compare the contents of two arrays for equality.

Parameters

theLHS	first array to compare
theRHS	second array to compare
theLength	the length of the arrays

Returns: true if the contents of both arrays are identical

bool equals	(	const XalanDOMChar *	theLHS,
		XalanDOMString::size_type	theLHSLength,
		const XalanDOMChar *	theRHS,
		XalanDOMString::size_type	theRHSLength
	)

Compare the contents of two arrays for equality.

Parameters

theLHS	first array to compare
theLHSLength	the length of the theLHS
theRHS	second array to compare
theRHSLength	the length of the theRHS

Returns: true if the contents of both arrays are identical

bool equals	(	const XalanDOMChar *	theLHS,
		const XalanDOMChar *	theRHS
	)

Compare the contents of two strings for equality.

Parameters

theLHS	first string to compare
theRHS	second string to compare

Returns: true if the contents of both strings are identical

bool equals	(	const XalanDOMString &	theLHS,
		const XalanDOMString &	theRHS
	)

Compare the contents of two strings for equality.

Parameters

theLHS	first string to compare
theRHS	second string to compare

Returns: true if the contents of both strings are identical

bool equals	(	const XalanDOMChar *	theLHS,
		const XalanDOMString &	theRHS
	)

Compare the contents of two strings for equality.

Parameters

theLHS	first string to compare
theRHS	second string to compare

Returns: true if the contents of both strings are identical

bool equals	(	const XalanDOMString &	theLHS,
		const XalanDOMChar *	theRHS
	)

Compare the contents of two strings for equality.

Parameters

theLHS	first string to compare
theRHS	second string to compare

Returns: true if the contents of both strings are identical

bool equals	(	const XalanDOMString &	theLHS,
		const XalanDOMChar *	theRHS,
		XalanDOMString::size_type	theRHSLength
	)

Compare the contents of two strings for equality.

Parameters

theLHS	first string to compare
theRHS	second string to compare
theRHSLength	the length of the theRHS

Returns: true if the contents of both strings are identical

equalsIgnoreCaseASCII	(	const XalanDOMChar *	theLHS,
		const XalanDOMChar *	theRHS,
		XalanDOMString::size_type	theLength
	)

Compare the contents of two arrays for equality, without regard for case.

Only the characters a-z and A-Z are considered characters with "case".

Parameters

theLHS	first string to compare
theRHS	second string to compare

Returns: true if the case-insensitive contents of both strings are identical

bool equalsIgnoreCaseASCII	(	const XalanDOMChar *	theLHS,
		XalanDOMString::size_type	theLHSLength,
		const XalanDOMChar *	theRHS,
		XalanDOMString::size_type	theRHSLength
	)

Compare the contents of two strings for equality, without regard for case.

Only the characters a-z and A-Z are considered characters with "case".

Parameters

theLHS	first string to compare
theLHSLength	the length of the theLHS
theRHS	second string to compare
theRHSLength	the length of the theRHS

Returns: true if both strings are identical

bool equalsIgnoreCaseASCII	(	const XalanDOMChar *	theLHS,
		const XalanDOMChar *	theRHS
	)

Compare the contents of two strings for equality, without regard for case.

Only the characters a-z and A-Z are considered characters with "case".

Parameters

theLHS	first string to compare
theRHS	second string to compare

Returns: true if both strings are identical

bool equalsIgnoreCaseASCII	(	const XalanDOMString &	theLHS,
		const XalanDOMString &	theRHS
	)

Compare the contents of two strings for equality, without regard for case Only the characters A-Z and a-z are considered.

Parameters

theLHS	first string to compare
theRHS	second string to compare

Returns: true if the case-insensitive contents of both strings are identical

bool equalsIgnoreCaseASCII	(	const XalanDOMChar *	theLHS,
		const XalanDOMString &	theRHS
	)

Compare the contents of two strings for equality, without regard for case.

Only the characters a-z and A-Z are considered characters with "case".

Parameters

theLHS	first string to compare
theRHS	second string to compare

Returns: true if the case-insensitive contents of both strings are identical

bool equalsIgnoreCaseASCII	(	const XalanDOMString &	theLHS,
		const XalanDOMChar *	theRHS
	)

Compare the contents of two strings for equality, without regard for case.

Only the characters A-Z and a-z are considered.

Parameters

theLHS	first string to compare
theRHS	second string to compare

Returns: true if the case-insensitive contents of both strings are identical

void erase ( XalanDOMString & theString )

Remove all elements from target string.

Parameters

theString target string

XalanDOMString::size_type indexOf	(	const XalanDOMChar *	theString,
		XalanDOMChar	theChar
	)

Simulates the java String method indexOf().

Parameters

theString	string to search
theChar	character searched for

Returns: the index of theChar in theString, or length(theString) if the character is not found.

XalanDOMString::size_type indexOf	(	const XalanDOMChar *	theString,
		XalanDOMString::size_type	theStringLength,
		XalanDOMChar	theChar
	)

Simulates the java String method indexOf().

Parameters

theString	string to search
theStringLength	the length of theString
theChar	character searched for

Returns: the index of theChar in theString, or length(theString) if the character is not found.

XalanDOMString::size_type indexOf	(	const XalanDOMString &	theString,
		XalanDOMChar	theChar
	)

Simulates the java String method indexOf().

Parameters

theString	string to search
theChar	character searched for

Returns: the index of theChar in theString, or length(theString) if the character is not found.

indexOf	(	const XalanDOMChar *	theString,
		XalanDOMString::size_type	theStringLength,
		const XalanDOMChar *	theSubstring,
		XalanDOMString::size_type	theSubstringLength
	)

Simulates the java String method indexOf().

Parameters

theString	string to search
theStringLength	length of the string to search
theSubstring	substring searched for
theSubstringLength	length of the substring searched for

Returns: the index of theSubstring in theString, or length(theString) if the string is not found.

indexOf	(	const XalanDOMChar *	theString,
		const XalanDOMChar *	theSubstring
	)

Simulates the java String method indexOf().

Parameters

theString	string to search
theSubstring	substring searched for

Returns: the index of theSubstring in theString, or length(theString) if the string is not found.

indexOf	(	const XalanDOMString &	theString,
		const XalanDOMString &	theSubstring
	)

Simulates the java String method indexOf().

Parameters

theString	string to search
theSubstring	substring searched for

Returns: the index of theSubstring in theString, or length(theString) if the string is not found.

XalanDOMString& insert	(	XalanDOMString &	theString,
		XalanDOMString::size_type	thePosition,
		const XalanDOMString &	theStringToInsert
	)

Insert a string into another string.

Parameters

theString	target string
thePosition	The position in the target string to insert
theStringToInsert	The string to insert

Returns: A reference to the target string

XalanDOMString& insert	(	XalanDOMString &	theString,
		XalanDOMString::size_type	thePosition,
		const XalanDOMChar *	theStringToInsert
	)

Insert a string into another string.

Parameters

theString	target string
thePosition	The position in the target string to insert
theStringToInsert	The string to insert

Returns: A reference to the target string

bool isEmpty ( const XalanDOMString & str )

Determines if the target string contains any elements.

Parameters

str	target string

Returns: true if the target string has a non-zero length

bool isXMLDigit ( XalanDOMChar theChar )

Determines whether character represents a digit.

Parameters

theChar target character

Returns: true if character represents a digit

bool isXMLLetterOrDigit ( XalanDOMChar theChar )

Determines whether character represents a letter or digit.

Parameters

theChar target character

Returns: true if character represents a letter or digit

bool isXMLWhitespace ( XalanDOMChar theChar )

Determines whether character represents white space.

Parameters

theChar target character

Returns: true if character represents white space

isXMLWhitespace ( const XalanDOMString & string )

Determines if the string contains only whitespace.

Parameters

theString target string

Returns: true if string contains only whitespace

isXMLWhitespace	(	const XalanDOMChar	ch[],
		XalanDOMString::size_type	start,
		XalanDOMString::size_type	length
	)

Determines if a range in an array contains only whitespace.

Parameters

ch	target array
start	starting index to examine
length	number of characters to examine

Returns: true if specified range contains only whitespace

bool isXMLWhitespace ( const XalanDOMChar * theString )

Determines if a null-terminated string contains only whitespace.

Parameters

theString target string

Returns: true if the string contains only whitespace

lastIndexOf	(	const XalanDOMChar *	theString,
		XalanDOMChar	theChar
	)

Simulates the java String method lastIndexOf().

Parameters

theString	string to search
theChar	character searched for

Returns: the index of theChar in theString, or length(theString) if the character is not found.

XalanDOMString::size_type lastIndexOf	(	const XalanDOMString &	theString,
		XalanDOMChar	theChar
	)

Simulates the java String method lastIndexOf().

Parameters

theString	string to search
theChar	character searched for

Returns: the index of theChar in theString, or length(theString) if the character is not found.

XalanDOMString::size_type length ( const XalanDOMString & theString )

Get the length of a XalanDOMString.

Parameters

theString target string

Returns: the length of the target string

XalanDOMString::size_type length ( const XalanDOMChar * theString )

Get the length of a null-terminated string of XalanDOMChar characters.

Parameters

theString target string

Returns: the length of the target string

XalanDOMString::size_type length ( const char * theString )

Get the length of a null-terminated string.

Parameters

theString target string

Returns: the length of the target string

LongToDOMString	(	long	theValue,
		XalanDOMString &	theResult
	)

Converts a long value into a XalanDOMString.

Parameters

theValue	number to be converted
theResult	the string to append with the result

Returns: a reference to the passed string result.

LongToHexDOMString	(	long	theValue,
		XalanDOMString &	theResult
	)

Converts a long value into a XalanDOMString.

Negative values are ignored.

Parameters

theValue	number to be converted
theResult	the string to append with the result

Returns: a reference to the passed string result.

MakeXalanDOMCharVector	(	const char *	data,
		XalanDOMCharVectorType &	result,
		bool	fTranscode = `true`
	)

Utility function to make a null-terminated vector of XMLChs, from a null-terminated array of chars, via transcoding, if requested.

Parameters

data	array to be converted
whether	or not to transcode

Returns: null-terminated vector of XalanDOMChar

MakeXalanDOMCharVector	(	const XalanDOMChar *	data,
		XalanDOMCharVectorType &	result
	)

Utility function to make a null-terminated vector of XMLChs, from a null-terminated array of XalanDOMChar.

Parameters

data	array to be converted

Returns: null-terminated vector of XalanDOMChar

XalanDOMCharVectorType& MakeXalanDOMCharVector	(	const XalanDOMString &	data,
		XalanDOMCharVectorType &	result
	)

Utility function to make a null-terminated vector of XMLChs, from a XalanDOMString.

Parameters

data	XalanDOMString to be converted

Returns: null-terminated vector of XalanDOMChar

bool operator<	(	const CharVectorType &	theLHS,
		const CharVectorType &	theRHS
	)

Implements operator< for CharVectorType.

Parameters

theLHS	first string to compare
theRHS	second string to compare

Returns: Returns true if theLHS is lexically less than theRHS

See also: compare

bool operator<	(	const XalanDOMString &	theLHS,
		const XalanDOMString &	theRHS
	)

Implements operator< for DOMStrings.

Parameters

theLHS	first string to compare
theRHS	second string to compare

Returns: Returns true if theLHS is lexically less than theRHS

See also: compare

XalanOutputStream& operator<<	(	XalanOutputStream &	theStream,
		const CharVectorType &	theString
	)

Outputs the string to the specified stream.

Parameters

theStream	output stream
theString	the string to output

See also: OutputString

std::ostream& operator<<	(	std::ostream &	theStream,
		const CharVectorType &	theString
	)

Outputs the string to the specified stream.

Parameters

theStream	output stream
theString	the string to output

See also: OutputString

XalanOutputStream& operator<<	(	XalanOutputStream &	theStream,
		const XalanDOMChar *	theString
	)