Methods of Class OString

OString

OString() throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	NO	NO	NO	NO	YES	NO

要約: New string 含む／封じ込めるing no characters.

OString

OString(

const OString &

str ) throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	NO	NO	NO	NO	YES	NO

要約

New string from OString.

Parameters

str	a OString.

OString

OString(

rtl_String *

str ) throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	NO	NO	NO	NO	YES	NO

要約

New string from OString data.

Parameters

str	a OString data.

OString

explicit OString(

sal_Char

value ) throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	NO	NO	NO	NO	YES	NO

要約

New string from a 選び出す／独身 character.

Parameters

value

a character.

OString

OString(

const sal_Char *

value ) throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	NO	NO	NO	NO	YES	NO

要約

New string from a character 衝撃を和らげるもの array.

Parameters

value

a NULL-終結させるd character array.

OString

OString(

const sal_Char *	value,
sal_Int32	length ) throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	NO	NO	NO	NO	YES	NO

要約

New string from a character 衝撃を和らげるもの array.

Parameters

value	a character array.
length	the number of character which should be copied. The character array length must be greater or equal than this value.

OString

OString(

const sal_Unicode *	value,
sal_Int32	length,
rtl_TextEncoding	encoding,
sal_uInt32	convertFlags = OUSTRING_TO_OSTRING_CVTFLAGS );

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	NO	NO	NO	NO	YES	NO

要約

New string from a Unicode character 衝撃を和らげるもの array.

Parameters

value	a Unicode character array.
length	the number of character which should be 変えるd. The Unicode character array length must be greater or equal than this value.
encoding	the text encoding in which the Unicode character sequence should be 変えるd.
convertFlags	旗s which 支配（する）／統制するs the 転換. see RTL_UNICODETOTEXT_FLAGS_...

~OString

~OString() throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	NO	NO	NO	NO	YES	NO

要約: 解放（する） the string data.

操作者=

OString & 操作者=(

const OString &

str ) throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	NO	NO	NO	NO	YES	NO

要約

割り当てる a new string.

Parameters

str	a OString.

操作者+=

OString & 操作者+=(

const OString &

str ) throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	NO	NO	NO	NO	YES	NO

要約

Append a string to this string.

Parameters

str	a OString.

getLength

sal_Int32 getLength() throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	NO	NO	NO	NO	YES	NO

要約: Returns the length of this string.
Description: The length is equal to the number of characters in this string.
Return: the length of the sequence of characters 代表するd by this 反対する.

操作者 const sal_Char *

操作者 const sal_Char *() throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	NO	NO	NO	NO	YES	NO

要約: Returns a pointer to the characters of this string.
Description: The returned pointer is not 保証（人）d to point to a null-終結させるd byte string. 公式文書，認める that this string 反対する may 含む／封じ込める embedded null characters, which will thus also be embedded in the returned byte string.
Return: a pointer to a (not やむを得ず null-終結させるd) byte string 代表するing the characters of this string 反対する.

getStr

const sal_Char * getStr() throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	NO	NO	NO	NO	YES	NO

要約: Returns a pointer to the characters of this string.
Description: The returned pointer is 保証（人）d to point to a null-終結させるd byte string. But 公式文書，認める that this string 反対する may 含む／封じ込める embedded null characters, which will thus also be embedded in the returned null-終結させるd byte string.
Return: a pointer to a null-終結させるd byte string 代表するing the characters of this string 反対する.

compareTo

sal_Int32 compareTo(

const OString &

str ) const throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	YES	NO	NO	NO	YES	NO

要約

Compares two strings.

Description

The comparison is based on the numeric value of each character in the strings and return a value 示すing their 関係. This 機能（する）／行事 can't be used for language 明確な／細部 sorting.

Parameters

str	the 反対する to be compared.

Return

0 - if both strings are equal < 0 - if this string is less than the string argument > 0 - if this string is greater than the string argument

compareTo

sal_Int32 compareTo(

const OString &	rObj,
sal_Int32	maxLength ) const throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	YES	NO	NO	NO	YES	NO

要約

Compares two strings with an 最大限 count of characters.

Description

The comparison is based on the numeric value of each character in the strings and return a value 示すing their 関係. This 機能（する）／行事 can't be used for language 明確な／細部 sorting.

Parameters

str	the 反対する to be compared.
maxLength	the 最大限 count of characters to be compared.

Return

0 - if both strings are equal < 0 - if this string is less than the string argument > 0 - if this string is greater than the string argument

reverseCompareTo

sal_Int32 reverseCompareTo(

const OString &

str ) const throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	YES	NO	NO	NO	YES	NO

要約

Compares two strings in 逆転する order.

Description

The comparison is based on the numeric value of each character in the strings and return a value 示すing their 関係. This 機能（する）／行事 can't be used for language 明確な／細部 sorting.

Parameters

str	the 反対する to be compared.

Return

0 - if both strings are equal < 0 - if this string is less than the string argument > 0 - if this string is greater than the string argument

equals

sal_Bool equals(

const OString &

str ) const throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	YES	NO	NO	NO	YES	NO

要約

成し遂げる a comparison of two strings.

Description

The result is true if and only if second string 代表するs the same sequence of characters as the first string. This 機能（する）／行事 can't be used for language 明確な／細部 comparison.

Parameters

str	the 反対する to be compared.

Return

sal_True if the strings are equal; sal_False, さもなければ.

equalsIgnoreAsciiCase

sal_Bool equalsIgnoreAsciiCase(

const OString &

str ) const throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	YES	NO	NO	NO	YES	NO

要約

成し遂げる a ASCII lowercase comparison of two strings.

Description

The result is true if and only if second string 代表するs the same sequence of characters as the first string, ignoring the 事例／患者. Character values between 65 and 90 (ASCII A-Z) are 解釈する／通訳するd as values between 97 and 122 (ASCII a-z). This 機能（する）／行事 can't be used for language 明確な／細部 comparison.

Parameters

str	the 反対する to be compared.

Return

sal_True if the strings are equal; sal_False, さもなければ.

match

sal_Bool match(

const OString &	str,
sal_Int32	fromIndex = 0 ) const throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	YES	NO	NO	NO	YES	NO

要約

Match against a substring appearing in this string.

Description

The result is true if and only if the second string appears as a substring of this string, at the given position. This 機能（する）／行事 can't be used for language 明確な／細部 comparison.

Parameters

str	the 反対する (substring) to be compared.
fromIndex	the 索引 to start the comparion from. The 索引 must be greater or equal than 0 and いっそう少なく or equal as the string length.

Return

sal_True if str match with the characters in the string at the given position; sal_False, さもなければ.

matchIgnoreAsciiCase

sal_Bool matchIgnoreAsciiCase(

const OString &	str,
sal_Int32	fromIndex = 0 ) const throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	YES	NO	NO	NO	YES	NO

要約

Match against a substring appearing in this string, ignoring the 事例／患者 of ASCII letters.

Description

The result is true if and only if the second string appears as a substring of this string, at the given position. Character values between 65 and 90 (ASCII A-Z) are 解釈する／通訳するd as values between 97 and 122 (ASCII a-z). This 機能（する）／行事 can't be used for language 明確な／細部 comparison.

Parameters

str	the 反対する (substring) to be compared.
fromIndex	the 索引 to start the comparion from. The 索引 must be greater or equal than 0 and いっそう少なく or equal as the string length.

Return

sal_True if str match with the characters in the string at the given position; sal_False, さもなければ.

hashCode

sal_Int32 hashCode() throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	NO	NO	NO	NO	YES	NO

要約: Returns a hashcode for this string.
Return: a hash code value for this 反対する.
See Also: rtl::OStringHash
for
convenient
use
of
STLPort's
hash_map

indexOf

sal_Int32 indexOf(

sal_Char	ch,
sal_Int32	fromIndex = 0 ) const throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	YES	NO	NO	NO	YES	NO

要約

Returns the 索引 within this string of the first occurrence of the 明示するd character, starting the search at the 明示するd 索引.

Parameters

ch	character to be 位置を示すd.
fromIndex	the 索引 to start the search from. The 索引 must be greater or equal than 0 and いっそう少なく or equal as the string length.

Return

the 索引 of the first occurrence of the character in the character sequence 代表するd by this string that is greater than or equal to fromIndex, or -1 if the character does not occur.

lastIndexOf

sal_Int32 lastIndexOf(

sal_Char

ch ) const throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	YES	NO	NO	NO	YES	NO

要約

Returns the 索引 within this string of the last occurrence of the 明示するd character, searching backward starting at the end.

Parameters

ch	character to be 位置を示すd.

Return

the 索引 of the last occurrence of the character in the character sequence 代表するd by this string, or -1 if the character does not occur.

lastIndexOf

sal_Int32 lastIndexOf(

sal_Char	ch,
sal_Int32	fromIndex ) const throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	YES	NO	NO	NO	YES	NO

Description

Returns the 索引 within this string of the last occurrence of the 明示するd character, searching backward starting before the 明示するd 索引.

Parameters

ch	character to be 位置を示すd.
fromIndex	the 索引 before which to start the search.

Return

the 索引 of the last occurrence of the character in the character sequence 代表するd by this string that is いっそう少なく than fromIndex, or -1 if the character does not occur before that point.

indexOf

sal_Int32 indexOf(

const OString &	str,
sal_Int32	fromIndex = 0 ) const throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	YES	NO	NO	NO	YES	NO

要約

Returns the 索引 within this string of the first occurrence of the 明示するd substring, starting at the 明示するd 索引.

Description

If str doesn't 含む any character, always -1 is returned. This is also the 事例／患者, if both strings are empty.

Parameters

str	the substring to search for.
fromIndex	the 索引 to start the search from.

Return

If the string argument occurs one or more times as a substring within this string at the starting 索引, then the 索引 of the first character of the first such substring is returned. If it does not occur as a substring starting at fromIndex or beyond, -1 is returned.

lastIndexOf

sal_Int32 lastIndexOf(

const OString &

str ) const throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	YES	NO	NO	NO	YES	NO

要約

Returns the 索引 within this string of the last occurrence of the 明示するd substring, searching backward starting at the end.

Description

The returned 索引示すs the starting 索引 of the substring in this string. If str doesn't 含む any character, always -1 is returned. This is also the 事例／患者, if both strings are empty.

Parameters

str	the substring to search for.

Return

If the string argument occurs one or more times as a substring within this string, then the 索引 of the first character of the last such substring is returned. If it does not occur as a substring, -1 is returned.

lastIndexOf

sal_Int32 lastIndexOf(

const OString &	str,
sal_Int32	fromIndex ) const throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	YES	NO	NO	NO	YES	NO

Description

Returns the 索引 within this string of the last occurrence of the 明示するd substring, searching backward starting before the 明示するd 索引. The returned 索引示すs the starting 索引 of the substring in this string. If str doesn't 含む any character, always -1 is returned. This is also the 事例／患者, if both strings are empty.

Parameters

str	the substring to search for.
fromIndex	the 索引 before which to start the search.

Return

If the string argument occurs one or more times as a substring within this string before the starting 索引, then the 索引 of the first character of the last such substring is returned. さもなければ, -1 is returned.

copy

OString copy(

sal_Int32

beginIndex ) const throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	YES	NO	NO	NO	YES	NO

要約

Returns a new string that is a substring of this string.

Description

The substring begins at the 明示するd beginIndex. It is an error for beginIndex to be 消極的な or to be greater than the length of this string.

Parameters

beginIndex

the beginning 索引, inclusive.

Return

the 明示するd substring.

copy

OString copy(

sal_Int32	beginIndex,
sal_Int32	count ) const throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	YES	NO	NO	NO	YES	NO

要約

Returns a new string that is a substring of this string.

Description

The substring begins at the 明示するd beginIndex and 含む／封じ込めるs count characters. It is an error for either beginIndex or count to be 消極的な, or for beginIndex + count to be greater than the length of this string.

Parameters

beginIndex	the beginning 索引, inclusive.
count	the number of characters.

Return

the 明示するd substring.

concat

OString concat(

const OString &

str ) const throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	YES	NO	NO	NO	YES	NO

要約

Concatenates the 明示するd string to the end of this string.

Parameters

str	the string that is concatenated to the end of this string.

Return

a string that 代表するs the concatenation of this string followed by the string argument.

replaceAt

OString replaceAt(

sal_Int32	索引,
sal_Int32	count,
const OString &	newStr ) const throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	YES	NO	NO	NO	YES	NO

要約

Returns a new string resulting from 取って代わるing n = count characters from position 索引 in this string with newStr.

Parameters

索引

the 取って代わるing 索引 in str.
                The 索引 must be greater or equal as 0 and
                いっそう少なく or equal as the length of the string.

count

the count of charcters that will 取って代わるd
                The count must be greater or equal as 0 and
                いっそう少なく or equal as the length of the string minus 索引.

newStr

the new substring.

Return

the new string.

取って代わる

OString 取って代わる(

sal_Char	oldChar,
sal_Char	newChar ) const throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	YES	NO	NO	NO	YES	NO

要約

Returns a new string resulting from 取って代わるing all occurrences of oldChar in this string with newChar.

Description

If the character oldChar does not occur in the character sequence 代表するd by this 反対する, then the string is 割り当てるd with str.

Parameters

oldChar	the old character.
newChar	the new character.

Return

a string derived from this string by 取って代わるing every occurrence of oldChar with newChar.

toAsciiLowerCase

OString toAsciiLowerCase() throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	NO	NO	NO	NO	YES	NO

要約: 変えるs from this string all ASCII uppercase characters (65-90) to ASCII lowercase characters (97-122).
Description: This 機能（する）／行事 can't be used for language 明確な／細部転換. If the string doesn't 含む／封じ込める characters which must be 変えるd, then the new string is 割り当てるd with str.
Return: the string, 変えるd to ASCII lowercase.

toAsciiUpperCase

OString toAsciiUpperCase() throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	NO	NO	NO	NO	YES	NO

要約: 変えるs from this string all ASCII lowercase characters (97-122) to ASCII uppercase characters (65-90).
Description: This 機能（する）／行事 can't be used for language 明確な／細部転換. If the string doesn't 含む／封じ込める characters which must be 変えるd, then the new string is 割り当てるd with str.
Return: the string, 変えるd to ASCII uppercase.

削減する

OString 削減する() throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	NO	NO	NO	NO	YES	NO

要約: Returns a new string resulting from 除去するing white space from both ends of the string.
Description: All characters that have codes いっそう少なく than or equal to 32 (the space character) are considered to be white space. If the string doesn't 含む／封じ込める white spaces at both ends, then the new string is 割り当てるd with str.
Return: the string, with white space 除去するd from the 前線 and end.

getToken

OString getToken(

sal_Int32	記念品,
sal_Char	cTok,
sal_Int32 &	索引 ) const throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	YES	NO	NO	NO	YES	NO

要約

Returns a 記念品 in the string.

Description

Example: sal_Int32 nIndex = 0; do { ... OString aToken = aStr.getToken( 0, ';', nIndex ); ... } while ( nIndex >= 0 );

Parameters

記念品

the number of the 記念品 to return.

cTok

the character which seperate the 記念品s.

索引

the position at which the 記念品 is searched in the
                            string.
                            The 索引 must not be greater thanthe length of the
                            string.
                            This param is 始める，決める to the position of the
                            next 記念品 or to -1, if it is the last 記念品.

Return

the 記念品; if either 記念品 or 索引 is 消極的な, an empty 記念品 is returned (and 索引 is 始める，決める to -1)

toBoolean

sal_Bool toBoolean() throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	NO	NO	NO	NO	YES	NO

要約: Returns the Boolean value from this string.
Description: This 機能（する）／行事 can't be used for language 明確な／細部転換.
Return: sal_True, if the string is 1 or "True" in any ASCII 事例／患者. sal_False in any other 事例／患者.

toChar

sal_Char toChar() throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	NO	NO	NO	NO	YES	NO

要約: Returns the first character from this string.
Return: the first character from this string or 0, if this string is emptry.

toInt32

sal_Int32 toInt32(

sal_Int16

radix = 10 ) const throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	YES	NO	NO	NO	YES	NO

要約

Returns the int32 value from this string.

Description

This 機能（する）／行事 can't be used for language 明確な／細部転換.

Parameters

radix

the radix (between 2 and 36)

Return

the int32 代表するd from this string. 0 if this string 代表するs no number.

toInt64

sal_Int64 toInt64(

sal_Int16

radix = 10 ) const throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	YES	NO	NO	NO	YES	NO

要約

Returns the int64 value from this string.

Description

This 機能（する）／行事 can't be used for language 明確な／細部転換.

Parameters

radix

the radix (between 2 and 36)

Return

the int64 代表するd from this string. 0 if this string 代表するs no number.

toFloat

float toFloat() throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	NO	NO	NO	NO	YES	NO

要約: Returns the float value from this string.
Description: This 機能（する）／行事 can't be used for language 明確な／細部転換.
Return: the float 代表するd from this string. 0.0 if this string 代表するs no number.

toDouble

二塁打 toDouble() throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	NO	NO	NO	NO	YES	NO

要約: Returns the 二塁打 value from this string.
Description: This 機能（する）／行事 can't be used for language 明確な／細部転換.
Return: the 二塁打代表するd from this string. 0.0 if this string 代表するs no number.

valueOf

static OString valueOf(

sal_Bool

b ) throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	NO	NO	NO	YES	YES	NO

要約

Returns the string 代表 of the sal_Bool argument.

Description

If the sal_Bool is true, the string "true" is returned. If the sal_Bool is 誤った, the string "誤った" is returned. This 機能（する）／行事 can't be used for language 明確な／細部転換.

Parameters

b	a sal_Bool.

Return

a string with the string 代表 of the argument.

valueOf

static OString valueOf(

sal_Char

c ) throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	NO	NO	NO	YES	YES	NO

要約

Returns the string 代表 of the char argument.

Parameters

c	a character.

Return

a string with the string 代表 of the argument.

valueOf

static OString valueOf(

sal_Int32	i,
sal_Int16	radix = 10 ) throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	NO	NO	NO	YES	YES	NO

要約

Returns the string 代表 of the int argument.

Description

This 機能（する）／行事 can't be used for language 明確な／細部転換.

Parameters

i	a int32.
radix	the radix (between 2 and 36)

Return

a string with the string 代表 of the argument.

valueOf

static OString valueOf(

sal_Int64	ll,
sal_Int16	radix = 10 ) throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	NO	NO	NO	YES	YES	NO

要約

Returns the string 代表 of the long argument.

Description

This 機能（する）／行事 can't be used for language 明確な／細部転換.

Parameters

ll	a int64.
radix	the radix (between 2 and 36)

Return

a string with the string 代表 of the argument.

valueOf

static OString valueOf(

float

f ) throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	NO	NO	NO	YES	YES	NO

要約

Returns the string 代表 of the float argument.

Description

This 機能（する）／行事 can't be used for language 明確な／細部転換.

Parameters

f

a float.

Return

a string with the string 代表 of the argument.

valueOf

static OString valueOf(

二塁打	d ) throw();

事実上の	abstract	const	volatile	template	static	inline	C-結合，連鎖
NO	NO	NO	NO	NO	YES	YES	NO

要約

Returns the string 代表 of the 二塁打 argument.

Description

This 機能（する）／行事 can't be used for language 明確な／細部転換.

Parameters

d

a 二塁打.

Return

a string with the string 代表 of the argument.

API

SDK

Tips ‘n’ Tricks

Miscellaneous

Methods of Class OString