Cadenas (C++/CX)

El texto de Windows Runtime se representa en C++/CX mediante la clase Platform::String. Utiliza Platform::String Class cuando intercambies cadenas en los métodos de las clases de Windows Runtime, o cuando estés interactuando con otros componentes de Windows Runtime a través del límite de la interfaz binaria de aplicación (ABI). La clase Platform::String Class proporciona métodos para varias operaciones de cadena comunes, pero no está diseñada para ser una clase de cadena completa. En el módulo de C++, utiliza los tipos de cadena de C++ estándar tales como wstring para cualquier procesamiento de texto significativo y, a continuación, convierte el resultado final a Platform::String^ antes de pasarlo a o desde una interfaz pública. La conversión entre wstring o wchar_t* y Platform::Stringes un proceso sencillo y eficaz.

Operación rápida de paso

En algunos casos, el compilador puede comprobar que puede crear con seguridad un objeto Platform::String o pasar un objeto String a una función sin copiar los datos de cadena subyacentes. Dichas operaciones se conocen como operaciones rápidas de paso y se producen de forma transparente.

Construcción de cadena

El valor de un objeto String es una secuencia inmutable (de solo lectura) de caracteres char16 (Unicode de 16 bits). Dado que un objeto String es inmutable, la asignación de un nuevo literal de cadena a una variable String reemplaza realmente el objeto String original con un nuevo objeto String . Las operaciones de concatenación implican la destrucción del objeto String original y la creación de un nuevo objeto.

Literales

Un carácter literal es un carácter que se encierra entre comillas simples y una cadena literal es una secuencia de caracteres que se encierra entre comillas dobles. Si utilizas un literal para inicializar una variable String^, el compilador supone que el literal consta de caracteres char16 . Es decir, no hay que colocar delante del literal el modificador de cadena 'L' ni incluir el literal en una macro _T() o TEXT() . Para obtener más información sobre la compatibilidad de C++ para Unicode, consulta Unicode Programming Summary.

En el ejemplo siguiente se muestran varias maneras de crear objetos 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());

Operaciones de control de cadenas

La clase String proporciona métodos y operadores para concatenar, comparar cadenas y otras operaciones de cadena básicas. Para realizar manipulaciones de cadena más extensas, utilice la función miembro String::Data() para recuperar el valor del objeto String^ como un objeto const wchar_t*. A continuación, use ese valor para inicializar un objeto std::wstring, que proporcionan funciones mejoradas de control de cadenas.

 // 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];

Conversiones de cadenas

Un objeto Platform::String solo puede contener caracteres char16 o el carácter NULL . Si la aplicación tiene que trabajar con caracteres de 8 bits, use el método String::Data para extraer el texto como un const wchar_t*. Puedes utilizar las funciones de Windows o las funciones de biblioteca estándar adecuadas para funcionar en los datos y convertirlos de nuevo en un objeto wchar_t* o wstring, que puedes utilizar para crear un nuevo objeto Platform::String.

En el fragmento de código siguiente se muestra cómo convertir una variable String^ a y desde una variable wstring . Para obtener más información acerca de la manipulación de cadenas que se utiliza en este ejemplo, consulta 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() ); 

Longitud de cadena y valores NULL incrustados

String::Length devuelve el número de caracteres de la cadena, no el número de bytes. El carácter NULL de terminación no se cuenta, a menos que lo especifiques explícitamente cuando utilices semántica de pila para crear una cadena.

Un objeto Platform::String puede contener valores NULL incrustados, pero solo cuando el valor NULL es el resultado de una operación de concatenación. Los valores NULL incrustados no se admiten en los literales de cadena; por consiguiente, no puedes utilizar valores NULL incrustados de esa manera para inicializar un objeto Platform::String. Los valores NULL incrustados en un objeto Platform::String se omiten cuando la cadena se muestra, por ejemplo, cuando se asigna a una propiedad TextBlock::Text . Los valores NULL incrustados se quitan cuando la propiedad Data devuelve el valor de cadena.

StringReference

En algunos casos, el código (a) recibe un objeto std::wstring, una cadena wchar_t o un literal de cadena L"" y lo pasa a otro método que toma una variable String^ como parámetro de entrada. Siempre que el propio búfer de cadena original siga siendo válido y no se modifique antes de que la función devuelva un valor, puedes convertir la cadena o literal de cadena wchar_t* a Platform::StringReference, y pasar esta en lugar de Platform::String^. Esto es posible debido a que StringReference tiene una conversión definida por el usuario a Platform::String^. Puedes utilizar StringReference para evitar realizar una copia adicional de la cadena de datos. En los bucles en los que pases un gran número de cadenas, o si pasas cadenas de gran tamaño, puedes lograr una mejora significativa en el rendimiento si utilizas StringReference. Sin embargo, dado que StringReference básicamente toma prestado el búfer de cadena original, debes extremar las precauciones para evitar daños en la memoria. No debes pasar un objeto StringReference a un método asincrónico a menos que estés seguro de que la cadena original estará en el ámbito cuando dicho método devuelva un valor. Un objeto String^ que se inicializa desde una clase StringReference forzará la asignación y la copia de los datos de cadena si se produce una segunda operación de asignación. En este caso, se perderá la ventaja de rendimiento de StringReference.

Ten en cuenta que StringReference es un tipo de clase de C++ estándar, no una clase ref, y que no puedes utilizarlo en la interfaz pública de las clases ref que definas.

En el ejemplo siguiente se muestra cómo utilizar 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
    }
}