






















|
| |
Main Page Class Hierarchy Alphabetical List Compound List File List Compound Members File Members
XMLString Class ReferenceClass for representing native character strings and handling common string operations.
More...
#include <XMLString.hpp>
List of all members. Static Public Methods
| |
- void binToText ( const unsigned int toFormat , char* const toFill , const unsigned int maxChars , const unsigned int radix )
- Converts binary data to a text string based a given radix. More...
- void binToText ( const unsigned int toFormat , XMLCh* const toFill , const unsigned int maxChars , const unsigned int radix )
- Converts binary data to a text string based a given radix. More...
- void binToText ( const unsigned long toFormat , char* const toFill , const unsigned int maxChars , const unsigned int radix )
- Converts binary data to a text string based a given radix. More...
- void binToText ( const unsigned long toFormat , XMLCh* const toFill , const unsigned int maxChars , const unsigned int radix )
- Converts binary data to a text string based a given radix. More...
- void binToText ( const long toFormat , char* const toFill , const unsigned int maxChars , const unsigned int radix )
- Converts binary data to a text string based a given radix. More...
- void binToText ( const long toFormat , XMLCh* const toFill , const unsigned int maxChars , const unsigned int radix )
- Converts binary data to a text string based a given radix. More...
- void binToText ( const int toFormat , char* const toFill , const unsigned int maxChars , const unsigned int radix )
- Converts binary data to a text string based a given radix. More...
- void binToText ( const int toFormat , XMLCh* const toFill , const unsigned int maxChars , const unsigned int radix )
- Converts binary data to a text string based a given radix. More...
- bool textToBin ( const XMLCh* const toConvert , unsigned int& toFill )
- Converts a string of decimal chars to a binary value. More...
|
- void catString ( char* const target , const char* const src )
- Concatenates two strings. More...
- void catString ( XMLCh* const target , const XMLCh* const src )
- Concatenates two strings. More...
|
- int compareIString ( const char* const str1 , const char* const str2 )
- Lexicographically compares lowercase versions of
str1 and str2 and returns a value indicating their relationship. More...
- int compareIString ( const XMLCh* const str1 , const XMLCh* const str2 )
- Lexicographically compares lowercase versions of
str1 and str2 and returns a value indicating their relationship. More...
- int compareNString ( const char* const str1 , const char* const str2 , const unsigned int count )
- Lexicographically compares, at most, the first count characters in
str1 and str2 and returns a value indicating the relationship between the substrings. More...
- int compareNString ( const XMLCh* const str1 , const XMLCh* const str2 , const unsigned int count )
- Lexicographically compares, at most, the first count characters in
str1 and str2 and returns a value indicating the relationship between the substrings. More...
- int compareNIString ( const char* const str1 , const char* const str2 , const unsigned int count )
- Lexicographically compares, at most, the first count characters in
str1 and str2 without regard to case and returns a value indicating the relationship between the substrings. More...
- int compareNIString ( const XMLCh* const str1 , const XMLCh* const str2 , const unsigned int count )
- Lexicographically compares, at most, the first count characters in
str1 and str2 without regard to case and returns a value indicating the relationship between the substrings. More...
- int compareString ( const char* const str1 , const char* const str2 )
- Lexicographically compares
str1 and str2 and returns a value indicating their relationship. More...
- int compareString ( const XMLCh* const str1 , const XMLCh* const str2 )
- Lexicographically compares
str1 and str2 and returns a value indicating their relationship. More...
|
- void copyString ( char* const target , const char* const src )
- Copies
src , including the terminating null character, to the location specified by target . More...
- void copyString ( XMLCh* const target , const XMLCh* const src )
- Copies
src , including the terminating null character, to the location specified by target . More...
- bool copyNString ( XMLCh* const target , const XMLCh* const src , const unsigned int maxChars )
- Copies
src , upto a fixed number of characters, to the location specified by target . More...
|
- unsigned int hash ( const char* const tohash , const unsigned int hashModulus )
- Hashes a string given a modulus. More...
- unsigned int hash ( const XMLCh* const toHash , const unsigned int hashModulus )
- Hashes a string given a modulus. More...
- unsigned int hashN ( const XMLCh* const toHash , const unsigned int numChars , const unsigned int hashModulus )
- Hashes a string given a modulus taking a maximum number of characters as the limit. More...
|
- int indexOf (const char* const toSearch, const char ch)
- Provides the index of the first occurance of a character within a string. More...
- int indexOf (const XMLCh* const toSearch, const XMLCh ch)
- Provides the index of the first occurance of a character within a string. More...
- int lastIndexOf (const char* const toSearch, const char ch)
- Provides the index of the last occurance of a character within a string. More...
- int lastIndexOf (const XMLCh* const toSearch, const XMLCh ch)
- Provides the index of the last occurance of a character within a string. More...
- int lastIndexOf ( const char* const toSearch , const char chToFind , const unsigned int fromIndex )
- Provides the index of the last occurance of a character within a string starting backward from a given index. More...
- int lastIndexOf ( const XMLCh* const toSearch , const XMLCh ch , const unsigned int fromIndex )
- Provides the index of the last occurance of a character within a string starting backward from a given index. More...
|
- void moveChars ( XMLCh* const targetStr , const XMLCh* const srcStr , const unsigned int count )
- Moves X number of chars. More...
|
|
- bool startsWith ( const char* const toTest , const char* const prefix )
- Tells if the sub-string appears within a string at the beginning. More...
- bool startsWith ( const XMLCh* const toTest , const XMLCh* const prefix )
- Tells if the sub-string appears within a string at the beginning. More...
- bool startsWithI ( const char* const toTest , const char* const prefix )
- Tells if the sub-string appears within a string at the beginning without regard to case. More...
- bool startsWithI ( const XMLCh* const toTest , const XMLCh* const prefix )
- Tells if the sub-string appears within a string at the beginning without regard to case. More...
- const XMLCh* findAny ( const XMLCh* const toSearch , const XMLCh* const searchList )
- Tells if a string has any occurance of another string within itself. More...
- XMLCh* findAny ( XMLCh* const toSearch , const XMLCh* const searchList )
- Tells if a string has any occurance of another string within itself. More...
- unsigned int stringLen (const char* const src)
- Get the length of the string. More...
- unsigned int stringLen (const XMLCh* const src)
- Get the length of the string. More...
|
- void cut ( XMLCh* const toCutFrom , const unsigned int count )
- Cut leading chars from a string. More...
- char* transcode ( const XMLCh* const toTranscode )
- Transcodes a string to native code-page. More...
- bool transcode ( const XMLCh* const toTranscode , char* const toFill , const unsigned int maxChars )
- Transcodes a string to native code-page. More...
- XMLCh* transcode ( const char* const toTranscode )
- Transcodes a string to native code-page. More...
- bool transcode ( const char* const toTranscode , XMLCh* const toFill , const unsigned int maxChars )
- Transcodes a string to native code-page. More...
- void trim (char* const toTrim)
- Trims off extra space characters from the end of the string. More...
- void trim (XMLCh* const toTrim)
- Trims off extra space characters from the end of the string. More...
|
- XMLCh* makeUName ( const XMLCh* const pszURI , const XMLCh* const pszName )
- Creates a UName from a URI and base name. More...
- unsigned int replaceTokens ( XMLCh* const errText , const unsigned int maxChars , const XMLCh* const text1 , const XMLCh* const text2 , const XMLCh* const text3 , const XMLCh* const text4 )
- Internal function to perform token replacement for strings. More...
- void upperCase (XMLCh* const toUpperCase)
- Converts a string to uppercase. More...
Friends
Detailed Description
Class for representing native character strings and handling common string operations.
This class is Unicode compliant. This class is designed primarily
for internal use, but due to popular demand, it is being made
publicly available. Users of this class must understand that this
is not an officially supported class. All public methods of this
class are static functions.
Member Function Documentation
void XMLString::binToText (
|
const int toFormat, |
|
XMLCh * const toFill, |
|
const unsigned int maxChars, |
|
const unsigned int radix) [static] |
|
Converts binary data to a text string based a given radix.
-
Parameters:
-
toFormat
|
The beginning of the input string to convert
|
toFill
|
The buffer that will hold the output on return. The
size of this buffer should at least be 'maxChars + 1'.
|
maxChars
|
The maximum number of output characters that can be
accepted. If the result will not fit, it is an error.
|
radix
|
The radix of the input data, based on which the conversion
will be done
|
void XMLString::binToText (
|
const int toFormat, |
|
char * const toFill, |
|
const unsigned int maxChars, |
|
const unsigned int radix) [static] |
|
Converts binary data to a text string based a given radix.
-
Parameters:
-
toFormat
|
The beginning of the input string to convert
|
toFill
|
The buffer that will hold the output on return. The
size of this buffer should at least be 'maxChars + 1'.
|
maxChars
|
The maximum number of output characters that can be
accepted. If the result will not fit, it is an error.
|
radix
|
The radix of the input data, based on which the conversion
will be done
|
void XMLString::binToText (
|
const long toFormat, |
|
XMLCh * const toFill, |
|
const unsigned int maxChars, |
|
const unsigned int radix) [static] |
|
Converts binary data to a text string based a given radix.
-
Parameters:
-
toFormat
|
The beginning of the input string to convert
|
toFill
|
The buffer that will hold the output on return. The
size of this buffer should at least be 'maxChars + 1'.
|
maxChars
|
The maximum number of output characters that can be
accepted. If the result will not fit, it is an error.
|
radix
|
The radix of the input data, based on which the conversion
will be done
|
void XMLString::binToText (
|
const long toFormat, |
|
char * const toFill, |
|
const unsigned int maxChars, |
|
const unsigned int radix) [static] |
|
Converts binary data to a text string based a given radix.
-
Parameters:
-
toFormat
|
The beginning of the input string to convert
|
toFill
|
The buffer that will hold the output on return. The
size of this buffer should at least be 'maxChars + 1'.
|
maxChars
|
The maximum number of output characters that can be
accepted. If the result will not fit, it is an error.
|
radix
|
The radix of the input data, based on which the conversion
will be done
|
void XMLString::binToText (
|
const unsigned long toFormat, |
|
XMLCh * const toFill, |
|
const unsigned int maxChars, |
|
const unsigned int radix) [static] |
|
Converts binary data to a text string based a given radix.
-
Parameters:
-
toFormat
|
The beginning of the input string to convert
|
toFill
|
The buffer that will hold the output on return. The
size of this buffer should at least be 'maxChars + 1'.
|
maxChars
|
The maximum number of output characters that can be
accepted. If the result will not fit, it is an error.
|
radix
|
The radix of the input data, based on which the conversion
will be done
|
void XMLString::binToText (
|
const unsigned long toFormat, |
|
char * const toFill, |
|
const unsigned int maxChars, |
|
const unsigned int radix) [static] |
|
Converts binary data to a text string based a given radix.
-
Parameters:
-
toFormat
|
The beginning of the input string to convert
|
toFill
|
The buffer that will hold the output on return. The
size of this buffer should at least be 'maxChars + 1'.
|
maxChars
|
The maximum number of output characters that can be
accepted. If the result will not fit, it is an error.
|
radix
|
The radix of the input data, based on which the conversion
will be done
|
void XMLString::binToText (
|
const unsigned int toFormat, |
|
XMLCh * const toFill, |
|
const unsigned int maxChars, |
|
const unsigned int radix) [static] |
|
Converts binary data to a text string based a given radix.
-
Parameters:
-
toFormat
|
The beginning of the input string to convert
|
toFill
|
The buffer that will hold the output on return. The
size of this buffer should at least be 'maxChars + 1'.
|
maxChars
|
The maximum number of output characters that can be
accepted. If the result will not fit, it is an error.
|
radix
|
The radix of the input data, based on which the conversion
will be done
|
void XMLString::binToText (
|
const unsigned int toFormat, |
|
char * const toFill, |
|
const unsigned int maxChars, |
|
const unsigned int radix) [static] |
|
Converts binary data to a text string based a given radix.
-
Parameters:
-
toFormat
|
The beginning of the input string to convert
|
toFill
|
The buffer that will hold the output on return. The
size of this buffer should at least be 'maxChars + 1'.
|
maxChars
|
The maximum number of output characters that can be
accepted. If the result will not fit, it is an error.
|
radix
|
The radix of the input data, based on which the conversion
will be done
|
void XMLString::catString (
|
XMLCh * const target, |
|
const XMLCh * const src) [static] |
|
Concatenates two strings.
catString appends src to target and
terminates the resulting string with a null character. The initial character of
src overwrites the terminating character of target .
No overflow checking is performed when strings are copied or appended.
The behavior of catString is undefined if source and destination
strings overlap.
-
Parameters:
-
target
|
Null-terminated destination string
|
src
|
Null-terminated source string
|
void XMLString::catString (
|
char * const target, |
|
const char * const src) [static] |
|
Concatenates two strings.
catString appends src to target and
terminates the resulting string with a null character. The initial character
of src overwrites the terminating character of target
.
No overflow checking is performed when strings are copied or appended.
The behavior of catString is undefined if source and
destination strings overlap.
-
Parameters:
-
target
|
Null-terminated destination string
|
src
|
Null-terminated source string
|
int XMLString::compareIString (
|
const XMLCh * const str1, |
|
const XMLCh * const str2) [static] |
|
Lexicographically compares lowercase versions of str1 and str2 and returns a value indicating their relationship.
-
Parameters:
-
str1
|
Null-terminated string to compare
|
str2
|
Null-terminated string to compare
|
-
Returns:
-
The return value indicates the relation of
str1 to
str2 as follows
Less than 0 means str1 is less than str2
Equal to 0 means str1 is identical to str2
Greater than 0 means str1 is more than str2
int XMLString::compareIString (
|
const char * const str1, |
|
const char * const str2) [static] |
|
Lexicographically compares lowercase versions of str1 and str2 and returns a value indicating their relationship.
-
Parameters:
-
str1
|
Null-terminated string to compare
|
str2
|
Null-terminated string to compare
|
-
Returns:
-
The return value indicates the relation of
str1 to
str2 as follows
Less than 0 means str1 is less than str2
Equal to 0 means str1 is identical to str2
Greater than 0 means str1 is more than str2
int XMLString::compareNIString (
|
const XMLCh * const str1, |
|
const XMLCh * const str2, |
|
const unsigned int count) [static] |
|
Lexicographically compares, at most, the first count characters in str1 and str2 without regard to case and returns a value indicating the relationship between the substrings.
-
Parameters:
-
str1
|
Null-terminated string to compare
|
str2
|
Null-terminated string to compare
|
count
|
The number of characters to compare
|
-
Returns:
-
The return value indicates the relation of
str1 to
str2 as follows
Less than 0 means str1 is less than str2
Equal to 0 means str1 is identical to str2
Greater than 0 means str1 is more than str2
int XMLString::compareNIString (
|
const char * const str1, |
|
const char * const str2, |
|
const unsigned int count) [static] |
|
Lexicographically compares, at most, the first count characters in str1 and str2 without regard to case and returns a value indicating the relationship between the substrings.
-
Parameters:
-
str1
|
Null-terminated string to compare
|
str2
|
Null-terminated string to compare
|
count
|
The number of characters to compare
|
-
Returns:
-
The return value indicates the relation of
str1 to
str2 as follows
Less than 0 means str1 is less than str2
Equal to 0 means str1 is identical to str2
Greater than 0 means str1 is more than str2
int XMLString::compareNString (
|
const XMLCh * const str1, |
|
const XMLCh * const str2, |
|
const unsigned int count) [static] |
|
Lexicographically compares, at most, the first count characters in str1 and str2 and returns a value indicating the relationship between the substrings.
-
Parameters:
-
str1
|
Null-terminated string to compare
|
str2
|
Null-terminated string to compare
|
count
|
The number of characters to compare
|
-
Returns:
-
The return value indicates the relation of
str1 to
str2 as follows
Less than 0 means str1 is less than str2
Equal to 0 means str1 is identical to str2
Greater than 0 means str1 is more than str2
int XMLString::compareNString (
|
const char * const str1, |
|
const char * const str2, |
|
const unsigned int count) [static] |
|
Lexicographically compares, at most, the first count characters in str1 and str2 and returns a value indicating the relationship between the substrings.
-
Parameters:
-
str1
|
Null-terminated string to compare
|
str2
|
Null-terminated string to compare
|
count
|
The number of characters to compare
|
-
Returns:
-
The return value indicates the relation of
str1 to
str2 as follows
Less than 0 means str1 is less than str2
Equal to 0 means str1 is identical to str2
Greater than 0 means str1 is more than str2
int XMLString::compareString (
|
const XMLCh * const str1, |
|
const XMLCh * const str2) [static] |
|
Lexicographically compares str1 and str2 and returns a value indicating their relationship.
-
Parameters:
-
str1
|
Null-terminated string to compare
|
str2
|
Null-terminated string to compare
|
-
Returns:
-
The return value indicates the relation of
str1 to
str2 as follows
Less than 0 means str1 is less than str2
Equal to 0 means str1 is identical to str2
Greater than 0 means str1 is more than str2
int XMLString::compareString (
|
const char * const str1, |
|
const char * const str2) [static] |
|
Lexicographically compares str1 and str2 and returns a value indicating their relationship.
-
Parameters:
-
str1
|
Null-terminated string to compare
|
str2
|
Null-terminated string to compare
|
-
Returns:
-
The return value indicates the relation of
str1 to
str2 as follows
Less than 0 means str1 is less than str2
Equal to 0 means str1 is identical to str2
Greater than 0 means str1 is more than str2
bool XMLString::copyNString (
|
XMLCh * const target, |
|
const XMLCh * const src, |
|
const unsigned int maxChars) [static] |
|
Copies src , upto a fixed number of characters, to the location specified by target .
No overflow checking is performed when strings are copied or appended.
The behavior of copyNString is undefined if the source and
destination strings overlap.
-
Parameters:
-
target
|
Destination string. The size of the buffer should
atleast be 'maxChars + 1'.
|
src
|
Null-terminated source string
|
maxChars
|
The maximum number of characters to copy
|
void XMLString::copyString (
|
XMLCh * const target, |
|
const XMLCh * const src) [static] |
|
Copies src , including the terminating null character, to the location specified by target .
No overflow checking is performed when strings are copied or appended.
The behavior of copyString is undefined if the source and
destination strings overlap.
-
Parameters:
-
target
|
Destination string
|
src
|
Null-terminated source string
|
void XMLString::copyString (
|
char * const target, |
|
const char * const src) [static] |
|
Copies src , including the terminating null character, to the location specified by target .
No overflow checking is performed when strings are copied or appended.
The behavior of strcpy is undefined if the source and destination strings
overlap.
-
Parameters:
-
target
|
Destination string
|
src
|
Null-terminated source string
|
void XMLString::cut (
|
XMLCh * const toCutFrom, |
|
const unsigned int count) [static] |
|
Cut leading chars from a string.
-
Parameters:
-
toCut
|
The string to cut chars from
|
count
|
The count of leading chars to cut
|
XMLCh * XMLString::findAny (
|
XMLCh * const toSearch, |
|
const XMLCh * const searchList) [static] |
|
Tells if a string has any occurance of another string within itself.
-
Parameters:
-
toSearch
|
The string to be searched
|
searchList
|
The sub-string to be searched within the string
|
-
Returns:
-
Returns the pointer to the location where the sub-string was
found, else returns 0
const XMLCh * XMLString::findAny (
|
const XMLCh * const toSearch, |
|
const XMLCh * const searchList) [static] |
|
Tells if a string has any occurance of another string within itself.
-
Parameters:
-
toSearch
|
The string to be searched
|
searchList
|
The sub-string to be searched within the string
|
-
Returns:
-
Returns the pointer to the location where the sub-string was
found, else returns 0
unsigned int XMLString::hash (
|
const XMLCh * const toHash, |
|
const unsigned int hashModulus) [static] |
|
Hashes a string given a modulus.
-
Parameters:
-
toHash
|
The string to hash
|
hashModulus
|
The divisor to be used for hashing
|
-
Returns:
-
Returns the hash value
unsigned int XMLString::hash (
|
const char * const tohash, |
|
const unsigned int hashModulus) [static] |
|
Hashes a string given a modulus.
-
Parameters:
-
toHash
|
The string to hash
|
hashModulus
|
The divisor to be used for hashing
|
-
Returns:
-
Returns the hash value
unsigned int XMLString::hashN (
|
const XMLCh * const toHash, |
|
const unsigned int numChars, |
|
const unsigned int hashModulus) [static] |
|
Hashes a string given a modulus taking a maximum number of characters as the limit.
-
Parameters:
-
toHash
|
The string to hash
|
numChars
|
The maximum number of characters to consider for hashing
|
hashModulus
|
The divisor to be used for hashing
|
-
Returns:
-
Returns the hash value
int XMLString::indexOf (
|
const XMLCh * const toSearch, |
|
const XMLCh ch) [static] |
|
Provides the index of the first occurance of a character within a string.
-
Parameters:
-
toSearch
|
The string to search
|
ch
|
The character to search within the string
|
-
Returns:
-
If found, returns the index of the character within the string,
else returns -1.
int XMLString::indexOf (
|
const char * const toSearch, |
|
const char ch) [static] |
|
Provides the index of the first occurance of a character within a string.
-
Parameters:
-
toSearch
|
The string to search
|
ch
|
The character to search within the string
|
-
Returns:
-
If found, returns the index of the character within the string,
else returns -1.
int XMLString::lastIndexOf (
|
const XMLCh * const toSearch, |
|
const XMLCh ch, |
|
const unsigned int fromIndex) [static] |
|
Provides the index of the last occurance of a character within a string starting backward from a given index.
-
Parameters:
-
toSearch
|
The string to search
|
chToFInd
|
The character to search within the string
|
fromIndex
|
The index to start backward search from
|
-
Returns:
-
If found, returns the index of the character within the string,
else returns -1.
int XMLString::lastIndexOf (
|
const char * const toSearch, |
|
const char chToFind, |
|
const unsigned int fromIndex) [static] |
|
Provides the index of the last occurance of a character within a string starting backward from a given index.
-
Parameters:
-
toSearch
|
The string to search
|
chToFInd
|
The character to search within the string
|
fromIndex
|
The index to start backward search from
|
-
Returns:
-
If found, returns the index of the character within the string,
else returns -1.
int XMLString::lastIndexOf (
|
const XMLCh * const toSearch, |
|
const XMLCh ch) [static] |
|
Provides the index of the last occurance of a character within a string.
-
Parameters:
-
toSearch
|
The string to search
|
ch
|
The character to search within the string
|
-
Returns:
-
If found, returns the index of the character within the string,
else returns -1.
int XMLString::lastIndexOf (
|
const char * const toSearch, |
|
const char ch) [static] |
|
Provides the index of the last occurance of a character within a string.
-
Parameters:
-
toSearch
|
The string to search
|
ch
|
The character to search within the string
|
-
Returns:
-
If found, returns the index of the character within the string,
else returns -1.
XMLCh * XMLString::makeUName (
|
const XMLCh * const pszURI, |
|
const XMLCh * const pszName) [static] |
|
Creates a UName from a URI and base name.
It is in the form
{url}name, and is commonly used internally to represent fully
qualified names when namespaces are enabled.
-
Parameters:
-
pszURI
|
The URI part of the name
|
pszName
|
The base part of the name
|
-
Returns:
-
Returns the complete formatted UName
void XMLString::moveChars (
|
XMLCh * const targetStr, |
|
const XMLCh * const srcStr, |
|
const unsigned int count) [static] |
|
Moves X number of chars.
-
Parameters:
-
targetStr
|
The string to copy the chars to
|
srcStr
|
The string to copy the chars from
|
count
|
The number of chars to move
|
unsigned int XMLString::replaceTokens (
|
XMLCh * const errText, |
|
const unsigned int maxChars, |
|
const XMLCh * const text1, |
|
const XMLCh * const text2, |
|
const XMLCh * const text3, |
|
const XMLCh * const text4) [static] |
|
Internal function to perform token replacement for strings.
-
Parameters:
-
errText
|
The text (NULL terminated) where the replacement
is to be done. The size of this buffer should be
'maxChars + 1' to account for the final NULL.
|
maxChars
|
The size of the output buffer, i.e. the maximum
number of characters that it will hold. If the result is
larger, it will be truncated.
|
text1
|
Replacement text-one
|
text2
|
Replacement text-two
|
text3
|
Replacement text-three
|
text4
|
Replacement text-four
|
-
Returns:
-
Returns the count of characters that are outputted
XMLCh * XMLString::replicate (
|
const XMLCh * const toRep) [static] |
|
Replicates a string.
-
Parameters:
-
toRep
|
The string to replicate
|
-
Returns:
-
Returns a pointer to the replicated string
char * XMLString::replicate (
|
const char * const toRep) [static] |
|
Replicates a string.
-
Parameters:
-
toRep
|
The string to replicate
|
-
Returns:
-
Returns a pointer to the replicated string
bool XMLString::startsWith (
|
const XMLCh * const toTest, |
|
const XMLCh * const prefix) [static] |
|
Tells if the sub-string appears within a string at the beginning.
-
Parameters:
-
toTest
|
The string to test
|
prefix
|
The sub-string that needs to be checked
|
-
Returns:
-
Returns true if the sub-string was found at the beginning of
toTest , else false
bool XMLString::startsWith (
|
const char * const toTest, |
|
const char * const prefix) [static] |
|
Tells if the sub-string appears within a string at the beginning.
-
Parameters:
-
toTest
|
The string to test
|
prefix
|
The sub-string that needs to be checked
|
-
Returns:
-
Returns true if the sub-string was found at the beginning of
toTest , else false
bool XMLString::startsWithI (
|
const XMLCh * const toTest, |
|
const XMLCh * const prefix) [static] |
|
Tells if the sub-string appears within a string at the beginning without regard to case.
-
Parameters:
-
toTest
|
The string to test
|
prefix
|
The sub-string that needs to be checked
|
-
Returns:
-
Returns true if the sub-string was found at the beginning
of
toTest , else false
bool XMLString::startsWithI (
|
const char * const toTest, |
|
const char * const prefix) [static] |
|
Tells if the sub-string appears within a string at the beginning without regard to case.
-
Parameters:
-
toTest
|
The string to test
|
prefix
|
The sub-string that needs to be checked
|
-
Returns:
-
Returns true if the sub-string was found at the beginning of
toTest , else false
unsigned int XMLString::stringLen (
|
const XMLCh * const src) [static] |
|
Get the length of the string.
-
Parameters:
-
src
|
The string whose length is to be determined
|
-
Returns:
-
Returns the length of the string
unsigned int XMLString::stringLen (
|
const char * const src) [static] |
|
Get the length of the string.
-
Parameters:
-
src
|
The string whose length is to be determined
|
-
Returns:
-
Returns the length of the string
bool XMLString::textToBin (
|
const XMLCh * const toConvert, |
|
unsigned int & toFill) [static] |
|
Converts a string of decimal chars to a binary value.
Note that leading and trailng whitespace is legal and will be ignored
but the remainder must be all decimal digits.
-
Parameters:
-
toConvert
|
The string of digits to convert
|
toFill
|
The unsigned int value to fill with the converted
value.
|
bool XMLString::transcode (
|
const char * const toTranscode, |
|
XMLCh * const toFill, |
|
const unsigned int maxChars) [static] |
|
Transcodes a string to native code-page.
-
Parameters:
-
toTranscode
|
The string tobe transcoded
|
toFill
|
The buffer that is filled with the transcoded value.
The size of this buffer should atleast be 'maxChars + 1'.
|
maxChars
|
The maximum number of characters that the output
buffer can hold (not including the null, which is why
toFill should be at least maxChars+1.) If the resulting
output cannot fit into this many characters, it is an error
and false is returned.
|
-
Returns:
-
Returns true if successful, false if there was an error
XMLCh * XMLString::transcode (
|
const char * const toTranscode) [static] |
|
Transcodes a string to native code-page.
NOTE: The returned buffer is dynamically allocated and is the
responsibility of the caller to delete it when not longer needed.
-
Parameters:
-
toTranscode
|
The string to be transcoded
|
-
Returns:
-
Returns the transcoded string
bool XMLString::transcode (
|
const XMLCh * const toTranscode, |
|
char * const toFill, |
|
const unsigned int maxChars) [static] |
|
Transcodes a string to native code-page.
Be aware that when transcoding to an external encoding, that each
Unicode char can create multiple output bytes. So you cannot assume
a one to one correspondence of input chars to output bytes.
-
Parameters:
-
toTranscode
|
The string tobe transcoded
|
toFill
|
The buffer that is filled with the transcoded value.
The size of this buffer should atleast be 'maxChars + 1'.
|
maxChars
|
The maximum number of bytes that the output
buffer can hold (not including the null, which is why
toFill should be at least maxChars+1.) If the resulting
output cannot fit into this many bytes, it is an error and
false is returned.
|
-
Returns:
-
Returns true if successful, false if there was an error
char * XMLString::transcode (
|
const XMLCh * const toTranscode) [static] |
|
Transcodes a string to native code-page.
NOTE: The returned buffer is dynamically allocated and is the
responsibility of the caller to delete it when not longer needed.
-
Parameters:
-
toTranscode
|
The string to be transcoded
|
-
Returns:
-
Returns the transcoded string
void XMLString::trim (
|
XMLCh * const toTrim) [static] |
|
Trims off extra space characters from the end of the string.
-
Parameters:
-
toTrim
|
The string to be trimmed. On return this contains
the trimmed string
|
void XMLString::trim (
|
char * const toTrim) [static] |
|
Trims off extra space characters from the end of the string.
-
Parameters:
-
toTrim
|
The string to be trimmed. On return this contains the
trimmed string
|
void XMLString::upperCase (
|
XMLCh * const toUpperCase) [static] |
|
Converts a string to uppercase.
-
Parameters:
-
toUpperCase
|
The string which needs to be converted to uppercase.
On return, this buffer also holds the converted uppercase string
|
Friends And Related Function Documentation
class XMLPlatformUtils [friend] |
|
The documentation for this class was generated from the following file:
|
|