就业培训     下载中心     Wiki     联络 登录   注册

---

1. 首页
2. C4D R23.110 C++ SDK

Classes | Public Types | 公共成员函数 | 静态公共成员函数 | 私有成员函数 | 所有成员列表

String Class Reference 系统

#include <string.h>

Inheritance diagram for String:

[ legend ]

详细描述

Class to store unicode strings. String stores unicode characters. Any unicode characters are legal, including 0C (strings are not null-terminated). Strings are reference-counted objects. This means that as long as you copy and do not modify strings they are just referenced. The first modification breaks the link and it becomes a unique new object.

Error handling for String For convenience the String class has a relaxed out of memory handling, for example String ("Example", 7) might fail, but since it's a constructor there's no Result returned. The same goes for String a += b; In most cases this is no problem at all: If for example you want to concatenate a file url and this fails then loading the file will fail anyway. Nonetheless there cases where you must ensure that a string operation has succeeded. To enable this for methods, operators or constructor which are not returning a Result but modify the String (are non-const) the internal reference will be set to a nullptr on allocation failure. And this can be checked using iferr, iferr_return (or even GetPointer() would work). For example:

String x = String ( cstr , strlen( cstr )) iferr_return ; String y = "example" _s iferr_return ; x.Append(y) iferr_return ; (x += y) iferr_return ; x = (x + y) iferr_return ; String z = x.GetPart(0, 1) iferr_return ;

注意

For + or += you have to enclose the expression in brackets, otherwise iferr_return will check the wrong term.

Error detection does not work for concatenated operations, e.g. for x.Append(y).Append(z) you cannot detect an error, the same goes for x = x + y + z;

Member Typedef Documentation

◆  ValueType

◆  ConstIterator

◆  Iterator

构造函数 & 析构函数文档编制

◆  String() [1/10]

Constructor from Char array. If you have static strings use "..."_s instead.

参数

[in]	str	C string block.
[in]	count	Number of characters, -1 to auto detect the length of the string (search for the first 0).
[in]	stringDecoding	Encoding type.

◆  String() [2/10]

Constructor from Char array. If you have static strings use "..."_s instead.

参数

[in]	str	C string block.
[in]	stringDecoding	Encoding type.

◆  String() [3/10]

Constructor from a Char Block . If you have static strings use "..."_s instead.

参数

[in]	str	Char block, for example a BaseArray<Char> .
[in]	stringDecoding	Encoding type.

◆  String() [4/10]

Constructor from CString .

参数

[in]	str	CString .
[in]	stringDecoding	Encoding type.

◆  String() [5/10]

Constructor from UTF-32 Utf32Char array. If you have static character strings use "..."_s instead.

参数

[in]	str	UTF-32 character block.
[in]	count	Number of characters, -1 to auto detect the length of the string (search for the first 0).

◆  String() [6/10]

Constructor from UTF-32 Utf32Char Block .

参数

[in]

str

UTF-32 character block.

◆  String() [7/10]

Constructor from UTF-16 Utf16Char array.

参数

[in]	str	UTF-16 character block.
[in]	count	Number of characters, -1 to auto detect the length of the string (search for the first 0).

◆  String() [8/10]

Constructor to create a string with a specific length and a default character.

参数

[in]	count	Number of characters of the new string.
[in]	fillChar	Character to fill the string with.

◆  String() [9/10]

Constructs a string consisting of #prefix followed by an @ sign and the hex-formatted #ptr.

参数

[in]	prefix	The prefix for the string.
[in]	ptr	A pointer.

◆  String() [10/10]

Constructor to create a string from a prefix and pointer address as hexadecimal text.

参数

[in]	prefix	The prefix string.
[in]	ptr	The pointer that will be added as hexadecimal text.
[in]	prefix0x	If true the pointer will start with '0x'.

成员函数文档编制

◆  MAXON_DEFAULT_REFERENCE_CONSTRUCTORS()

◆  operator[]() [1/2]

Index operator to access single characters of the string.

参数

[in]

pos

Position within the string the first character starts with an index of 0. If the position is out of boundaries 0 will be returned.

返回

Utf32Char for read (right of =), Utf32Char& for write (left of =).

◆  operator[]() [2/2]

Index operator to access single characters of the string.

参数

[in]

position

Position within the string the first character starts with an index of 0. if the position is out of boundaries no changes will be made.

返回

Utf32Char for read (right of =), Utf32Char& for write (left of =).

◆  Begin()

Returns and iterator pointing to the first character of this string.

返回

Iterator for first character.

◆  End()

Returns and iterator pointing to the end of this string (one behind last character).

返回

Iterator for the end.

◆  IsEmpty()

Returns if the string length is zero.

返回

True if the string doesn't contain any character, or if it is a nullptr.

◆  IsPopulated()

Returns if the string contains any characters.

返回

True if the string contains any character.

◆  operator+=()

Appends #str at the end of this string.

参数

[in]

str

Another string to append.

返回

Reference to this string.

◆  GetLineEnd()

Returns a string with the platform specific line ending.

返回

String containing the line ending ("\r\n" or "\r").

◆  operator->()

• maxon
• String