3ds Max C++ API Reference
|
#include <strclass.h>
Public Member Functions | |
UTF8Str () | |
UTF8Str (const char *cs) | |
UTF8Str (const UTF8Str &ws) | |
UTF8Str (UTF8Str &&ws) | |
UTF8Str (const MaxSDK::Util::MaxString &ws) | |
UTF8Str (const MaxSDK::Util::MaxStringCastUTF8 &) | |
UTF8Str (const QString &qstring) | |
Conversion constructor, from QString. | |
~UTF8Str () | |
char * | dataForWrite (size_t nchars=(size_t) -1) |
Returns a pointer to this string which can be written to with up to 'nchars' characters. | |
const char * | data () const |
operator const char * () const & | |
operator const char * () &&=delete | |
operator const char * () const &&=delete | |
operator QString () const | |
Conversion operator to QString. | |
void | Resize (int nchars) |
int | Length () const |
int | length () const |
int | ByteCount () const |
int | LanguageCharacterCount () const |
size_t | AllocatedChars () const |
bool | isNull () const |
UTF8Str & | operator= (const UTF8Str &cs) |
UTF8Str & | operator= (UTF8Str &&cs) |
UTF8Str & | operator= (const MaxSDK::Util::MaxString &mstr) |
UTF8Str & | operator= (const MaxSDK::Util::MaxStringCastUTF8 &) |
UTF8Str & | operator= (const char *cs) |
UTF8Str | operator+ (const UTF8Str &cs) const |
UTF8Str & | operator+= (const UTF8Str &cs) |
UTF8Str & | Append (const UTF8Str &cs) |
UTF8Str & | append (const UTF8Str &cs) |
UTF8Str | MultiByteCharacterSubString (int firstCharacterIndex, int numberOfMBCharacters) const |
int | FindMultiByteCharacterFirstByteIndex (int characterIndex) const |
int | FindMultiByteCharacterLastByteIndex (int characterIndex) const |
bool | operator== (const UTF8Str &cs) const |
bool | operator!= (const UTF8Str &cs) const |
bool | operator< (const UTF8Str &cs) const |
bool | operator<= (const UTF8Str &ws) const |
bool | operator> (const UTF8Str &ws) const |
bool | operator>= (const UTF8Str &ws) const |
void | toUpper () |
void | toLower () |
int | printf (const char *format,...) |
Write a formatted string into this UTF8Str. | |
int | printf (UTF8Str format,...) |
int | printf_l (const char *format, const _locale_t theLocale,...) |
Write a formatted string into this UTF8Str using specified locale. | |
int | vprintf (const char *format, va_list args) |
Write a formatted string into this UTF8Str. | |
int | vprintf_l (const char *format, const _locale_t theLocale, va_list args) |
Write a formatted string into this UTF8Str using specified locale. | |
wchar_t * | ToBSTR () const |
MaxSDK::Util::MaxStringCastCP | ToCP (UINT cp, size_t *length=NULL) const |
MaxSDK::Util::MaxStringCast< char > | ToACP (size_t *length=NULL) const |
MaxSDK::Util::MaxStringCastUTF8 | ToUTF8 (size_t *length=NULL) const |
MaxSDK::Util::MaxStringCast< WCHAR > | ToOLESTR (size_t *length=NULL) const |
MaxSDK::Util::MaxStringCast< WCHAR > | ToUTF16 (size_t *length=NULL) const |
MaxSDK::Util::MaxStringCast< unsigned int > | ToUTF32 (size_t *length=NULL) const |
MaxSDK::Util::MaxString | ToMaxString () const |
void | ToMaxString (MaxSDK::Util::MaxString &) const |
UTF8Str | ToUTF8Str () const |
WStr | ToWStr () const |
MaxSDK::Util::MaxStringCast< wchar_t > | ToMCHAR (size_t *length=NULL) const |
WStr | ToMSTR () const |
bool | EndsWith (const UTF8Str &s, bool caseSensitive=true) const |
Returns true if the string ends with s; otherwise returns false. | |
bool | StartsWith (const UTF8Str &s, bool caseSensitive=true) const |
Returns true if the string starts with s; otherwise returns false. | |
size_t | NumberOfLines () const |
Returns the number of line feeds inside a string. | |
Static Public Member Functions | |
static UTF8Str | FromBSTR (const wchar_t *string, size_t length=(size_t) -1) |
static UTF8Str | FromCP (UINT cp, const char *string, size_t length=(size_t) -1) |
static UTF8Str | FromACP (const char *string, size_t length=(size_t) -1) |
static UTF8Str | FromUTF8 (const char *string, size_t length=(size_t) -1) |
static UTF8Str | FromOLESTR (const wchar_t *string, size_t length=(size_t) -1) |
static UTF8Str | FromUTF16 (const wchar_t *string, size_t length=(size_t) -1) |
static UTF8Str | FromUTF32 (const unsigned int *string, size_t length=(size_t) -1) |
static UTF8Str | FromMaxString (MaxSDK::Util::MaxString &string) |
static UTF8Str | FromUTF8Str (const UTF8Str &string) |
static UTF8Str | FromWStr (const WStr &string) |
static UTF8Str | FromMCHAR (const wchar_t *string, size_t length=(size_t) -1) |
static UTF8Str | FromMSTR (const WStr &string) |
![]() | |
static UtilExport void * | operator new (size_t size) |
Standard new operator used to allocate objects If there is insufficient memory, an exception will be thrown. | |
static UtilExport void * | operator new (size_t size, const std::nothrow_t &e) |
Standard new operator used to allocate objects if there is insufficient memory, NULL will be returned. | |
static UtilExport void * | operator new (size_t size, const char *filename, int line) |
New operator used to allocate objects that takes the filename and line number where the new was called If there is insufficient memory, an exception will be thrown. | |
static UtilExport void * | operator new (size_t size, int block_type, const char *filename, int line) |
New operator used to allocate objects that takes the type of memory, filename and line number where the new was called If there is insufficient memory, an exception will be thrown. | |
static UtilExport void * | operator new (size_t size, const std::nothrow_t &e, const char *filename, int line) |
New operator used to allocate objects that takes the filename and line number where the new was called If there is insufficient memory, NULL will be returned. | |
static UtilExport void * | operator new (size_t size, unsigned long flags) |
New operator used to allocate objects that takes extra flags to specify special operations If there is insufficient memory, an exception will be thrown. | |
static UtilExport void * | operator new (size_t size, const std::nothrow_t &e, unsigned long flags) |
New operator used to allocate objects that takes extra flags to specify special operations If there is insufficient memory, NULL will be returned. | |
static UtilExport void * | operator new[] (size_t size) |
New operator used to allocate arrays of objects If there is insufficient memory, an exception will be thrown. | |
static UtilExport void * | operator new[] (size_t size, const std::nothrow_t &e) |
New operator used to allocate arrays of objects If there is insufficient memory, NULL will be returned. | |
static UtilExport void * | operator new[] (size_t size, const char *filename, int line) |
New operator used to allocate arrays of objects If there is insufficient memory, an exception will be thrown. | |
static UtilExport void * | operator new[] (size_t size, int block_type, const char *filename, int line) |
New operator used to allocate arrays of objects. | |
static UtilExport void * | operator new[] (size_t size, const std::nothrow_t &e, const char *filename, int line) |
New operator used to allocate arrays of objects If there is insufficient memory, NULL will be returned. | |
static UtilExport void * | operator new[] (size_t size, unsigned long flags) |
New operator used to allocate arrays of objects If there is insufficient memory, an exception will be thrown. | |
static UtilExport void * | operator new[] (size_t size, const std::nothrow_t &e, unsigned long flags) |
New operator used to allocate arrays of objects If there is insufficient memory, NULL will be returned. | |
static UtilExport void | operator delete (void *ptr) |
Standard delete operator used to deallocate an object If the pointer is invalid, an exception will be thrown. | |
static UtilExport void | operator delete (void *ptr, const std::nothrow_t &e) |
Standard delete operator used to deallocate an object If the pointer is invalid, nothing will happen. | |
static UtilExport void | operator delete (void *ptr, const char *filename, int line) |
Delete operator used to deallocate an object that takes the filename and line number where the delete was called If the pointer is invalid, an exception will be thrown. | |
static UtilExport void | operator delete (void *ptr, int block_type, const char *filename, int line) |
Delete operator used to deallocate an object that takes the type of memory, filename and line number where the delete was called If the pointer is invalid, an exception will be thrown. | |
static UtilExport void | operator delete (void *ptr, const std::nothrow_t &e, const char *filename, int line) |
Delete operator used to deallocate an object that takes the filename and line number where the delete was called If the pointer is invalid, nothing will happen. | |
static UtilExport void | operator delete (void *ptr, unsigned long flags) |
Delete operator used to deallocate an object that takes extra flags to specify special operations If the pointer is invalid, an exception will be thrown. | |
static UtilExport void | operator delete (void *ptr, const std::nothrow_t &e, unsigned long flags) |
Delete operator used to deallocate an object that takes extra flags to specify special operations If the pointer is invalid, nothing will happen. | |
static UtilExport void | operator delete[] (void *ptr) |
Standard delete operator used to deallocate an array of objects If the pointer is invalid, an exception will be thrown. | |
static UtilExport void | operator delete[] (void *ptr, const std::nothrow_t &e) |
Standard delete operator used to deallocate an array of objects If the pointer is invalid, nothing will happen. | |
static UtilExport void | operator delete[] (void *ptr, const char *filename, int line) |
Delete operator used to deallocate an array of objects that takes the filename and line number where the delete was called If the pointer is invalid, an exception will be thrown. | |
static UtilExport void | operator delete[] (void *ptr, int block_type, const char *filename, int line) |
Delete operator used to deallocate an array of objects that takes the type of memory, filename and line number where the delete was called If the pointer is invalid, an exception will be thrown. | |
static UtilExport void | operator delete[] (void *ptr, const std::nothrow_t &e, const char *filename, int line) |
Delete operator used to deallocate an array of objects that takes the filename and line number where the delete was called If the pointer is invalid, nothing will happen. | |
static UtilExport void | operator delete[] (void *ptr, unsigned long flags) |
Delete operator used to deallocate an array of objects that takes extra flags to specify special operations If the pointer is invalid, an exception will be thrown. | |
static UtilExport void | operator delete[] (void *ptr, const std::nothrow_t &e, unsigned long flags) |
Delete operator used to deallocate an array of objects that takes extra flags to specify special operations If the pointer is invalid, an exception will be thrown. | |
static UtilExport void * | operator new (size_t size, void *placement_ptr) |
Placement new operator. | |
static UtilExport void | operator delete (void *ptr, void *placement_ptr) |
Placement delete operator. | |
static UtilExport void * | aligned_malloc (size_t size, size_t alignment) |
Allocates memory on a specified alignment boundary. | |
static UtilExport void * | aligned_realloc (void *ptr, size_t size, size_t alignment) |
Reallocates memory on a specified alignment boundary. | |
static UtilExport void | aligned_free (void *ptr) |
Frees a block of memory that was allocated with aligned_malloc/aligned_realloc. | |
UTF8Str | ( | ) |
UTF8Str | ( | const char * | cs | ) |
UTF8Str | ( | const MaxSDK::Util::MaxString & | ws | ) |
UTF8Str | ( | const MaxSDK::Util::MaxStringCastUTF8 & | ) |
UTF8Str | ( | const QString & | qstring | ) |
Conversion constructor, from QString.
~UTF8Str | ( | ) |
Returns a pointer to this string which can be written to with up to 'nchars' characters.
nchars | The minimum number of characters to allocate in the string buffer (excluding the terminating null character). A value of -1 specifies that the existing buffer should be re-used. |
const char * data | ( | ) | const |
operator const char * | ( | ) | const & |
|
delete |
|
delete |
operator QString | ( | ) | const |
Conversion operator to QString.
|
inline |
|
inline |
int ByteCount | ( | ) | const |
int LanguageCharacterCount | ( | ) | const |
size_t AllocatedChars | ( | ) | const |
|
inline |
UTF8Str & operator= | ( | const MaxSDK::Util::MaxString & | mstr | ) |
UTF8Str & operator= | ( | const MaxSDK::Util::MaxStringCastUTF8 & | ) |
UTF8Str & operator= | ( | const char * | cs | ) |
bool operator== | ( | const UTF8Str & | cs | ) | const |
bool operator!= | ( | const UTF8Str & | cs | ) | const |
bool operator< | ( | const UTF8Str & | cs | ) | const |
bool operator<= | ( | const UTF8Str & | ws | ) | const |
bool operator> | ( | const UTF8Str & | ws | ) | const |
bool operator>= | ( | const UTF8Str & | ws | ) | const |
void toUpper | ( | ) |
void toLower | ( | ) |
int printf | ( | const char * | format, |
... | |||
) |
Write a formatted string into this UTF8Str.
Writes the format string, filled in by the optional arguments into this UTF8Str. See the ISO C++ documentation for more information on printf and format strings. Note: do not use ls formatting since conversion from wide string to narrow string will occur using active code page encoding rather than utf8 encoding
format | Specifies how to format the destination string. |
... | optional arguments to format into the destination string. |
int printf_l | ( | const char * | format, |
const _locale_t | theLocale, | ||
... | |||
) |
Write a formatted string into this UTF8Str using specified locale.
Writes the format string, filled in by the optional arguments into this UTF8Str. See the ISO C++ documentation for more information on printf_l and format strings. Note: do not use ls formatting since conversion from wide string to narrow string will occur using active code page encoding rather than utf8 encoding
format | Specifies how to format the destination string. |
theLocale | The locale to use. |
... | optional arguments to format into the destination string. |
int vprintf | ( | const char * | format, |
va_list | args | ||
) |
Write a formatted string into this UTF8Str.
This method is similar to UTF8Str::printf. Instead of taking a variable list of arguments as parameter, it takes a structure representing a variable list of arguments. This allows UTF8Str objects to be used to build strings based on a format string and a variable number of arguments. Note: do not use ls formatting since conversion from wide string to narrow string will occur using active code page encoding rather than utf8 encoding
int vprintf_l | ( | const char * | format, |
const _locale_t | theLocale, | ||
va_list | args | ||
) |
Write a formatted string into this UTF8Str using specified locale.
This method is similar to UTF8Str::printf_l. Instead of taking a variable list of arguments as parameter, it takes a structure representing a variable list of arguments. This allows UTF8Str objects to be used to build strings based on a format string, a locale, and a variable number of arguments. Note: do not use ls formatting since conversion from wide string to narrow string will occur using active code page encoding rather than utf8 encoding
wchar_t * ToBSTR | ( | ) | const |
MaxSDK::Util::MaxStringCastCP ToCP | ( | UINT | cp, |
size_t * | length = NULL |
||
) | const |
MaxSDK::Util::MaxStringCast< char > ToACP | ( | size_t * | length = NULL | ) | const |
MaxSDK::Util::MaxStringCastUTF8 ToUTF8 | ( | size_t * | length = NULL | ) | const |
MaxSDK::Util::MaxStringCast< WCHAR > ToOLESTR | ( | size_t * | length = NULL | ) | const |
MaxSDK::Util::MaxStringCast< WCHAR > ToUTF16 | ( | size_t * | length = NULL | ) | const |
MaxSDK::Util::MaxStringCast< unsigned int > ToUTF32 | ( | size_t * | length = NULL | ) | const |
MaxSDK::Util::MaxString ToMaxString | ( | ) | const |
void ToMaxString | ( | MaxSDK::Util::MaxString & | ) | const |
|
inlinestatic |
|
inline |
WStr ToWStr | ( | ) | const |
|
inline |
WStr ToMSTR | ( | ) | const |
bool EndsWith | ( | const UTF8Str & | s, |
bool | caseSensitive = true |
||
) | const |
Returns true if the string ends with s; otherwise returns false.
s | The string to be searched. |
caseSensitive | If it is true(default), the search is case sensitive; otherwise the search is case insensitive. |
bool StartsWith | ( | const UTF8Str & | s, |
bool | caseSensitive = true |
||
) | const |
Returns true if the string starts with s; otherwise returns false.
s | The string to be searched. |
caseSensitive | If it is true(default), the search is case sensitive; otherwise the search is case insensitive. |
size_t NumberOfLines | ( | ) | const |
Returns the number of line feeds inside a string.