Xalan-C++ API Documentation

The Xalan C++ XSLT Processor Version 1.10

DOMStringHelper.hpp File Reference

Go to the source code of this file.

Classes

Defines

Functions


Define Documentation

#define DOMSTRINGHELPER_HEADER_GUARD_1357924680

#define XALAN_STATIC_UCODE_STRING ( str   )     str


Function Documentation

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& 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,
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 *  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 XalanDOMString theStringToAppend 
)

Concatenate two strings.

Parameters:
theString target string
theStringToAppend string to add to target
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

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

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 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

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

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

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.

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 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 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()

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 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.

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 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 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.

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.

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<()

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.

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 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 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.

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.

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.

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

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

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 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

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 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 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 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 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

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 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

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 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 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 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

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

void erase ( XalanDOMString theString  ) 

Remove all elements from target string.

Parameters:
theString target string

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.

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 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.

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.

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 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& 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

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

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 ( const XalanDOMChar *  theString  ) 

Determines if a null-terminated string contains only whitespace.

Parameters:
theString target string
Returns:
true if the 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

isXMLWhitespace ( const XalanDOMString string  ) 

Determines if the string contains only whitespace.

Parameters:
theString target string
Returns:
true if string contains only whitespace

bool isXMLWhitespace ( XalanDOMChar  theChar  ) 

Determines whether character represents white space.

Parameters:
theChar target character
Returns:
true if character represents white space

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.

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 length ( const char *  theString  ) 

Get the length of a null-terminated string.

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 XalanDOMString theString  ) 

Get the length of a XalanDOMString.

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.

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

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

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

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

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

std::ostream& operator<< ( std::ostream &  theStream,
XalanDOMString theString 
)

Outputs the target string to the specified stream.

Parameters:
theStream output stream
theString target string
See also:
OutputString

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

Outputs the target string to the specified stream.

Parameters:
theStream output stream
theString target string
See also:
OutputString

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

Outputs the target string to the specified stream.

Parameters:
theStream output stream
theString target string
See also:
OutputString

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

Outputs the target string to the specified stream.

Parameters:
theStream output stream
theString target string
See also:
OutputString

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

Outputs the target string to the specified stream.

Parameters:
theStream output stream
theString target string
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 CharVectorType theString 
)

Outputs the string to the specified stream.

Parameters:
theStream output stream
theString the string to output
See also:
OutputString

void OutputString ( std::ostream &  theStream,
const XalanDOMString theString,
MemoryManager &  theMemoryManager 
)

Outputs the target string to the specified stream.

Parameters:
theStream output stream
theString target string
theMemoryManager The MemoryManager instance to use.
See also:
operator<<

void OutputString ( XalanOutputStream theStream,
const XalanDOMString theString 
)

Outputs the target string to the specified stream.

Parameters:
theStream output stream
theString target string
See also:
operator<<

OutputString ( std::ostream &  theStream,
const XalanDOMChar *  theString,
MemoryManager &  theMemoryManager 
)

Outputs the target string to the specified stream.

Parameters:
theStream output stream
theString target string
See also:
operator<<

OutputString ( XalanOutputStream theStream,
const XalanDOMChar *  theString 
)

Outputs the target string to the specified stream.

Parameters:
theStream output stream
theString target string
See also:
operator<<

OutputString ( std::ostream &  theStream,
const CharVectorType theString 
)

Outputs the target string to the specified stream.

Parameters:
theStream output stream
theString target string
See also:
operator<<

OutputString ( XalanOutputStream theStream,
const CharVectorType theString 
)

Outputs the target string to the specified stream.

Parameters:
theStream output stream
theString target string
See also:
operator<<

PointerToDOMString ( const void *  theValue,
XalanDOMString theResult 
)

Converts a pointer into a XalanDOMString.

Parameters:
theValue pointer to be converted
theResult the string to append with the result
Returns:
a reference to the passed string result.

void releaseMemory ( XalanDOMString theString,
MemoryManagerType theManager 
)

Remove all elements from target string and frees all allocated memory.

Parameters:
theString target string

void reserve ( XalanDOMString theString,
XalanDOMString::size_type  theCount 
)

Reserve some space in the string for more efficient concatenation.

..

Parameters:
theString target string
theCount The amount of space to reserve

bool startsWith ( const XalanDOMString theString,
const XalanDOMString theSubstring 
)

Simulates the java String method startsWith().

Parameters:
theDOMString target string to search
theSubstring substring searched for
Returns:
true if the target string begins with the substring

bool startsWith ( const XalanDOMString theString,
const XalanDOMChar *  theSubstring,
XalanDOMString::size_type  theSubstringLength 
)

Simulates the java String method startsWith().

Parameters:
theDOMString target string to search
theSubstring substring searched for
theSubstringLength the length of theSubstring
Returns:
true if the target string begins with the substring

bool startsWith ( const XalanDOMString theString,
const XalanDOMChar *  theSubstring 
)

Simulates the java String method startsWith().

Parameters:
theDOMString target string to search
theSubstring substring searched for
Returns:
true if the target string begins with the substring

bool startsWith ( const XalanDOMChar *  theString,
const XalanDOMString theSubstring 
)

Simulates the java String method startsWith().

Parameters:
theDOMString target string to search
theSubstring substring searched for
Returns:
true if the target string begins with the substring

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

Simulates the java String method startsWith().

Parameters:
theDOMString target string to search
theSubstring substring searched for
Returns:
true if the target string begins with the substring

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

Simulates the java String method startsWith().

Parameters:
theString target string to search
theStringLength the length of theString
theSubstring substring searched for
theSubstringLength the length of theSubstring
Returns:
true if the target string begins with the substring

substring ( const XalanDOMString theString,
XalanDOMString::size_type  theStartIndex,
XalanDOMString theResult,
XalanDOMString::size_type  theEndIndex = XalanDOMString::npos 
)

Simulates the java String method substring().

Returns a new string that is a substring of this string. The substring begins at the specified theStartIndex and extends to the character at index theEndIndex - 1. Thus the length of the substring is theEndIndex-theStartIndex.

Parameters:
theString source string
theStartIndex starting index, inclusive
theEndIndex ending index, exclusive
Returns:
string containing the specified range of characters from target

substring ( const XalanDOMString theString,
XalanDOMString theSubstring,
XalanDOMString::size_type  theStartIndex,
XalanDOMString::size_type  theEndIndex = XalanDOMString::npos 
)

Simulates the java String method substring().

Returns a new string that is a substring of this string. The substring begins at the specified theStartIndex and extends to the character at index theEndIndex - 1. Thus the length of the substring is theEndIndex - theStartIndex.

Parameters:
theString source string
theSubstring target string
theStartIndex starting index, inclusive
theEndIndex ending index, exclusive

substring ( const XalanDOMChar *  theString,
XalanDOMString theSubstring,
XalanDOMString::size_type  theStartIndex,
XalanDOMString::size_type  theEndIndex = XalanDOMString::npos 
)

Simulates the java String method substring().

Returns a new string that is a substring of this string. The substring begins at the specified theStartIndex and extends to the character at index theEndIndex - 1. Thus the length of the substring is theEndIndex - theStartIndex.

Parameters:
theString source string
theSubstring target string
theStartIndex starting index, inclusive
theEndIndex ending index, exclusive
Returns:
A reference to theSubstring

const char* toCharArray ( const CharVectorType theString  ) 

Get the underlying representation of the target CharVectorType as a pointer to an array of characters.

Parameters:
theString target string
Returns:
the pointer

const XalanDOMChar* toCharArray ( const XalanDOMChar *  theString  ) 

Get the underlying representation of a XalanDOMChar.

Parameters:
theString target string
Returns:
array of XalanDOMChar

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.

Parameters:
theString target string
Returns:
array of XalanDOMChar

XalanDOMChar toLowerASCII ( XalanDOMChar  theChar  ) 

Converts ASCII alphabetic characters from upper case to lower case.

This function works only with the Unicode characters A-Z.

Parameters:
theString target string
Returns:
string containing lower case characters

toLowerCaseASCII ( XalanDOMString theString  ) 

Converts ASCII alphabetic characters from upper case to lower case.

This function works only with the characters a-z and A-Z.

Parameters:
theString The string to convert
Returns:
A reference to theString

toLowerCaseASCII ( const XalanDOMString theString,
XalanDOMString theResult 
)

Converts ASCII alphabetic characters from upper case to lower case.

This function works only with the characters a-z and A-Z.

Parameters:
theString The source string
theResult The target string
Returns:
A reference to theResult

toLowerCaseASCII ( const XalanDOMChar *  theString,
XalanDOMString theResult 
)

Converts ASCII alphabetic characters from upper case to lower case.

This function works only with the characters a-z and A-Z.

Parameters:
theString The source string
theResult The target string
Returns:
A reference to theResult

XalanDOMChar toUpperASCII ( XalanDOMChar  theChar  ) 

Converts ASCII alphabetic characters from lower case to upper case.

This function works only with the Unicode characters a-z.

Parameters:
theString target string
Returns:
string containing upper case characters

toUpperCaseASCII ( XalanDOMString theString  ) 

Converts ASCII alphabetic characters from lower case to upper case.

This function works only with the characters a-z and A-Z.

Parameters:
theString The string to convert
Returns:
A reference to theString

toUpperCaseASCII ( const XalanDOMString theString,
XalanDOMString theResult 
)

Converts ASCII alphabetic characters from lower case to upper case.

This function works only with the characters a-z and A-Z.

Parameters:
theString The source string
theResult The target string
Returns:
A reference to theResult

toUpperCaseASCII ( const XalanDOMChar *  theString,
XalanDOMString theResult 
)

Converts ASCII alphabetic characters from lower case to upper case.

This function works only with the characters a-z and A-Z.

Parameters:
theString The source string
theResult The target string
Returns:
A reference to theResult

trim ( const XalanDOMString theString,
XalanDOMString theResult 
)

Remove trailing whitespace.

Parameters:
theString target string
Returns:
string with contents of target string less trailing whitespace

UnsignedLongToDOMString ( unsigned long  theValue,
XalanDOMString theResult 
)

Converts an unsigned long value and appends the result to a XalanDOMString.

Parameters:
theValue number to be converted
theResult the string to append with the result
Returns:
a reference to the passed string result.

UnsignedLongToHexDOMString ( unsigned long  theValue,
XalanDOMString theResult 
)

Converts an unsigned long value and appends the result to a XalanDOMString.

Parameters:
theValue number to be converted
theResult the string to append with the result
Returns:
a reference to the passed string result.

WideStringToDouble ( const XalanDOMChar *  theString,
MemoryManager &  theMemoryManager 
)

Converts a wide string into a double value.

Parameters:
theString target string
theMemoryManager The MemoryManager instance to use.
Returns:
double value of target string

WideStringToInt ( const XalanDOMChar *  theString  ) 

Converts a wide string into an integer value.

Parameters:
theString target string
Returns:
integer value of target string

WideStringToLong ( const XalanDOMChar *  theString  ) 

Converts a wide string into a long value.

Parameters:
theString target string
Returns:
long value of target string

WideStringToUnsignedLong ( const XalanDOMChar *  theString  ) 

Converts a wide string into an unsigned long value.

Parameters:
theString target string
Returns:
unsigned long value of target string

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 
)

Interpreting class diagrams

Doxygen and GraphViz are used to generate this API documentation from the Xalan-C header files.

dot

Xalan-C++ XSLT Processor Version 1.10
Copyright © 1999-2004 The Apache Software Foundation. All Rights Reserved.

Apache Logo