Como: converter entre diversos tipos de cadeia de caracteres

Artigo
04/03/2023

Este artigo mostra como converter diversos tipos de cadeia de caracteres do Visual C++ em outras cadeias de caracteres.

Os tipos de cadeia de caracteres abordados incluem char *, wchar_t*, _bstr_t, CComBSTR, CString, basic_string e System.String.

Em todos os casos, uma cópia da cadeia de caracteres é feita quando ela é convertida no novo tipo. As alterações feitas na nova cadeia de caracteres não afetarão a cadeia de caracteres original e vice-versa.

Para obter mais informações gerais sobre como converter cadeias de caracteres estreitas e largas, consulte Converter entre cadeias de caracteres estreitas e largas.

Executar os exemplos

Para executar os exemplos no Visual Studio 2022, você pode criar um novo aplicativo de console do Windows C++. Ou, se você tiver instalado o suporte a C++/CLI, poderá criar um aplicativo de console CLR (.NET Framework).

Se criar um Aplicativo de Console CLR, você não precisará fazer as alterações a seguir nas configurações do compilador e do depurador. No entanto, você precisará adicionar #include "pch.h" à parte superior de cada exemplo.

De qualquer forma, adicione comsuppw.lib a Propriedades do Projeto>Vinculador>Entrada>Dependências Adicionais.

Se você criar um aplicativo de Console do Windows C++ para executar os exemplos, faça as seguintes alterações no projeto:

Adicione os argumentos de linha de comando /clr e /Zc:twoPhase- a Propriedades do Projeto>C++>Linha de Comando>Opções Adicionais.

A opção /clr entra em conflito com algumas opções do compilador definidas quando você cria um projeto de Aplicativo de Console do Windows C++. Os seguintes links fornecem instruções sobre onde no IDE você pode desativar as opções conflitantes:

Desativar /RTC1 (Definir verificações básicas de tempo de execução como padrão): Propriedades>do projeto C/C++>Geração>de código Verificações>básicas de tempo de execução padrão
Desativar /EHs (modelo de tratamento de exceções): Propriedades>do projeto Geração>de código C/C++ Habilitar exceções>C++ Não>
Exchange (formato de informações de depuração) para/Z7: Propriedades>do projeto C/C++>Formato de informações de depuração geral>Compatível>com C7/Zi
Desativar /JMC (Apenas a depuração do meu código): Propriedades>do projeto Suporte geral C/C++>: Apenas minha depuração>de código:> Não
Definir o tipo de depurador como misto: Propriedades do Projeto>Depuração>Tipo de Depurador>Misto (.NET Framework)
Ativar/ASSEMBLYDEBUG: Propriedades>do projeto Depuração>do vinculador>Assembly>depurável Sim (ASSEMBLYDEBUG)

Exemplo: converter de `char *`

Descrição

Este exemplo demonstra como converter de um char * nos tipos de cadeia de caracteres listados acima. Uma cadeia de caracteres char * (também conhecida como cadeia de caracteres no estilo C) usa uma terminação em nulo para indicar o fim da cadeia de caracteres. As cadeias de caracteres no estilo C geralmente exigem 1 byte por caractere, mas também podem usar 2 bytes. Nos exemplos abaixo, as cadeias de caracteres char * às vezes são chamadas de cadeias de caracteres multibyte devido aos dados de cadeia de caracteres resultantes da conversão de cadeias de caracteres Unicode largas. Funções de caracteres de byte único e multibyte (MBCS) podem operar em cadeias de caracteres char *.

Para obter informações sobre como executar e depurar este exemplo, consulte Executar os exemplos.

Código

// convert_from_char.cpp
// compile with: /clr /Zc:twoPhase- /link comsuppw.lib

#include <iostream>
#include <stdlib.h>
#include <string>

#include "atlbase.h"
#include "atlstr.h"
#include "comutil.h"

using namespace std;
using namespace System;

int main()
{
    // Create and display a C-style string, and then use it
    // to create different kinds of strings.
    const char* orig = "Hello, World!";
    cout << orig << " (char *)" << endl;

    // newsize describes the length of the
    // wchar_t string called wcstring in terms of the number
    // of wide characters, not the number of bytes.
    size_t newsize = strlen(orig) + 1;

    // The following creates a buffer large enough to contain
    // the exact number of characters in the original string
    // in the new format. If you want to add more characters
    // to the end of the string, increase the value of newsize
    // to increase the size of the buffer.
    wchar_t* wcstring = new wchar_t[newsize];

    // Convert char* string to a wchar_t* string.
    size_t convertedChars = 0;
    mbstowcs_s(&convertedChars, wcstring, newsize, orig, _TRUNCATE);
    // Display the result and indicate the type of string that it is.
    wcout << wcstring << L" (wchar_t *)" << endl;
    delete []wcstring;

    // Convert the C-style string to a _bstr_t string.
    _bstr_t bstrt(orig);
    // Append the type of string to the new string
    // and then display the result.
    bstrt += " (_bstr_t)";
    cout << bstrt << endl;

    // Convert the C-style string to a CComBSTR string.
    CComBSTR ccombstr(orig);
    if (ccombstr.Append(L" (CComBSTR)") == S_OK)
    {
        CW2A printstr(ccombstr);
        cout << printstr << endl;
    }

    // Convert the C-style string to a CStringA and display it.
    CStringA cstringa(orig);
    cstringa += " (CStringA)";
    cout << cstringa << endl;

    // Convert the C-style string to a CStringW and display it.
    CStringW cstring(orig);
    cstring += " (CStringW)";
    // To display a CStringW correctly, use wcout and cast cstring
    // to (LPCTSTR).
    wcout << (LPCTSTR)cstring << endl;

    // Convert the C-style string to a basic_string and display it.
    string basicstring(orig);
    basicstring += " (basic_string)";
    cout << basicstring << endl;

    // Convert the C-style string to a System::String and display it.
    String^ systemstring = gcnew String(orig);
    systemstring += " (System::String)";
    Console::WriteLine("{0}", systemstring);
    delete systemstring;
}

Hello, World! (char *)
Hello, World! (wchar_t *)
Hello, World! (_bstr_t)
Hello, World! (CComBSTR)
Hello, World! (CStringA)
Hello, World! (CStringW)
Hello, World! (basic_string)
Hello, World! (System::String)

Exemplo: converter de `wchar_t *`

Descrição

Este exemplo demonstra como converter de um wchar_t * em outros tipos de cadeia de caracteres. Vários tipos de cadeia de caracteres, incluindo wchar_t *, implementam formatos de caractere largo. Para converter uma cadeia de caracteres entre um formato multibyte e um caractere largo, você pode usar uma chamada de função, como mbstowcs_s, ou uma invocação de construtor para uma classe, como CStringA.

Para obter informações sobre como executar e depurar este exemplo, consulte Executar os exemplos.

Código

// convert_from_wchar_t.cpp
// compile with: /clr /Zc:twoPhase- /link comsuppw.lib

#include <iostream>
#include <stdlib.h>
#include <string>

#include "atlbase.h"
#include "atlstr.h"
#include "comutil.h"

using namespace std;
using namespace System;

int main()
{
    // Create a string of wide characters, display it, and then
    // use this string to create other types of strings.
    const wchar_t* orig = L"Hello, World!";
    wcout << orig << L" (wchar_t *)" << endl;

    // Convert the wchar_t string to a char* string. Record
    // the length of the original string and add 1 to it to
    // account for the terminating null character.
    size_t origsize = wcslen(orig) + 1;
    size_t convertedChars = 0;

    // Use a multibyte string to append the type of string
    // to the new string before displaying the result.
    char strConcat[] = " (char *)";
    size_t strConcatsize = (strlen(strConcat) + 1) * 2;

    // Allocate two bytes in the multibyte output string for every wide
    // character in the input string (including a wide character
    // null). Because a multibyte character can be one or two bytes,
    // you should allot two bytes for each character. Having extra
    // space for the new string isn't an error, but having
    // insufficient space is a potential security problem.
    const size_t newsize = origsize * 2;
    // The new string will contain a converted copy of the original
    // string plus the type of string appended to it.
    char* nstring = new char[newsize + strConcatsize];

    // Put a copy of the converted string into nstring
    wcstombs_s(&convertedChars, nstring, newsize, orig, _TRUNCATE);
    // append the type of string to the new string.
    _mbscat_s((unsigned char*)nstring, newsize + strConcatsize, (unsigned char*)strConcat);
    // Display the result.
    cout << nstring << endl;
    delete []nstring;

    // Convert a wchar_t to a _bstr_t string and display it.
    _bstr_t bstrt(orig);
    bstrt += " (_bstr_t)";
    cout << bstrt << endl;

    // Convert the wchar_t string to a BSTR wide character string
    // by using the ATL CComBSTR wrapper class for BSTR strings.
    // Then display the result.

    CComBSTR ccombstr(orig);
    if (ccombstr.Append(L" (CComBSTR)") == S_OK)
    {
        // CW2A converts the string in ccombstr to a multibyte
        // string in printstr, used here for display output.
        CW2A printstr(ccombstr);
        cout << printstr << endl;
        // The following line of code is an easier way to
        // display wide character strings:
        wcout << (LPCTSTR)ccombstr << endl;
    }

    // Convert a wide wchar_t string to a multibyte CStringA,
    // append the type of string to it, and display the result.
    CStringA cstringa(orig);
    cstringa += " (CStringA)";
    cout << cstringa << endl;

    // Convert a wide character wchar_t string to a wide
    // character CStringW string and append the type of string to it
    CStringW cstring(orig);
    cstring += " (CStringW)";
    // To display a CStringW correctly, use wcout and cast cstring
    // to (LPCTSTR).
    wcout << (LPCTSTR)cstring << endl;

    // Convert the wide character wchar_t string to a
    // basic_string, append the type of string to it, and
    // display the result.
    wstring basicstring(orig);
    basicstring += L" (basic_string)";
    wcout << basicstring << endl;

    // Convert a wide character wchar_t string to a
    // System::String string, append the type of string to it,
    // and display the result.
    String^ systemstring = gcnew String(orig);
    systemstring += " (System::String)";
    Console::WriteLine("{0}", systemstring);
    delete systemstring;
}

Hello, World! (wchar_t *)
Hello, World! (char *)
Hello, World! (_bstr_t)
Hello, World! (CComBSTR)
Hello, World! (CStringA)
Hello, World! (CStringW)
Hello, World! (basic_string)
Hello, World! (System::String)

Exemplo: converter de `_bstr_t`

Descrição

Este exemplo demonstra como converter de um _bstr_t em outros tipos de cadeia de caracteres. O objeto _bstr_t encapsula cadeias de caracteres largos BSTR. Uma cadeia de caracteres BSTR tem um valor de comprimento e não usa um caractere nulo para encerrar a cadeia de caracteres, mas o tipo de cadeia de caracteres para o qual você converte pode exigir um caractere nulo de terminação.

Para obter informações sobre como executar e depurar este exemplo, consulte Executar os exemplos.

Código

// convert_from_bstr_t.cpp
// compile with: /clr /Zc:twoPhase- /link comsuppw.lib

#include <iostream>
#include <stdlib.h>
#include <string>

#include "atlbase.h"
#include "atlstr.h"
#include "comutil.h"

using namespace std;
using namespace System;

int main()
{
    // Create a _bstr_t string, display the result, and indicate the
    // type of string that it is.
    _bstr_t orig("Hello, World!");
    wcout << orig << " (_bstr_t)" << endl;

    // Convert the wide character _bstr_t string to a C-style
    // string. To be safe, allocate two bytes for each character
    // in the char* string, including the terminating null.
    const size_t newsize = (orig.length() + 1) * 2;
    char* nstring = new char[newsize];

    // Uses the _bstr_t operator (char *) to obtain a null
    // terminated string from the _bstr_t object for
    // nstring.
    strcpy_s(nstring, newsize, (char*)orig);
    strcat_s(nstring, newsize, " (char *)");
    cout << nstring << endl;
    delete []nstring;

    // Prepare the type of string to append to the result.
    wchar_t strConcat[] = L" (wchar_t *)";
    size_t strConcatLen = wcslen(strConcat) + 1;

    // Convert a _bstr_t to a wchar_t* string.
    const size_t widesize = orig.length() + strConcatLen;
    wchar_t* wcstring = new wchar_t[newsize];
    wcscpy_s(wcstring, widesize, (wchar_t*)orig);
    wcscat_s(wcstring, widesize, strConcat);
    wcout << wcstring << endl;
    delete []wcstring;

    // Convert a _bstr_t string to a CComBSTR string.
    CComBSTR ccombstr((char*)orig);
    if (ccombstr.Append(L" (CComBSTR)") == S_OK)
    {
        CW2A printstr(ccombstr);
        cout << printstr << endl;
    }

    // Convert a _bstr_t to a CStringA string.
    CStringA cstringa(orig.GetBSTR());
    cstringa += " (CStringA)";
    cout << cstringa << endl;

    // Convert a _bstr_t to a CStringW string.
    CStringW cstring(orig.GetBSTR());
    cstring += " (CStringW)";
    // To display a cstring correctly, use wcout and
    // "cast" the cstring to (LPCTSTR).
    wcout << (LPCTSTR)cstring << endl;

    // Convert the _bstr_t to a basic_string.
    string basicstring((char*)orig);
    basicstring += " (basic_string)";
    cout << basicstring << endl;

    // Convert the _bstr_t to a System::String.
    String^ systemstring = gcnew String((char*)orig);
    systemstring += " (System::String)";
    Console::WriteLine("{0}", systemstring);
    delete systemstring;
}

Hello, World! (_bstr_t)
Hello, World! (char *)
Hello, World! (wchar_t *)
Hello, World! (CComBSTR)
Hello, World! (CStringA)
Hello, World! (CStringW)
Hello, World! (basic_string)
Hello, World! (System::String)

Exemplo: converter de `CComBSTR`

Descrição

Este exemplo demonstra como converter de um CComBSTR em outros tipos de cadeia de caracteres. Assim como _bstr_t, o objeto CComBSTR encapsula cadeias de caracteres largos BSTR. Uma cadeia de caracteres BSTR tem um valor de comprimento e não usa um caractere nulo para encerrar a cadeia de caracteres, mas o tipo de cadeia de caracteres para o qual você converte pode exigir um nulo de terminação.

Para obter informações sobre como executar e depurar este exemplo, consulte Executar os exemplos.

Código

// convert_from_ccombstr.cpp
// compile with: /clr /Zc:twoPhase- /link comsuppw.lib

#include <iostream>
#include <stdlib.h>
#include <string>

#include "atlbase.h"
#include "atlstr.h"
#include "comutil.h"
#include "vcclr.h"

using namespace std;
using namespace System;
using namespace System::Runtime::InteropServices;

int main()
{
    // Create and initialize a BSTR string by using a CComBSTR object.
    CComBSTR orig("Hello, World!");
    // Convert the BSTR into a multibyte string, display the result,
    // and indicate the type of string that it is.
    CW2A printstr(orig);
    cout << printstr << " (CComBSTR)" << endl;

    // Convert a wide character CComBSTR string to a
    // regular multibyte char* string. Allocate enough space
    // in the new string for the largest possible result,
    // including space for a terminating null.
    const size_t newsize = (orig.Length() + 1) * 2;
    char* nstring = new char[newsize];

    // Create a string conversion object, copy the result to
    // the new char* string, and display the result.
    CW2A tmpstr1(orig);
    strcpy_s(nstring, newsize, tmpstr1);
    cout << nstring << " (char *)" << endl;
    delete []nstring;

    // Prepare the type of string to append to the result.
    wchar_t strConcat[] = L" (wchar_t *)";
    size_t strConcatLen = wcslen(strConcat) + 1;

    // Convert a wide character CComBSTR string to a wchar_t*.
    // The code first determines the length of the converted string
    // plus the length of the appended type of string, then
    // prepares the final wchar_t string for display.
    const size_t widesize = orig.Length() + strConcatLen;
    wchar_t* wcstring = new wchar_t[widesize];
    wcscpy_s(wcstring, widesize, orig);
    wcscat_s(wcstring, widesize, strConcat);

    // Display the result. Unlike CStringW, a wchar_t doesn't need
    // a cast to (LPCTSTR) with wcout.
    wcout << wcstring << endl;
    delete []wcstring;

    // Convert a wide character CComBSTR to a wide character _bstr_t,
    // append the type of string to it, and display the result.
    _bstr_t bstrt(orig);
    bstrt += " (_bstr_t)";
    cout << bstrt << endl;

    // Convert a wide character CComBSTR to a multibyte CStringA,
    // append the type of string to it, and display the result.
    CStringA cstringa(orig);
    cstringa += " (CStringA)";
    cout << cstringa << endl;

    // Convert a wide character CComBSTR to a wide character CStringW.
    CStringW cstring(orig);
    cstring += " (CStringW)";
    // To display a cstring correctly, use wcout and cast cstring
    // to (LPCTSTR).
    wcout << (LPCTSTR)cstring << endl;

    // Convert a wide character CComBSTR to a wide character
    // basic_string.
    wstring basicstring(orig);
    basicstring += L" (basic_string)";
    wcout << basicstring << endl;

    // Convert a wide character CComBSTR to a System::String.
    String^ systemstring = gcnew String(orig);
    systemstring += " (System::String)";
    Console::WriteLine("{0}", systemstring);
    delete systemstring;
}

Hello, World! (CComBSTR)
Hello, World! (char *)
Hello, World! (wchar_t *)
Hello, World! (_bstr_t)
Hello, World! (CStringA)
Hello, World! (CStringW)
Hello, World! (basic_string)
Hello, World! (System::String)

Exemplo: converter de `CString`

Descrição

Este exemplo demonstra como converter de um CString em outros tipos de cadeia de caracteres. CString é baseado no tipo de dados TCHAR, que, por sua vez, depende da definição do símbolo _UNICODE. Se _UNICODE não estiver definido, TCHAR será definido como char e CString conterá uma cadeia de caracteres multibyte. Se _UNICODE estiver definido, TCHAR será definida como wchar_t e CString conterá uma cadeia de caracteres largos.

CStringA contém o tipo char e dá suporte a cadeias de caracteres de byte único ou multibyte. CStringW é a versão de caractere largo. CStringA e CStringW não usam _UNICODE para determinar como devem ser compilados. CStringA e CStringW são usados neste exemplo para esclarecer pequenas diferenças na alocação do tamanho do buffer e no tratamento de saída.

Para obter informações sobre como executar e depurar este exemplo, consulte Executar os exemplos.

Código

// convert_from_cstring.cpp
// compile with: /clr /Zc:twoPhase- /link comsuppw.lib

#include <iostream>
#include <stdlib.h>
#include <string>

#include "atlbase.h"
#include "atlstr.h"
#include "comutil.h"

using namespace std;
using namespace System;

int main()
{
    // Set up a multibyte CStringA string.
    CStringA origa("Hello, World!");
    cout << origa << " (CStringA)" << endl;

    // Set up a wide character CStringW string.
    CStringW origw("Hello, World!");
    wcout << (LPCTSTR)origw << L" (CStringW)" << endl;

    // Convert to a char* string from CStringA string
    // and display the result.
    const size_t newsizea = origa.GetLength() + 1;
    char* nstringa = new char[newsizea];
    strcpy_s(nstringa, newsizea, origa);
    cout << nstringa << " (char *)" << endl;
    delete []nstringa;

    // Convert to a char* string from a wide character
    // CStringW string. To be safe, we allocate two bytes for each
    // character in the original string, including the terminating
    // null.
    const size_t newsizew = (origw.GetLength() + 1) * 2;
    char* nstringw = new char[newsizew];
    size_t convertedCharsw = 0;
    wcstombs_s(&convertedCharsw, nstringw, newsizew, origw, _TRUNCATE);
    cout << nstringw << " (char *)" << endl;
    delete []nstringw;

    // Convert to a wchar_t* from CStringA
    size_t convertedCharsa = 0;
    wchar_t* wcstring = new wchar_t[newsizea];
    mbstowcs_s(&convertedCharsa, wcstring, newsizea, origa, _TRUNCATE);
    wcout << wcstring << L" (wchar_t *)" << endl;
    delete []wcstring;

    // Convert to a wide character wchar_t* string from
    // a wide character CStringW string.
    wchar_t* n2stringw = new wchar_t[newsizew];
    wcscpy_s(n2stringw, newsizew, origw);
    wcout << n2stringw << L" (wchar_t *)" << endl;
    delete []n2stringw;

    // Convert to a wide character _bstr_t string from
    // a multibyte CStringA string.
    _bstr_t bstrt(origa);
    bstrt += L" (_bstr_t)";
    wcout << bstrt << endl;

    // Convert to a wide character _bstr_t string from
    // a wide character CStringW string.
    bstr_t bstrtw(origw);
    bstrtw += " (_bstr_t)";
    wcout << bstrtw << endl;

    // Convert to a wide character CComBSTR string from
    // a multibyte character CStringA string.
    CComBSTR ccombstr(origa);
    if (ccombstr.Append(L" (CComBSTR)") == S_OK)
    {
        // Convert the wide character string to multibyte
        // for printing.
        CW2A printstr(ccombstr);
        cout << printstr << endl;
    }

    // Convert to a wide character CComBSTR string from
    // a wide character CStringW string.
    CComBSTR ccombstrw(origw);

    // Append the type of string to it, and display the result.
    if (ccombstrw.Append(L" (CComBSTR)") == S_OK)
    {
        CW2A printstrw(ccombstrw);
        wcout << printstrw << endl;
    }

    // Convert a multibyte character CStringA to a
    // multibyte version of a basic_string string.
    string basicstring(origa);
    basicstring += " (basic_string)";
    cout << basicstring << endl;

    // Convert a wide character CStringW to a
    // wide character version of a basic_string
    // string.
    wstring basicstringw(origw);
    basicstringw += L" (basic_string)";
    wcout << basicstringw << endl;

    // Convert a multibyte character CStringA to a
    // System::String.
    String^ systemstring = gcnew String(origa);
    systemstring += " (System::String)";
    Console::WriteLine("{0}", systemstring);
    delete systemstring;

    // Convert a wide character CStringW to a
    // System::String.
    String^ systemstringw = gcnew String(origw);
    systemstringw += " (System::String)";
    Console::WriteLine("{0}", systemstringw);
    delete systemstringw;
}

Hello, World! (CStringA)
Hello, World! (CStringW)
Hello, World! (char *)
Hello, World! (char *)
Hello, World! (wchar_t *)
Hello, World! (wchar_t *)
Hello, World! (_bstr_t)
Hello, World! (_bstr_t)
Hello, World! (CComBSTR)
Hello, World! (CComBSTR)
Hello, World! (basic_string)
Hello, World! (System::String)

Exemplo: converter de `basic_string`

Descrição

Este exemplo demonstra como converter de um basic_string em outros tipos de cadeia de caracteres.

Para obter informações sobre como executar e depurar este exemplo, consulte Executar os exemplos.

Código

// convert_from_basic_string.cpp
// compile with: /clr /Zc:twoPhase- /link comsuppw.lib

#include <iostream>
#include <stdlib.h>
#include <string>

#include "atlbase.h"
#include "atlstr.h"
#include "comutil.h"

using namespace std;
using namespace System;

int main()
{
    // Set up a basic_string string.
    string orig("Hello, World!");
    cout << orig << " (basic_string)" << endl;

    // Convert a wide character basic_string string to a multibyte char*
    // string. To be safe, we allocate two bytes for each character
    // in the original string, including the terminating null.
    const size_t newsize = (orig.size() + 1) * 2;

    char* nstring = new char[newsize];
    strcpy_s(nstring, newsize, orig.c_str());
    cout << nstring << " (char *)" << endl;
    delete []nstring;

    // Convert a basic_string string to a wide character
    // wchar_t* string. You must first convert to a char*
    // for this to work.
    const size_t newsizew = orig.size() + 1;
    size_t convertedChars = 0;
    wchar_t* wcstring = new wchar_t[newsizew];
    mbstowcs_s(&convertedChars, wcstring, newsizew, orig.c_str(), _TRUNCATE);
    wcout << wcstring << L" (wchar_t *)" << endl;
    delete []wcstring;

    // Convert a basic_string string to a wide character
    // _bstr_t string.
    _bstr_t bstrt(orig.c_str());
    bstrt += L" (_bstr_t)";
    wcout << bstrt << endl;

    // Convert a basic_string string to a wide character
    // CComBSTR string.
    CComBSTR ccombstr(orig.c_str());
    if (ccombstr.Append(L" (CComBSTR)") == S_OK)
    {
        // Make a multibyte version of the CComBSTR string
        // and display the result.
        CW2A printstr(ccombstr);
        cout << printstr << endl;
    }

    // Convert a basic_string string into a multibyte
    // CStringA string.
    CStringA cstring(orig.c_str());
    cstring += " (CStringA)";
    cout << cstring << endl;

    // Convert a basic_string string into a wide
    // character CStringW string.
    CStringW cstringw(orig.c_str());
    cstringw += L" (CStringW)";
    wcout << (LPCTSTR)cstringw << endl;

    // Convert a basic_string string to a System::String
    String^ systemstring = gcnew String(orig.c_str());
    systemstring += " (System::String)";
    Console::WriteLine("{0}", systemstring);
    delete systemstring;
}

Hello, World! (basic_string)
Hello, World! (char *)
Hello, World! (wchar_t *)
Hello, World! (_bstr_t)
Hello, World! (CComBSTR)
Hello, World! (CStringA)
Hello, World! (CStringW)
Hello, World! (System::String)

Exemplo: converter de `System::String`

Descrição

Este exemplo demonstra como converter de um caractere largo System::String em outros tipos de cadeia de caracteres.

Para obter informações sobre como executar e depurar este exemplo, consulte Executar os exemplos.

Código

// convert_from_system_string.cpp
// compile with: /clr /Zc:twoPhase- /link comsuppw.lib

#include <iostream>
#include <stdlib.h>
#include <string>

#include "atlbase.h"
#include "atlstr.h"
#include "comutil.h"
#include "vcclr.h"

using namespace std;
using namespace System;
using namespace System::Runtime::InteropServices;

int main()
{
    // Set up a System::String and display the result.
    String^ orig = gcnew String("Hello, World!");
    Console::WriteLine("{0} (System::String)", orig);

    // Obtain a pointer to the System::String in order to
    // first lock memory into place, so that the
    // Garbage Collector (GC) cannot move that object
    // while we call native functions.
    pin_ptr<const wchar_t> wch = PtrToStringChars(orig);

    // Make a copy of the System::String as a multibyte
    // char* string. Allocate two bytes in the multibyte
    // output string for every wide character in the input
    // string, including space for a terminating null.
    size_t origsize = wcslen(wch) + 1;
    const size_t newsize = origsize * 2;
    size_t convertedChars = 0;
    char* nstring = new char[newsize];
    wcstombs_s(&convertedChars, nstring, newsize, wch, _TRUNCATE);
    cout << nstring << " (char *)" << endl;
    delete []nstring;

    // Convert a wide character System::String to a
    // wide character wchar_t* string.
    const size_t newsizew = origsize;
    wchar_t* wcstring = new wchar_t[newsizew];
    wcscpy_s(wcstring, newsizew, wch);
    wcout << wcstring << L" (wchar_t *)" << endl;
    delete []wcstring;

    // Convert a wide character System::String to a
    // wide character _bstr_t string.
    _bstr_t bstrt(wch);
    bstrt += " (_bstr_t)";
    cout << bstrt << endl;

    // Convert a wide character System::String
    // to a wide character CComBSTR string.
    CComBSTR ccombstr(wch);
    if (ccombstr.Append(L" (CComBSTR)") == S_OK)
    {
        // Make a multibyte copy of the CComBSTR string
        // and display the result.
        CW2A printstr(ccombstr);
        cout << printstr << endl;
    }

    // Convert a wide character System::String to
    // a multibyte CStringA string.
    CStringA cstring(wch);
    cstring += " (CStringA)";
    cout << cstring << endl;

    // Convert a wide character System::String to
    // a wide character CStringW string.
    CStringW cstringw(wch);
    cstringw += " (CStringW)";
    wcout << (LPCTSTR)cstringw << endl;

    // Convert a wide character System::String to
    // a wide character basic_string.
    wstring basicstring(wch);
    basicstring += L" (basic_string)";
    wcout << basicstring << endl;

    delete orig;
}

Hello, World! (System::String)
Hello, World! (char *)
Hello, World! (wchar_t *)
Hello, World! (_bstr_t)
Hello, World! (CComBSTR)
Hello, World! (CStringA)
Hello, World! (CStringW)
Hello, World! (basic_string)

Convertendo entre cadeias de caracteres estreitos e largos

Os aplicativos herdados do C e do Windows usam páginas de código em vez de codificações Unicode ao manipular cadeias de caracteres estreitas e cadeias de caracteres largas.

As cadeias de caracteres .NET são UTF-16, mas a CStringA da ATL é uma cadeia de caracteres estreita, e a conversão de larga para estreita é executada pela função do Win32 WideCharToMultiByte. Ao converter um CHAR* de estilo C (um CHAR* de estilo C é um byte* .NET) em uma cadeia de caracteres, a função Win32 oposta, MultiByteToWideChar, é chamada.

Ambas as funções dependem do conceito do Windows de uma página de código, e não do conceito do .NET de uma cultura. Para alterar a página de código do sistema, use a configuração de região acessando o Painel de Controle> e inserindo Region na caixa de pesquisa >Região (alterar formatos de data, hora ou número)>Administrativo>Alterar localidade do sistema.

Em uma versão no idioma en-US do Windows, a página de código é 1033 como padrão. Se você instalar um idioma diferente do Windows, ele terá uma página de código diferente. Você pode alterá-la usando o painel de controle.

Há uma incompatibilidade entre a maneira como CStringA executa uma conversão de largo para estreito e a maneira como gcnew string(CHAR*) executa uma conversão de estreito para largo. CStringA passa CP_THREAD_ACP, o que significa que a página de código do thread atual deve ser usada, para o método de conversão de restrição. Mas string.ctor(sbyte*) passa CP_ACP, que significa que a página de código do sistema atual deve ser usada, para o método de conversão de expansão. Se as páginas de código do sistema e do thread não corresponderem, isso poderá causar corrupção dos dados de ida e volta.

Para reconciliar essa diferença, use a constante _CONVERSION_DONT_USE_THREAD_LOCALE para fazer com que a conversão use CP_ACP (como .NET) em vez de CP_THREAD_ACP. Para obter mais informações, consulte _CONVERSION_DONT_USE_THREAD_LOCALE.

Outra abordagem é usar pinvoke para chamar GetThreadLocale. Use o LCID retornado para criar um CultureInfo. Em seguida, use CultureInfo.TextInfo para obter a página de código a ser usada na conversão.

Confira também

Macros de conversão de cadeia de caracteres ATL e MFC
Operações CString relacionadas a cadeia de caracteres de estilo C
Como converter String padrão em System::String
Como converter System::String em String padrão
Como converter System::String em wchar_t* ou char*
Programação com CComBSTR
mbstowcs_s, _mbstowcs_s_l
wcstombs_s, _wcstombs_s_l
strcpy_s, wcscpy_s, _mbscpy_s
strcat_s, wcscat_s, _mbscat_s
pin_ptr (C++/CLI)

Compartilhar via

Como: converter entre diversos tipos de cadeia de caracteres

Executar os exemplos

Exemplo: converter de `char *`

Descrição

Código

Exemplo: converter de `wchar_t *`

Descrição

Código

Exemplo: converter de `_bstr_t`

Descrição

Código

Exemplo: converter de `CComBSTR`

Descrição

Código

Exemplo: converter de `CString`

Descrição

Código

Exemplo: converter de `basic_string`

Descrição

Código

Exemplo: converter de `System::String`

Descrição

Código

Convertendo entre cadeias de caracteres estreitos e largos

Confira também

Comentários

Recursos adicionais

Compartilhar via

Como: converter entre diversos tipos de cadeia de caracteres

Executar os exemplos

Exemplo: converter de char *

Descrição

Código

Exemplo: converter de wchar_t *

Descrição

Código

Exemplo: converter de _bstr_t

Descrição

Código

Exemplo: converter de CComBSTR

Descrição

Código

Exemplo: converter de CString

Descrição

Código

Exemplo: converter de basic_string

Descrição

Código

Exemplo: converter de System::String

Descrição

Código

Convertendo entre cadeias de caracteres estreitos e largos

Confira também

Comentários

Recursos adicionais

Exemplo: converter de `char *`

Exemplo: converter de `wchar_t *`

Exemplo: converter de `_bstr_t`

Exemplo: converter de `CComBSTR`

Exemplo: converter de `CString`

Exemplo: converter de `basic_string`

Exemplo: converter de `System::String`