Global Functions in Namespace in Sourcefile ustring.h

rtl_convertStringToUString

extern "C"
sal_Bool rtl_convertStringToUString(

rtl_uString * *	target,
const char *	source,
sal_Int32	length,
rtl_TextEncoding	encoding,
sal_uInt32	flags );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Converts a byte string to a Unicode string, signalling failure.

Parameters

target	An out parameter receiving the converted string. Must not be null itself, and must contain either null or a pointer to a valid rtl_uString; the contents are unspecified if conversion fails (rtl_convertStringToUString returns false).
source	The byte string. May only be null if length is zero.
length	The length of the byte string. Must be non-negative.
encoding	The text encoding to convert from. Must be an octet encoding (i.e., rtl_isOctetTextEncoding(encoding) must return true).
flags	A combination of RTL_TEXTTOUNICODE_FLAGS that detail how to do the conversion (see rtl_convertTextToUnicode). RTL_TEXTTOUNICODE_FLAGS_FLUSH need not be included, it is implicitly assumed. Typical uses are either RTL_TEXTTOUNICODE_FLAGS_UNDEFINED_ERROR \| RTL_TEXTTOUNICODE_FLAGS_MBUNDEFINED_ERROR \| RTL_TEXTTOUNICODE_FLAGS_INVALID_ERROR (fail if a byte or multi-byte sequence cannot be converted from the source encoding) or OSTRING_TO_OUSTRING_CVTFLAGS (make a best efforts conversion).

Return

True if the conversion succeeded, false otherwise.

Since

UDK 3.2.9

rtl_string2UString

extern "C"
void rtl_string2UString(

rtl_uString * *	newStr,
const sal_Char *	str,
sal_Int32	len,
rtl_TextEncoding	encoding,
sal_uInt32	convertFlags );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Create a new Unicode string by converting a byte string, using a specific text encoding.

Description

The lengths of the byte string and the Unicode string may differ (e.g., for double-byte encodings, UTF-7, UTF-8). If the length of the byte string is greater than zero, the reference count of the new string will be 1. If an out-of-memory condition occurs, newStr will point to a null pointer upon return.

Parameters

newStr	pointer to the new string. The pointed-to data must be null or a valid string.
str	a byte character array. Need not be null-terminated, but must be at least as long as the specified len.
len	the length of the byte character array.
encoding	the text encoding to use for conversion.
convertFlags	flags which control the conversion. Either use OSTRING_TO_OUSTRING_CVTFLAGS, or see for more details.

rtl_uString_acquire

extern "C"
void rtl_uString_acquire(

rtl_uString *

str );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Increment the reference count of a string.

Parameters

str

    a string.

rtl_uString_assign

extern "C"
void rtl_uString_assign(

rtl_uString * *	str,
rtl_uString *	rightValue );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Assign a new value to a string.

Description

First releases any value str might currently hold, then acquires rightValue.

Parameters

str	pointer to the string. The pointed-to data must be null or a valid string.
rightValue	a valid string.

rtl_uString_getLength

extern "C"
sal_Int32 rtl_uString_getLength(

const rtl_uString *

str );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Return the length of a string.

Description

The length is equal to the number of characters in the string.

Parameters

str	a valid string.

Return

the length of the string.

rtl_uString_getStr

extern "C"
sal_Unicode * rtl_uString_getStr(

rtl_uString *

str );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Return a pointer to the underlying character array of a string.

Parameters

str	a valid string.

Return

a pointer to the null-terminated character array.

rtl_uString_getToken

extern "C"
sal_Int32 rtl_uString_getToken(

rtl_uString * *	newStr,
rtl_uString *	str,
sal_Int32	token,
sal_Unicode	cTok,
sal_Int32	idx );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Create a new string by extracting a single token from another string.

Description

Starting at index, the token's next token is searched for. If there is no such token, the result is an empty string. Otherwise, all characters from the start of that token and up to, but not including the next occurrence of cTok make up the resulting token. The return value is the position of the next token, or -1 if no more tokens follow. Example code could look like rtl_uString * pToken = NULL; sal_Int32 nIndex = 0; do { ... nIndex = rtl_uString_getToken(&pToken, pStr, 0, ';', nIndex); ... } while (nIndex >= 0); The new string does not necessarily have a reference count of 1, so it must not be modified without checking the reference count. This function does not handle out-of-memory conditions.

Parameters

newStr	pointer to the new string. The pointed-to data must be null or a valid string. If either token or index is negative, an empty token is stored in newStr (and -1 is returned).
str	a valid string.
token	the number of the token to return, starting at index.
cTok	the character that seperates the tokens.
index	the position at which searching for the token starts. Must not be greater than the length of str.

Return

the index of the next token, or -1 if no more tokens follow.

rtl_uString_intern

extern "C"
void rtl_uString_intern(

rtl_uString * *	newStr,
rtl_uString *	str );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Return a canonical representation for a string.

Description

A pool of strings, initially empty is maintained privately by the string class. On invocation, if present in the pool the original string will be returned. Otherwise this string, or a copy thereof will be added to the pool and returned.

Parameters

newStr

    pointer to the new string.  The pointed-to data must be null or a valid
    string.

    If an out-of-memory condition occurs, newStr will point to a null pointer
    upon return.

str

    pointer to the string to be interned.

Since

UDK 3.2.7

rtl_uString_internConvert

extern "C"
void rtl_uString_internConvert(

rtl_uString * *	newStr,
const sal_Char *	str,
sal_Int32	len,
rtl_TextEncoding	encoding,
sal_uInt32	convertFlags,
sal_uInt32 *	pInfo );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Return a canonical representation for a string.

Description

A pool of strings, initially empty is maintained privately by the string class. On invocation, if present in the pool the original string will be returned. Otherwise this string, or a copy thereof will be added to the pool and returned.

Parameters

newStr	pointer to the new string. The pointed-to data must be null or a valid string. If an out-of-memory condition occurs, newStr will point to a null pointer upon return.
str	a byte character array. Need not be null-terminated, but must be at least as long as the specified len.
len	the length of the byte character array.
encoding	the text encoding to use for conversion.
convertFlags	flags which control the conversion. Either use OSTRING_TO_OUSTRING_CVTFLAGS, or see for more details.
pInfo	pointer to return conversion status in, or NULL.

Since

UDK 3.2.7

rtl_uString_iterateCodePoints

extern "C"
sal_uInt32 rtl_uString_iterateCodePoints(

const rtl_uString *	string,
sal_Int32 *	indexUtf16,
sal_Int32	incrementCodePoints );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Iterate through a string based on code points instead of UTF-16 code units.

Description

See Chapter 3 of The Unicode Standard 5.0 (Addison--Wesley, 2006) for definitions of the various terms used in this description. The given string is interpreted as a sequence of zero or more UTF-16 code units. For each index into this sequence (from zero to one less than the length of the sequence, inclusive), a code point represented starting at the given index is computed as follows: - If the UTF-16 code unit addressed by the index constitutes a well-formed UTF-16 code unit sequence, the computed code point is the scalar value encoded by that UTF-16 code unit sequence. - Otherwise, if the index is at least two UTF-16 code units away from the end of the sequence, and the sequence of two UTF-16 code units addressed by the index constitutes a well-formed UTF-16 code unit sequence, the computed code point is the scalar value encoded by that UTF-16 code unit sequence. - Otherwise, the computed code point is the UTF-16 code unit addressed by the index. (This last case catches unmatched surrogates as well as indices pointing into the middle of surrogate pairs.)

Parameters

string

    pointer to a valid string; must not be null.

indexUtf16

    pointer to a UTF-16 based index into the given string; must not be null.  On
    entry, the index must be in the range from zero to the length of the string
    (in UTF-16 code units), inclusive.  Upon successful return, the index will
    be updated to address the UTF-16 code unit that is the given
    incrementCodePoints away from the initial index.

incrementCodePoints

    the number of code points to move the given *indexUtf16.  If non-negative,
    moving is done after determining the code point at the index.  If negative,
    moving is done before determining the code point at the (then updated)
    index.  The value must be such that the resulting UTF-16 based index is in
    the range from zero to the length of the string (in UTF-16 code units),
    inclusive.

Return

the code point (an integer in the range from 0 to 0x10FFFF, inclusive) that is represented within the string starting at the index computed as follows: If incrementCodePoints is non-negative, the index is the initial value of *indexUtf16; if incrementCodePoints is negative, the index is the updated value of *indexUtf16. In either case, the computed index must be in the range from zero to one less than the length of the string (in UTF-16 code units), inclusive.

Since

UDK 3.2.7

rtl_uString_new

extern "C"
void rtl_uString_new(

rtl_uString * *

newStr );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Allocate a new string containing no characters.

Parameters

newStr

    pointer to the new string.  The pointed-to data must be null or a valid
    string.

rtl_uString_newConcat

extern "C"
void rtl_uString_newConcat(

rtl_uString * *	newStr,
rtl_uString *	left,
rtl_uString *	right );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Create a new string that is the concatenation of two other strings.

Description

The new string does not necessarily have a reference count of 1 (in cases where one of the two other strings is empty), so it must not be modified without checking the reference count. This function does not handle out-of-memory conditions.

Parameters

newStr	pointer to the new string. The pointed-to data must be null or a valid string.
left	a valid string.
right	a valid string.

rtl_uString_newFromAscii

extern "C"
void rtl_uString_newFromAscii(

rtl_uString * *	newStr,
const sal_Char *	value );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Allocate a new string that contains a copy of a character array.

Description

If the length of value is greater than zero, the reference count of the new string will be 1. This function does not handle out-of-memory conditions. Since this function is optimized for performance, the ASCII character values are not converted in any way. The caller has to make sure that all ASCII characters are in the allowed range of 0 and 127, inclusive.

Parameters

newStr	pointer to the new string. The pointed-to data must be null or a valid string.
value	a null-terminated ASCII character array.

rtl_uString_newFromCodePoints

extern "C"
void rtl_uString_newFromCodePoints(

rtl_uString * *	newString,
const sal_uInt32 *	codePoints,
sal_Int32	codePointCount );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Allocate a new string from an array of Unicode code points.

Parameters

newString

    a non-null pointer to a (possibly null) rtl_uString pointer, which (if
    non-null) will have been passed to rtl_uString_release before the function
    returns.  Upon return, points to the newly allocated string or to null if
    there was either an out-of-memory condition or the resulting number of
    UTF-16 code units would have been larger than SAL_MAX_INT32.  The newly
    allocated string (if any) must ultimately be passed to rtl_uString_release.

codePoints

    an array of at least codePointCount code points, which each must be in the
    range from 0 to 0x10FFFF, inclusive.  May be null if codePointCount is zero.

codePointCount

    the non-negative number of code points.

Since

UDK 3.2.7

rtl_uString_newFromStr

extern "C"
void rtl_uString_newFromStr(

rtl_uString * *	newStr,
const sal_Unicode *	value );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Allocate a new string that contains a copy of a character array.

Description

If the length of value is greater than zero, the reference count of the new string will be 1. This function does not handle out-of-memory conditions.

Parameters

newStr	pointer to the new string. The pointed-to data must be null or a valid string.
value	a null-terminated character array.

rtl_uString_newFromStr_WithLength

extern "C"
void rtl_uString_newFromStr_WithLength(

rtl_uString * *	newStr,
const sal_Unicode *	value,
sal_Int32	len );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Allocate a new string that contains a copy of a character array.

Description

If the length of value is greater than zero, the reference count of the new string will be 1. This function does not handle out-of-memory conditions.

Parameters

newStr

    pointer to the new string.  The pointed-to data must be null or a valid
    string.

value

    a character array.  Need not be null-terminated, but must be at least as
    long as the specified len.

len

    the length of the character array.

rtl_uString_newFromString

extern "C"
void rtl_uString_newFromString(

rtl_uString * *	newStr,
const rtl_uString *	value );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Allocate a new string that contains a copy of another string.

Description

If the length of value is greater than zero, the reference count of the new string will be 1. This function does not handle out-of-memory conditions.

Parameters

newStr	pointer to the new string. The pointed-to data must be null or a valid string.
value	a valid string.

rtl_uString_newReplace

extern "C"
void rtl_uString_newReplace(

rtl_uString * *	newStr,
rtl_uString *	str,
sal_Unicode	oldChar,
sal_Unicode	newChar );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Create a new string by replacing all occurrences of a single character within another string.

Description

The new string results from replacing all occurrences of oldChar in str with newChar. The new string does not necessarily have a reference count of 1 (in cases where oldChar does not occur in str), so it must not be modified without checking the reference count. This function does not handle out-of-memory conditions.

Parameters

newStr	pointer to the new string. The pointed-to data must be null or a valid string.
str	a valid string.
oldChar	the old character.
newChar	the new character.

rtl_uString_newReplaceStrAt

extern "C"
void rtl_uString_newReplaceStrAt(

rtl_uString * *	newStr,
rtl_uString *	str,
sal_Int32	idx,
sal_Int32	count,
rtl_uString *	subStr );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Create a new string by replacing a substring of another string.

Description

The new string results from replacing a number of characters (count), starting at the specified position (index) in the original string (str), with some new substring (subStr). If subStr is null, than only a number of characters is deleted. The new string does not necessarily have a reference count of 1, so it must not be modified without checking the reference count. This function does not handle out-of-memory conditions.

Parameters

newStr	pointer to the new string. The pointed-to data must be null or a valid string.
str	a valid string.
index	the index into str at which to start replacement. Must be between 0 and the length of str, inclusive.
count	the number of charcters to remove. Must not be negative, and the sum of index and count must not exceed the length of str.
subStr	either null or a valid string to be inserted.

rtl_uString_newToAsciiLowerCase

extern "C"
void rtl_uString_newToAsciiLowerCase(

rtl_uString * *	newStr,
rtl_uString *	str );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Create a new string by converting all ASCII uppercase letters to lowercase within another string.

Description

The new string results from replacing all characters with values between 65 and 90 (ASCII A--Z) by values between 97 and 122 (ASCII a--z). This function cannot be used for language-specific conversion. The new string does not necessarily have a reference count of 1 (in cases where no characters need to be converted), so it must not be modified without checking the reference count. This function does not handle out-of-memory conditions.

Parameters

newStr	pointer to the new string. The pointed-to data must be null or a valid string.
str	a valid string.

rtl_uString_newToAsciiUpperCase

extern "C"
void rtl_uString_newToAsciiUpperCase(

rtl_uString * *	newStr,
rtl_uString *	str );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Create a new string by converting all ASCII lowercase letters to uppercase within another string.

Description

The new string results from replacing all characters with values between 97 and 122 (ASCII a--z) by values between 65 and 90 (ASCII A--Z). This function cannot be used for language-specific conversion. The new string does not necessarily have a reference count of 1 (in cases where no characters need to be converted), so it must not be modified without checking the reference count. This function does not handle out-of-memory conditions.

Parameters

newStr	pointer to the new string. The pointed-to data must be null or a valid string.
str	a valid string.

rtl_uString_newTrim

extern "C"
void rtl_uString_newTrim(

rtl_uString * *	newStr,
rtl_uString *	str );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Create a new string by removing white space from both ends of another string.

Description

The new string results from removing all characters with values less than or equal to 32 (the space character) form both ends of str. This function cannot be used for language-specific conversion. The new string does not necessarily have a reference count of 1 (in cases where no characters need to be removed), so it must not be modified without checking the reference count. This function does not handle out-of-memory conditions.

Parameters

newStr	pointer to the new string. The pointed-to data must be null or a valid string.
str	a valid string.

rtl_uString_new_WithLength

extern "C"
void rtl_uString_new_WithLength(

rtl_uString * *	newStr,
sal_Int32	nLen );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Allocate a new string containing space for a given number of characters.

Description

If len is greater than zero, the reference count of the new string will be 1. The values of all characters are set to 0 and the length of the string is 0. This function does not handle out-of-memory conditions.

Parameters

newStr	pointer to the new string. The pointed-to data must be null or a valid string.
len	the number of characters.

rtl_uString_release

extern "C"
void rtl_uString_release(

rtl_uString *

str );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Decrement the reference count of a string.

Description

If the count goes to zero than the string data is deleted.

Parameters

str

    a string.

rtl_ustr_ascii_compare

extern "C"
sal_Int32 rtl_ustr_ascii_compare(

const sal_Unicode *	first,
const sal_Char *	second );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Compare two strings.

Description

The comparison is based on the numeric value of each character in the strings and returns a value indicating their relationship. This function cannot be used for language-specific sorting. Both strings must be null-terminated. Since this function is optimized for performance, the ASCII character values are not converted in any way. The caller has to make sure that all ASCII characters are in the allowed range of 0 and 127, inclusive.

Parameters

first	the first null-terminated string to be compared.
second	the second null-terminated ASCII string which is compared with the first one.

Return

0 if both substrings are equal, a value less than 0 if the first substring is less than the second substring, and a value greater than 0 if the first substring is greater than the second substring.

rtl_ustr_ascii_compareIgnoreAsciiCase

extern "C"
sal_Int32 rtl_ustr_ascii_compareIgnoreAsciiCase(

const sal_Unicode *	first,
const sal_Char *	second );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Compare two strings, ignoring the case of ASCII characters.

Description

The comparison is based on the numeric value of each character in the strings and returns a value indicating their relationship. Character values between 65 and 90 (ASCII A--Z) are interpreted as values between 97 and 122 (ASCII a--z). This function cannot be used for language-specific sorting. Both strings must be null-terminated. Since this function is optimized for performance, the ASCII character values are not converted in any way. The caller has to make sure that all ASCII characters are in the allowed range of 0 and 127, inclusive.

Parameters

first	the first null-terminated string to be compared.
second	the second null-terminated ASCII string which is compared with the first one.

Return

0 if both strings are equal, a value less than 0 if the first string is less than the second string, and a value greater than 0 if the first string is greater than the second string.

rtl_ustr_ascii_compareIgnoreAsciiCase_WithLength

extern "C"
sal_Int32 rtl_ustr_ascii_compareIgnoreAsciiCase_WithLength(

const sal_Unicode *	first,
sal_Int32	firstLen,
const sal_Char *	second );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Compare two strings, ignoring the case of ASCII characters.

Description

The comparison is based on the numeric value of each character in the strings and returns a value indicating their relationship. Character values between 65 and 90 (ASCII A--Z) are interpreted as values between 97 and 122 (ASCII a--z). This function cannot be used for language-specific sorting. Since this function is optimized for performance, the ASCII character values are not converted in any way. The caller has to make sure that all ASCII characters are in the allowed range of 0 and 127, inclusive.

Parameters

first

    the first string to be compared.  Need not be null-terminated, but must be
    at least as long as the specified firstLen.

firstLen

    the length of the first string.

second

    the second null-terminated ASCII string which is compared with the first
    one.

Return

0 if both strings are equal, a value less than 0 if the first string is less than the second string, and a value greater than 0 if the first string is greater than the second string.

rtl_ustr_ascii_compareIgnoreAsciiCase_WithLengths

extern "C"
sal_Int32 rtl_ustr_ascii_compareIgnoreAsciiCase_WithLengths(

const sal_Unicode *	first,
sal_Int32	firstLen,
const char *	second,
sal_Int32	secondLen );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Compare two strings, ignoring the case of ASCII characters.

Description

The comparison is based on the numeric value of each character in the strings and returns a value indicating their relationship. Character values between 65 and 90 (ASCII A--Z) are interpreted as values between 97 and 122 (ASCII a--z). This function cannot be used for language-specific sorting. Since this function is optimized for performance, the ASCII character values are not converted in any way. The caller has to make sure that all ASCII characters are in the allowed range of 0 and 127, inclusive.

Parameters

first	the first string to be compared. Need not be null-terminated, but must be at least as long as the specified firstLen.
firstLen	the length of the first string.
second	the second string which is compared with the first one. Need not be null-terminated, but must be at least as long as the specified secondLen.
secondLen	the length of the second string.

Return

0 if both strings are equal, a value less than 0 if the first string is less than the second string, and a value greater than 0 if the first string is greater than the second string.

rtl_ustr_ascii_compare_WithLength

extern "C"
sal_Int32 rtl_ustr_ascii_compare_WithLength(

const sal_Unicode *	first,
sal_Int32	firstLen,
const sal_Char *	second );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Compare two strings.

Description

The comparison is based on the numeric value of each character in the strings and returns a value indicating their relationship. This function cannot be used for language-specific sorting. Since this function is optimized for performance, the ASCII character values are not converted in any way. The caller has to make sure that all ASCII characters are in the allowed range of 0 and 127, inclusive.

Parameters

first

    the first string to be compared.  Need not be null-terminated, but must be
    at least as long as the specified firstLen.

firstLen

    the length of the first string.

second

    the second null-terminated ASCII string which is compared with the first
    one.

Return

0 if both substrings are equal, a value less than 0 if the first substring is less than the second substring, and a value greater than 0 if the first substring is greater than the second substring.

rtl_ustr_ascii_shortenedCompareIgnoreAsciiCase_WithLength

extern "C"
sal_Int32 rtl_ustr_ascii_shortenedCompareIgnoreAsciiCase_WithLength(

const sal_Unicode *	first,
sal_Int32	firstLen,
const sal_Char *	second,
sal_Int32	shortenedLen );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Compare two strings with a maximum count of characters, ignoring the case of ASCII characters.

Description

The comparison is based on the numeric value of each character in the strings and returns a value indicating their relationship. Character values between 65 and 90 (ASCII A--Z) are interpreted as values between 97 and 122 (ASCII a--z). This function cannot be used for language-specific sorting. Since this function is optimized for performance, the ASCII character values are not converted in any way. The caller has to make sure that all ASCII characters are in the allowed range of 0 and 127, inclusive.

Parameters

first	the first string to be compared. Need not be null-terminated, but must be at least as long as the specified firstLen.
firstLen	the length of the first string.
second	the second null-terminated ASCII string which is compared with the first one.
shortenedLen	the maximum number of characters to compare. This length can be greater or smaller than the lengths of the two strings.

Return

0 if both substrings are equal, a value less than 0 if the first substring is less than the second substring, and a value greater than 0 if the first substring is greater than the second substring.

rtl_ustr_ascii_shortenedCompare_WithLength

extern "C"
sal_Int32 rtl_ustr_ascii_shortenedCompare_WithLength(

const sal_Unicode *	first,
sal_Int32	firstLen,
const sal_Char *	second,
sal_Int32	shortenedLen );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Compare two strings with a maximum count of characters.

Description

The comparison is based on the numeric value of each character in the strings and returns a value indicating their relationship. This function cannot be used for language-specific sorting. Since this function is optimized for performance, the ASCII character values are not converted in any way. The caller has to make sure that all ASCII characters are in the allowed range of 0 and 127, inclusive.

Parameters

first	the first string to be compared. Need not be null-terminated, but must be at least as long as the specified firstLen.
firstLen	the length of the first string.
second	the second null-terminated ASCII string which is compared with the first one.
shortenedLen	the maximum number of characters to compare. This length can be greater or smaller than the lengths of the two strings.

Return

0 if both substrings are equal, a value less than 0 if the first substring is less than the second substring, and a value greater than 0 if the first substring is greater than the second substring.

rtl_ustr_asciil_reverseCompare_WithLength

extern "C"
sal_Int32 rtl_ustr_asciil_reverseCompare_WithLength(

const sal_Unicode *	first,
sal_Int32	firstLen,
const sal_Char *	second,
sal_Int32	secondLen );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Compare two strings from back to front.

Description

The comparison is based on the numeric value of each character in the strings and returns a value indicating their relationship. This function cannot be used for language-specific sorting. Since this function is optimized for performance, the ASCII character values are not converted in any way. The caller has to make sure that all ASCII characters are in the allowed range of 0 and 127, inclusive.

Parameters

first	the first string to be compared. Need not be null-terminated, but must be at least as long as the specified firstLen.
firstLen	the length of the first string.
second	the second ASCII string which is compared with the first one. Need not be null-terminated, but must be at least as long as the specified secondLen.
secondLen	the length of the second string.

Return

0 if both strings are equal, a value less than 0 if the first string compares less than the second string, and a value greater than 0 if the first string compares greater than the second string.

rtl_ustr_asciil_reverseEquals_WithLength

extern "C"
sal_Bool rtl_ustr_asciil_reverseEquals_WithLength(

const sal_Unicode *	first,
const sal_Char *	second,
sal_Int32	len );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Compare two strings from back to front for equality.

Description

The comparison is based on the numeric value of each character in the strings and returns 'true' if, ans only if, both strings are equal. This function cannot be used for language-specific sorting.

Parameters

first

    the first string to be compared.  Need not be null-terminated, but must be
    at least as long as the specified len.

second

    the second string which is compared with the first one.  Need not be
    null-terminated, but must be at least as long as the specified len.

len

    the length of both strings.

Return

true if both strings are equal, false if they are not equal.

rtl_ustr_compare

extern "C"
sal_Int32 rtl_ustr_compare(

const sal_Unicode *	first,
const sal_Unicode *	second );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Compare two strings.

Description

The comparison is based on the numeric value of each character in the strings and returns a value indicating their relationship. This function cannot be used for language-specific sorting. Both strings must be null-terminated.

Parameters

first	the first null-terminated string to be compared.
second	the second null-terminated string which is compared with the first one.

Return

0 if both strings are equal, a value less than 0 if the first string is less than the second string, and a value greater than 0 if the first string is greater than the second string.

rtl_ustr_compareIgnoreAsciiCase

extern "C"
sal_Int32 rtl_ustr_compareIgnoreAsciiCase(

const sal_Unicode *	first,
const sal_Unicode *	second );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Compare two strings, ignoring the case of ASCII characters.

Description

The comparison is based on the numeric value of each character in the strings and returns a value indicating their relationship. Character values between 65 and 90 (ASCII A--Z) are interpreted as values between 97 and 122 (ASCII a--z). This function cannot be used for language-specific sorting. Both strings must be null-terminated.

Parameters

first	the first null-terminated string to be compared.
second	the second null-terminated string which is compared with the first one.

Return

0 if both strings are equal, a value less than 0 if the first string is less than the second string, and a value greater than 0 if the first string is greater than the second string.

rtl_ustr_compareIgnoreAsciiCase_WithLength

extern "C"
sal_Int32 rtl_ustr_compareIgnoreAsciiCase_WithLength(

const sal_Unicode *	first,
sal_Int32	firstLen,
const sal_Unicode *	second,
sal_Int32	secondLen );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Compare two strings, ignoring the case of ASCII characters.

Description

The comparison is based on the numeric value of each character in the strings and returns a value indicating their relationship. Character values between 65 and 90 (ASCII A--Z) are interpreted as values between 97 and 122 (ASCII a--z). This function cannot be used for language-specific sorting.

Parameters

first	the first string to be compared. Need not be null-terminated, but must be at least as long as the specified firstLen.
firstLen	the length of the first string.
second	the second string which is compared with the first one. Need not be null-terminated, but must be at least as long as the specified secondLen.
secondLen	the length of the second string.

Return

0 if both strings are equal, a value less than 0 if the first string is less than the second string, and a value greater than 0 if the first string is greater than the second string.

rtl_ustr_compare_WithLength

extern "C"
sal_Int32 rtl_ustr_compare_WithLength(

const sal_Unicode *	first,
sal_Int32	firstLen,
const sal_Unicode *	second,
sal_Int32	secondLen );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Compare two strings.

Description

The comparison is based on the numeric value of each character in the strings and returns a value indicating their relationship. This function cannot be used for language-specific sorting.

Parameters

first	the first string to be compared. Need not be null-terminated, but must be at least as long as the specified firstLen.
firstLen	the length of the first string.
second	the second string which is compared with the first one. Need not be null-terminated, but must be at least as long as the specified secondLen.
secondLen	the length of the second string.

Return

0 if both strings are equal, a value less than 0 if the first string is less than the second string, and a value greater than 0 if the first string is greater than the second string.

rtl_ustr_getLength

extern "C"
sal_Int32 rtl_ustr_getLength(

const sal_Unicode *

str );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Return the length of a string.

Description

The length is equal to the number of 16-bit Unicode characters in the string, without the terminating NUL character.

Parameters

str	a null-terminated string.

Return

the length of the sequence of characters represented by this string, excluding the terminating NUL character.

rtl_ustr_hashCode

extern "C"
sal_Int32 rtl_ustr_hashCode(

const sal_Unicode *

str );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Return a hash code for a string.

Description

It is not allowed to store the hash code persistently, because later versions could return other hash codes. The string must be null-terminated.

Parameters

str	a null-terminated string.

Return

a hash code for the given string.

rtl_ustr_hashCode_WithLength

extern "C"
sal_Int32 rtl_ustr_hashCode_WithLength(

const sal_Unicode *	str,
sal_Int32	len );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Return a hash code for a string.

Description

It is not allowed to store the hash code persistently, because later versions could return other hash codes.

Parameters

str	a string. Need not be null-terminated, but must be at least as long as the specified len.
len	the length of the string.

Return

a hash code for the given string.

rtl_ustr_indexOfAscii_WithLength

extern "C"
sal_Int32 rtl_ustr_indexOfAscii_WithLength(

const sal_Unicode *	str,
sal_Int32	len,
const char *	subStr,
sal_Int32	subLen );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Search for the first occurrence of an ASCII substring within a string.

Parameters

str	a string. Need not be null-terminated, but must be at least as long as the specified len.
len	the length of the string; must be non-negative.
subStr	the substring to be searched for. Need not be null-terminated, but must be at least as long as the specified subLen. Must only contain characters in the ASCII range 0x00--7F.
subLen	the length of the substring; must be non-negative.

Return

the index (starting at 0) of the first character of the first occurrence of the substring within the string, or -1 if the substring does not occur. If subLen is zero, -1 is returned.

Since

UDK 3.2.7

rtl_ustr_indexOfChar

extern "C"
sal_Int32 rtl_ustr_indexOfChar(

const sal_Unicode *	str,
sal_Unicode	ch );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Search for the first occurrence of a character within a string.

Description

The string must be null-terminated.

Parameters

str	a null-terminated string.
ch	the character to be searched for.

Return

the index (starting at 0) of the first occurrence of the character in the string, or -1 if the character does not occur.

rtl_ustr_indexOfChar_WithLength

extern "C"
sal_Int32 rtl_ustr_indexOfChar_WithLength(

const sal_Unicode *	str,
sal_Int32	len,
sal_Unicode	ch );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Search for the first occurrence of a character within a string.

Parameters

str	a string. Need not be null-terminated, but must be at least as long as the specified len.
len	the length of the string.
ch	the character to be searched for.

Return

the index (starting at 0) of the first occurrence of the character in the string, or -1 if the character does not occur.

rtl_ustr_indexOfStr

extern "C"
sal_Int32 rtl_ustr_indexOfStr(

const sal_Unicode *	str,
const sal_Unicode *	subStr );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Search for the first occurrence of a substring within a string.

Description

If subStr is empty, or both str and subStr are empty, -1 is returned. Both strings must be null-terminated.

Parameters

str	a null-terminated string.
subStr	the null-terminated substring to be searched for.

Return

the index (starting at 0) of the first character of the first occurrence of the substring within the string, or -1 if the substring does not occur.

rtl_ustr_indexOfStr_WithLength

extern "C"
sal_Int32 rtl_ustr_indexOfStr_WithLength(

const sal_Unicode *	str,
sal_Int32	len,
const sal_Unicode *	subStr,
sal_Int32	subLen );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Search for the first occurrence of a substring within a string.

Description

If subStr is empty, or both str and subStr are empty, -1 is returned.

Parameters

str	a string. Need not be null-terminated, but must be at least as long as the specified len.
len	the length of the string.
subStr	the substring to be searched for. Need not be null-terminated, but must be at least as long as the specified subLen.
subLen	the length of the substring.

Return

the index (starting at 0) of the first character of the first occurrence of the substring within the string, or -1 if the substring does not occur.

rtl_ustr_lastIndexOfAscii_WithLength

extern "C"
sal_Int32 rtl_ustr_lastIndexOfAscii_WithLength(

const sal_Unicode *	str,
sal_Int32	len,
const char *	subStr,
sal_Int32	subLen );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Search for the last occurrence of an ASCII substring within a string.

Parameters

str	a string. Need not be null-terminated, but must be at least as long as the specified len.
len	the length of the string; must be non-negative.
subStr	the substring to be searched for. Need not be null-terminated, but must be at least as long as the specified subLen. Must only contain characters in the ASCII range 0x00--7F.
subLen	the length of the substring; must be non-negative.

Return

the index (starting at 0) of the first character of the last occurrence of the substring within the string, or -1 if the substring does not occur. If subLen is zero, -1 is returned.

Since

UDK 3.2.7

rtl_ustr_lastIndexOfChar

extern "C"
sal_Int32 rtl_ustr_lastIndexOfChar(

const sal_Unicode *	str,
sal_Unicode	ch );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Search for the last occurrence of a character within a string.

Description

The string must be null-terminated.

Parameters

str	a null-terminated string.
ch	the character to be searched for.

Return

the index (starting at 0) of the last occurrence of the character in the string, or -1 if the character does not occur. The returned value is always smaller than the string length.

rtl_ustr_lastIndexOfChar_WithLength

extern "C"
sal_Int32 rtl_ustr_lastIndexOfChar_WithLength(

const sal_Unicode *	str,
sal_Int32	len,
sal_Unicode	ch );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Search for the last occurrence of a character within a string.

Parameters

str	a string. Need not be null-terminated, but must be at least as long as the specified len.
len	the length of the string.
ch	the character to be searched for.

Return

the index (starting at 0) of the last occurrence of the character in the string, or -1 if the character does not occur. The returned value is always smaller than the string length.

rtl_ustr_lastIndexOfStr

extern "C"
sal_Int32 rtl_ustr_lastIndexOfStr(

const sal_Unicode *	str,
const sal_Unicode *	subStr );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Search for the last occurrence of a substring within a string.

Description

If subStr is empty, or both str and subStr are empty, -1 is returned. Both strings must be null-terminated.

Parameters

str	a null-terminated string.
subStr	the null-terminated substring to be searched for.

Return

the index (starting at 0) of the first character of the last occurrence of the substring within the string, or -1 if the substring does not occur.

rtl_ustr_lastIndexOfStr_WithLength

extern "C"
sal_Int32 rtl_ustr_lastIndexOfStr_WithLength(

const sal_Unicode *	str,
sal_Int32	len,
const sal_Unicode *	subStr,
sal_Int32	subLen );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Search for the last occurrence of a substring within a string.

Description

If subStr is empty, or both str and subStr are empty, -1 is returned.

Parameters

str	a string. Need not be null-terminated, but must be at least as long as the specified len.
len	the length of the string.
subStr	the substring to be searched for. Need not be null-terminated, but must be at least as long as the specified subLen.
subLen	the length of the substring.

Return

the index (starting at 0) of the first character of the first occurrence of the substring within the string, or -1 if the substring does not occur.

rtl_ustr_replaceChar

extern "C"
void rtl_ustr_replaceChar(

sal_Unicode *	str,
sal_Unicode	oldChar,
sal_Unicode	newChar );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Replace all occurrences of a single character within a string.

Description

If oldChar does not occur within str, then the string is not modified. The string must be null-terminated.

Parameters

str	a null-terminated string.
oldChar	the old character.
newChar	the new character.

rtl_ustr_replaceChar_WithLength

extern "C"
void rtl_ustr_replaceChar_WithLength(

sal_Unicode *	str,
sal_Int32	len,
sal_Unicode	oldChar,
sal_Unicode	newChar );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Replace all occurrences of a single character within a string.

Description

If oldChar does not occur within str, then the string is not modified.

Parameters

str	a string. Need not be null-terminated, but must be at least as long as the specified len.
len	the length of the string.
oldChar	the old character.
newChar	the new character.

rtl_ustr_reverseCompare_WithLength

extern "C"
sal_Int32 rtl_ustr_reverseCompare_WithLength(

const sal_Unicode *	first,
sal_Int32	firstLen,
const sal_Unicode *	second,
sal_Int32	secondLen );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Compare two strings from back to front.

Description

The comparison is based on the numeric value of each character in the strings and returns a value indicating their relationship. This function cannot be used for language-specific sorting.

Parameters

first	the first string to be compared. Need not be null-terminated, but must be at least as long as the specified firstLen.
firstLen	the length of the first string.
second	the second string which is compared with the first one. Need not be null-terminated, but must be at least as long as the specified secondLen.
secondLen	the length of the second string.

Return

0 if both strings are equal, a value less than 0 if the first string compares less than the second string, and a value greater than 0 if the first string compares greater than the second string.

rtl_ustr_shortenedCompareIgnoreAsciiCase_WithLength

extern "C"
sal_Int32 rtl_ustr_shortenedCompareIgnoreAsciiCase_WithLength(

const sal_Unicode *	first,
sal_Int32	firstLen,
const sal_Unicode *	second,
sal_Int32	secondLen,
sal_Int32	shortenedLen );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Compare two strings with a maximum count of characters, ignoring the case of ASCII characters.

Description

The comparison is based on the numeric value of each character in the strings and returns a value indicating their relationship. Character values between 65 and 90 (ASCII A--Z) are interpreted as values between 97 and 122 (ASCII a--z). This function cannot be used for language-specific sorting.

Parameters

first	the first string to be compared. Need not be null-terminated, but must be at least as long as the specified firstLen.
firstLen	the length of the first string.
second	the second string which is compared with the first one. Need not be null-terminated, but must be at least as long as the specified secondLen.
secondLen	the length of the second string.
shortenedLen	the maximum number of characters to compare. This length can be greater or smaller than the lengths of the two strings.

Return

0 if both substrings are equal, a value less than 0 if the first substring is less than the second substring, and a value greater than 0 if the first substring is greater than the second substring.

rtl_ustr_shortenedCompare_WithLength

extern "C"
sal_Int32 rtl_ustr_shortenedCompare_WithLength(

const sal_Unicode *	first,
sal_Int32	firstLen,
const sal_Unicode *	second,
sal_Int32	secondLen,
sal_Int32	shortenedLen );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Compare two strings with a maximum count of characters.

Description

The comparison is based on the numeric value of each character in the strings and returns a value indicating their relationship. This function cannot be used for language-specific sorting.

Parameters

first	the first string to be compared. Need not be null-terminated, but must be at least as long as the specified firstLen.
firstLen	the length of the first string.
second	the second string which is compared with the first one. Need not be null-terminated, but must be at least as long as the specified secondLen.
secondLen	the length of the second string.
shortenedLen	the maximum number of characters to compare. This length can be greater or smaller than the lengths of the two strings.

Return

0 if both substrings are equal, a value less than 0 if the first substring is less than the second substring, and a value greater than 0 if the first substring is greater than the second substring.

rtl_ustr_toAsciiLowerCase

extern "C"
void rtl_ustr_toAsciiLowerCase(

sal_Unicode *

str );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Convert all ASCII uppercase letters to lowercase within a string.

Description

The characters with values between 65 and 90 (ASCII A--Z) are replaced with values between 97 and 122 (ASCII a--z). The string must be null-terminated.

Parameters

str	a null-terminated string.

rtl_ustr_toAsciiLowerCase_WithLength

extern "C"
void rtl_ustr_toAsciiLowerCase_WithLength(

sal_Unicode *	str,
sal_Int32	len );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Convert all ASCII uppercase letters to lowercase within a string.

Description

The characters with values between 65 and 90 (ASCII A--Z) are replaced with values between 97 and 122 (ASCII a--z).

Parameters

str	a string. Need not be null-terminated, but must be at least as long as the specified len.
len	the length of the string.

rtl_ustr_toAsciiUpperCase

extern "C"
void rtl_ustr_toAsciiUpperCase(

sal_Unicode *

str );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Convert all ASCII lowercase letters to uppercase within a string.

Description

The characters with values between 97 and 122 (ASCII a--z) are replaced with values between 65 and 90 (ASCII A--Z). The string must be null-terminated.

Parameters

str	a null-terminated string.

rtl_ustr_toAsciiUpperCase_WithLength

extern "C"
void rtl_ustr_toAsciiUpperCase_WithLength(

sal_Unicode *	str,
sal_Int32	len );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Convert all ASCII lowercase letters to uppercase within a string.

Description

The characters with values between 97 and 122 (ASCII a--z) are replaced with values between 65 and 90 (ASCII A--Z).

Parameters

str	a string. Need not be null-terminated, but must be at least as long as the specified len.
len	the length of the string.

rtl_ustr_toBoolean

extern "C"
sal_Bool rtl_ustr_toBoolean(

const sal_Unicode *

str );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Interpret a string as a boolean.

Description

This function cannot be used for language-specific conversion. The string must be null-terminated.

Parameters

str	a null-terminated string.

Return

true if the string is "1" or "true" in any ASCII case, false otherwise.

rtl_ustr_toDouble

extern "C"
double rtl_ustr_toDouble(

const sal_Unicode *

str );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Interpret a string as a double.

Description

This function cannot be used for language-specific conversion. The string must be null-terminated.

Parameters

str	a null-terminated string.

Return

the float value represented by the string, or 0.0 if the string does not represent a double.

rtl_ustr_toFloat

extern "C"
float rtl_ustr_toFloat(

const sal_Unicode *

str );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Interpret a string as a float.

Description

This function cannot be used for language-specific conversion. The string must be null-terminated.

Parameters

str	a null-terminated string.

Return

the float value represented by the string, or 0.0 if the string does not represent a float.

rtl_ustr_toInt32

extern "C"
sal_Int32 rtl_ustr_toInt32(

const sal_Unicode *	str,
sal_Int16	radix );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Interpret a string as an integer.

Description

This function cannot be used for language-specific conversion. The string must be null-terminated.

Parameters

str	a null-terminated string.
radix	the radix. Must be between RTL_USTR_MIN_RADIX (2) and RTL_USTR_MAX_RADIX (36), inclusive.

Return

the integer value represented by the string, or 0 if the string does not represent an integer.

rtl_ustr_toInt64

extern "C"
sal_Int64 rtl_ustr_toInt64(

const sal_Unicode *	str,
sal_Int16	radix );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Interpret a string as a long integer.

Description

This function cannot be used for language-specific conversion. The string must be null-terminated.

Parameters

str	a null-terminated string.
radix	the radix. Must be between RTL_USTR_MIN_RADIX (2) and RTL_USTR_MAX_RADIX (36), inclusive.

Return

the long integer value represented by the string, or 0 if the string does not represent a long integer.

rtl_ustr_trim

extern "C"
sal_Int32 rtl_ustr_trim(

sal_Unicode *

str );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Remove white space from both ends of a string.

Description

All characters with values less than or equal to 32 (the space character) are considered to be white space. This function cannot be used for language-specific operations. The string must be null-terminated.

Parameters

str	a null-terminated string.

Return

the new length of the string.

rtl_ustr_trim_WithLength

extern "C"
sal_Int32 rtl_ustr_trim_WithLength(

sal_Unicode *	str,
sal_Int32	len );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Remove white space from both ends of the string.

Description

All characters with values less than or equal to 32 (the space character) are considered to be white space. This function cannot be used for language-specific operations. The string must be null-terminated.

Parameters

str	a string. Need not be null-terminated, but must be at least as long as the specified len.
len	the original length of the string.

Return

the new length of the string.

rtl_ustr_valueOfBoolean

extern "C"
sal_Int32 rtl_ustr_valueOfBoolean(

sal_Unicode *	str,
sal_Bool	b );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Create the string representation of a boolean.

Description

If b is true, the buffer is filled with the string "true" and 5 is returned. If b is false, the buffer is filled with the string "false" and 6 is returned. This function cannot be used for language-specific operations.

Parameters

str	a buffer that is big enough to hold the result and the terminating NUL character. You should use the RTL_USTR_MAX_VALUEOFBOOLEAN define to create a buffer that is big enough.
b	a boolean value.

Return

the length of the string.

rtl_ustr_valueOfChar

extern "C"
sal_Int32 rtl_ustr_valueOfChar(

sal_Unicode *	str,
sal_Unicode	ch );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Create the string representation of a character.

Parameters

str	a buffer that is big enough to hold the result and the terminating NUL character. You should use the RTL_USTR_MAX_VALUEOFCHAR define to create a buffer that is big enough.
ch	a character value.

Return

the length of the string.

rtl_ustr_valueOfDouble

extern "C"
sal_Int32 rtl_ustr_valueOfDouble(

sal_Unicode *	str,
double	d );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Create the string representation of a double.

Description

This function cannot be used for language-specific conversion.

Parameters

str	a buffer that is big enough to hold the result and the terminating NUL character. You should use the RTL_USTR_MAX_VALUEOFDOUBLE define to create a buffer that is big enough.
d	a double value.

Return

the length of the string.

rtl_ustr_valueOfFloat

extern "C"
sal_Int32 rtl_ustr_valueOfFloat(

sal_Unicode *	str,
float	f );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Create the string representation of a float.

Description

This function cannot be used for language-specific conversion.

Parameters

str	a buffer that is big enough to hold the result and the terminating NUL character. You should use the RTL_USTR_MAX_VALUEOFFLOAT define to create a buffer that is big enough.
f	a float value.

Return

the length of the string.

rtl_ustr_valueOfInt32

extern "C"
sal_Int32 rtl_ustr_valueOfInt32(

sal_Unicode *	str,
sal_Int32	i,
sal_Int16	radix );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Create the string representation of an integer.

Description

This function cannot be used for language-specific operations.

Parameters

str

    a buffer that is big enough to hold the result and the terminating NUL
    character.  You should use the RTL_USTR_MAX_VALUEOFINT32 define to create
    a buffer that is big enough.

i

    an integer value.

radix

    the radix.  Must be between RTL_USTR_MIN_RADIX (2) and RTL_USTR_MAX_RADIX
    (36), inclusive.

Return

the length of the string.

rtl_ustr_valueOfInt64

extern "C"
sal_Int32 rtl_ustr_valueOfInt64(

sal_Unicode *	str,
sal_Int64	l,
sal_Int16	radix );

virtual	abstract	const	volatile	template	static	inline	C-linkage
NO	NO	NO	NO	NO	NO	NO	YES

Summary

Create the string representation of a long integer.

Description

This function cannot be used for language-specific operations.

Parameters

str

    a buffer that is big enough to hold the result and the terminating NUL
    character.  You should use the RTL_USTR_MAX_VALUEOFINT64 define to create
    a buffer that is big enough.

l

    a long integer value.

radix

    the radix.  Must be between RTL_USTR_MIN_RADIX (2) and RTL_USTR_MAX_RADIX
    (36), inclusive.

Return

the length of the string.

API

SDK

Tips ‘n’ Tricks

Miscellaneous

Global Functions in Global Namespace C++
in Sourcefile ustring.h

API

SDK

Tips ‘n’ Tricks

Miscellaneous

Global Functions in Global Namespace C++ in Sourcefile ustring.h

Global Functions in Global Namespace C++
in Sourcefile ustring.h