ICU 50.1.2
50.1.2
|
C++ API: Unicode String. More...
#include "unicode/utypes.h"
#include "unicode/rep.h"
#include "unicode/std_string.h"
#include "unicode/stringpiece.h"
#include "unicode/bytestream.h"
#include "unicode/ucasemap.h"
Go to the source code of this file.
Data Structures | |
class | icu::UnicodeString |
UnicodeString is a string class that stores Unicode characters directly and provides similar functionality as the Java String and StringBuffer classes. More... | |
Namespaces | |
icu | |
File coll.h. | |
Macros | |
#define | U_COMPARE_CODE_POINT_ORDER 0x8000 |
Option bit for u_strCaseCompare, u_strcasecmp, unorm_compare, etc: Compare strings in code point order instead of code unit order. More... | |
#define | U_STRING_CASE_MAPPER_DEFINED |
#define | US_INV icu::UnicodeString::kInvariant |
Constant to be used in the UnicodeString(char *, int32_t, EInvariant) constructor which constructs a Unicode string from an invariant-character char * string. More... | |
#define | UNICODE_STRING(cs, _length) icu::UnicodeString(TRUE, (const UChar *)L ## cs, _length) |
Unicode String literals in C++. More... | |
#define | UNICODE_STRING_SIMPLE(cs) UNICODE_STRING(cs, -1) |
Unicode String literals in C++. More... | |
#define | UNISTR_FROM_CHAR_EXPLICIT |
This can be defined to be empty or "explicit". More... | |
#define | UNISTR_FROM_STRING_EXPLICIT |
This can be defined to be empty or "explicit". More... | |
Typedefs | |
typedef int32_t | UStringCaseMapper (const UCaseMap *csm, UChar *dest, int32_t destCapacity, const UChar *src, int32_t srcLength, UErrorCode *pErrorCode) |
Internal string case mapping function type. More... | |
Functions | |
int32_t | u_strlen (const UChar *s) |
Determine the length of an array of UChar. More... | |
U_COMMON_API UnicodeString | icu::operator+ (const UnicodeString &s1, const UnicodeString &s2) |
Create a new UnicodeString with the concatenation of two others. More... | |
C++ API: Unicode String.
Definition in file unistr.h.
#define U_COMPARE_CODE_POINT_ORDER 0x8000 |
#define U_STRING_CASE_MAPPER_DEFINED |
#define UNICODE_STRING | ( | cs, | |
_length | |||
) | icu::UnicodeString(TRUE, (const UChar *)L ## cs, _length) |
Unicode String literals in C++.
Dependent on the platform properties, different UnicodeString constructors should be used to create a UnicodeString object from a string literal. The macros are defined for maximum performance. They work only for strings that contain "invariant characters", i.e., only latin letters, digits, and some punctuation. See utypes.h for details.
The string parameter must be a C string literal. The length of the string, not including the terminating NUL
, must be specified as a constant. The U_STRING_DECL macro should be invoked exactly once for one such string variable before it is used.
#define UNICODE_STRING_SIMPLE | ( | cs | ) | UNICODE_STRING(cs, -1) |
Unicode String literals in C++.
Dependent on the platform properties, different UnicodeString constructors should be used to create a UnicodeString object from a string literal. The macros are defined for improved performance. They work only for strings that contain "invariant characters", i.e., only latin letters, digits, and some punctuation. See utypes.h for details.
The string parameter must be a C string literal.
#define UNISTR_FROM_CHAR_EXPLICIT |
This can be defined to be empty or "explicit".
If explicit, then the UnicodeString(UChar) and UnicodeString(UChar32) constructors are marked as explicit, preventing their inadvertent use.
#define UNISTR_FROM_STRING_EXPLICIT |
This can be defined to be empty or "explicit".
If explicit, then the UnicodeString(const char *) and UnicodeString(const UChar *) constructors are marked as explicit, preventing their inadvertent use.
In particular, this helps prevent accidentally depending on ICU conversion code by passing a string literal into an API with a const UnicodeString & parameter.
#define US_INV icu::UnicodeString::kInvariant |
Constant to be used in the UnicodeString(char *, int32_t, EInvariant) constructor which constructs a Unicode string from an invariant-character char * string.
About invariant characters see utypes.h. This constructor has no runtime dependency on conversion code and is therefore recommended over ones taking a charset name string (where the empty string "" indicates invariant-character conversion).