Assimp
v2.0 (November 2010)
|
Represents an UTF-8 string, zero byte terminated. More...
Public Member Functions | |
aiString () | |
Default constructor, the string is set to have zero length. | |
aiString (const aiString &rOther) | |
Copy constructor. | |
aiString (const std::string &pString) | |
Constructor from std::string. | |
void | Append (const char *app) |
Append a string to the string. | |
void | Clear () |
Clear the string - reset its length to zero. | |
bool | operator!= (const aiString &other) const |
Inverse comparison operator. | |
aiString & | operator= (const char *sz) |
Assign a const char* to the string. | |
aiString & | operator= (const std::string &pString) |
Assign a cstd::string to the string. | |
bool | operator== (const aiString &other) const |
Comparison operator. | |
void | Set (const std::string &pString) |
Copy a std::string to the aiString. | |
void | Set (const char *sz) |
Copy a const char* to the aiString. | |
Public Attributes | |
char | data [MAXLEN] |
String buffer. | |
size_t | length |
Binary length of the string excluding the terminal 0. |
Represents an UTF-8 string, zero byte terminated.
The character set of an aiString is explicitly defined to be UTF-8. This Unicode transformation was chosen in the belief that most strings in 3d files are limited to ASCII, thus the character set needed to be strictly ASCII compatible.
Most text file loaders provide proper Unicode input file handling, special unicode characters are correctly transcoded to UTF8 and are kept throughout the libraries' import pipeline.
For most applications, it will be absolutely sufficient to interpret the aiString as ASCII data and work with it as one would work with a plain char*. Windows users in need of proper support for i.e asian characters can use the #MultiByteToWideChar(), #WideCharToMultiByte() WinAPI functionality to convert the UTF-8 strings to their working character set (i.e. MBCS, WideChar).
We use this representation instead of std::string to be C-compatible. The (binary) length of such a string is limited to MAXLEN characters (including the the terminating zero).
aiString::aiString | ( | ) | [inline] |
Default constructor, the string is set to have zero length.
aiString::aiString | ( | const aiString & | rOther | ) | [inline] |
Copy constructor.
aiString::aiString | ( | const std::string & | pString | ) | [inline, explicit] |
Constructor from std::string.
void aiString::Append | ( | const char * | app | ) | [inline] |
Append a string to the string.
void aiString::Clear | ( | ) | [inline] |
Clear the string - reset its length to zero.
bool aiString::operator!= | ( | const aiString & | other | ) | const [inline] |
Inverse comparison operator.
aiString& aiString::operator= | ( | const char * | sz | ) | [inline] |
Assign a const char* to the string.
aiString& aiString::operator= | ( | const std::string & | pString | ) | [inline] |
Assign a cstd::string to the string.
bool aiString::operator== | ( | const aiString & | other | ) | const [inline] |
Comparison operator.
void aiString::Set | ( | const std::string & | pString | ) | [inline] |
Copy a std::string to the aiString.
void aiString::Set | ( | const char * | sz | ) | [inline] |
Copy a const char* to the aiString.
char aiString::data[MAXLEN] |
String buffer.
Size limit is MAXLEN
size_t aiString::length |
Binary length of the string excluding the terminal 0.
This is NOT the logical length of strings containing UTF-8 multibyte sequences! It's the number of bytes from the beginning of the string to its end.