Windows 运行时中的文本由
Platform::String 类
以 C++/CX 表示。 当来回向 Windows 运行时类中的方法传递字符串或者跨越应用程序二进制接口 (ABI) 边界与其他 Windows 运行时组件交互时,请使用
Platform::String Class
。 虽然
Platform::String Class
为几种常见字符串操作提供方法,但它还不是全功能字符串类。 在您的 C++ 模块中,将标准 C++ 字符串类型(如
wstring
)用于任何大量的文本处理,然后将最终结果转换为
Platform::String^
,最后再向(或从)公共接口传递它。 在
wstring
或
wchar_t*
与
Platform::String
之间进行转换很容易也很有效。
在某些情况下,编译器可以验证它能否安全地构造
Platform::String
或将
String
传递到一个函数而无需复制基础字符串数据。 此类操作称为
快速传递
,它们以透明方式发生。
字符串构造
String
对象的值是
char16
(16 位 Unicode)字符的不可变(只读)序列。 由于
String
对象是不可变的,因此将新字符串文本分配给
String
变量其实就是用新的
String
对象替换原始
String
对象。 串联运算涉及析构原始
String
对象和创建新对象。
一个
文本字符
就是用单引号括起来的一个字符,一个
文本字符串
就是用双引号括起来的一个字符序列。 如果使用文本初始化 String^ 变量,则编译器假定文本由
char16
字符组成。 也就是说,在
_T()
或
TEXT()
宏中,不必在文本前加上字符串修饰符“L”或用引号将文本括起来。 有关 Unicode 的 C++ 支持的更多信息,请参见
Unicode Programming Summary
。
下面的示例演示用来构造
String
对象的各种方法。
// Initializing a String^ by using string literals
String^ str1 = "Test"; // ok for ANSI text only. uses current code page
String^ str2("Test");
String^ str3 = L"Test";
String^ str4(L"Test");
//Initialize a String^ by using another String^
String^ str6(str1);
auto str7 = str2;
// Initialize a String from wchar_t* and wstring
wchar_t msg[] = L"Test";
String^ str8 = ref new String(msg);
std::wstring wstr1(L"Test");
String^ str9 = ref new String(wstr1.c_str());
String^ str10 = ref new String(wstr1.c_str(), wstr1.length());
字符串处理操作
String
类为连接、比较字符串和其他基本字符串操作提供方法和运算符。 若要执行更广泛的字符串操作,请使用
String::Data()
成员函数来检索
String^
对象的值作为
const wchar_t*
。 然后使用该值初始化
std::wstring
,后者提供丰富的字符串处理函数。
// Concatenation
auto str1 = "Hello" + " World";
auto str2 = str1 + " from C++/CX!";
auto str3 = String::Concat(str2, " and the String class");
// Comparison
if (str1 == str2) { /* ... */ }
if (str1->Equals(str2)) { /* ... */ }
if (str1 != str2) { /* ... */ }
if (str1 < str2 || str1 > str2) { /* ... */};
int result = String::CompareOrdinal(str1, str2);
if(str1 == nullptr) { /* ...*/};
if(str1->IsEmpty()) { /* ...*/};
// Accessing individual characters in a String^
auto it = str1->Begin();
char16 ch = it[0];
字符串转换
Platform::String
中只能包含
char16
字符或
NULL
字符。 如果应用程序必须使用 8 位字符,请使用
String::Data
提取文本作为
const wchar_t*
。 然后,您可以使用适当的 Windows 函数或标准库函数对数据进行操作并将其转换回
wchar_t*
或
wstring
(用于构造新的
Platform::String
表示。
下面的代码片段演示
String^
变量和
wstring
变量间如何相互转换。 有关此示例中使用的字符串操作的更多信息,请参见
basic_string::replace
。
// Create a String^ variable statically or dynamically from a literal string.
String^ str1 = "AAAAAAAA";
// Use the value of str1 to create the ws1 wstring variable.
std::wstring ws1( str1->Data() );
// The value of ws1 is L"AAAAAAAA".
// Manipulate the wstring value.
std::wstring replacement( L"BBB" );
ws1 = ws1.replace ( 1, 3, replacement );
// The value of ws1 is L"ABBBAAAA".
// Assign the modified wstring back to str1.
str1 = ref new String( ws1.c_str() );
字符串长度和嵌入的 NULL 值
String::Length
返回字符串中的字符数目,而非字节数目。 当使用堆栈语义构造字符串时,一般不计算终止 NULL 字符,除非您明确指定。
Platform::String
可以包含嵌入的 NULL 值,但前提是 NULL 必须为串联运算的结果。 字符串文本中不支持嵌入的 NULL,因此,不能以这种方式使用嵌入的 NULL 初始化
Platform::String
。 在显示该字符串时(例如,将字符串分配给
Platform::String
属性时),将忽略
TextBlock::Text
中嵌入的 NULL 值。 当字符串值由
Data
属性返回时,将删除嵌入的 NULL。
StringReference
有时,代码 (a) 接收 std::wstring、wchar_t 字符串或 L"" 字符串文本,并直接将其传递到采用 String^ 作为输入参数的另一个方法。 只要原始字符串缓冲区本身在函数返回之前保持有效且不发生变化,则可以将
wchar_t*
字符串或字符串文本转换为
Platform::StringReference
,然后将其代替
Platform::String^
传入。 之所以允许这样做,是因为
StringReference
具有用户定义的到
Platform::String^
的转换。 通过使用
StringReference
,可避免创建字符串数据的额外副本。 在传递大量字符串的循环中或传递非常大的字符串时,可通过使用
StringReference
显著提高潜在性能。 但是,由于
StringReference
实质上是借用原始字符串缓冲区,因此必须格外小心,以免损坏内存。 不应将
StringReference
传递给异步方法,除非可以保证原始字符串在该方法返回时处于范围之内。 如果发生第二个记录分配操作,从 StringReference 初始化的 String^ 将强制分配和复制字符串数据。 在此情况下,
StringReference
的性能优势将丧失。
请注意,
StringReference
是标准的 C++ 类类型,而非 ref 类,不能用于您定义的 ref 类的公共接口。
下面的示例演示如何使用 StringReference:
void GetDecodedStrings(std::vector<std::wstring> strings)
using namespace Windows::Security::Cryptography;
using namespace Windows::Storage::Streams;
for (auto&& s : strings)
// Method signature is IBuffer^ CryptographicBuffer::DecodeFromBase64String (Platform::String^)
// Call using StringReference:
IBuffer^ buffer = CryptographicBuffer::DecodeFromBase64String(StringReference(s.c_str()));
//...do something with buffer