Usando CString

Os tópicos desta seção descrevem como programar com CString. Para obter a documentação de referência sobre a CString classe, consulte a documentação do CStringT .

Para usar CString, inclua o cabeçalho atlstr.h.

As CString classes, CStringA e CStringW são especializações de um modelo de classe chamado CStringT com base no tipo de dados de caractere com suporte.

Um CStringW objeto contém o tipo e oferece suporte a cadeias de wchar_t caracteres Unicode. Um CStringA objeto contém o tipo e dá suporte a char cadeias de caracteres de byte único e multi-byte (MBCS). Um CString objeto dá suporte ao char tipo ou ao wchar_t tipo, dependendo se o símbolo MBCS ou o símbolo Unicode está definido no momento da compilação.

Um objeto CString mantém os dados de caracteres em um objeto CStringData. CString aceita cadeias de caracteres em estilo C terminadas em nulo. CString controla o tamanho da cadeia de caracteres para um desempenho mais rápido, mas também retém o NULL caractere nos dados de caracteres armazenados para dar suporte à conversão para LPCWSTR . CString inclui o terminador nulo quando exporta uma cadeia de caracteres em estilo C. Você pode inserir um NULL em outros locais em um CString , mas ele pode produzir resultados inesperados.

O conjunto de classes de cadeias de caracteres a seguir pode ser usado sem vincular uma biblioteca MFC, com ou sem suporte para CRT: CAtlString, CAtlStringA e CAtlStringW.

CString é usado em projetos nativos. Para projetos de código gerenciado (C++/CLI), use System::String.

Para adicionar mais recursos que CString, CStringA ou CStringW oferecem no momento, você deve criar uma subclasse de CStringT que contém os recursos adicionais.

O código a seguir mostra como criar uma CString e imprimi-la na saída padrão:

#include <atlstr.h>

int main() {
    CString aCString = CString(_T("A string"));
    _tprintf(_T("%s"), (LPCTSTR) aCString);
}

Nesta seção

Operações básicas CString
Descreve as operações CString básicas, incluindo a criação de objetos de cadeias de caracteres literais de C, acessando caracteres individuais em uma CString, concatenando dois objetos e comparando objetos CString.

cadeia de caracteres Gerenciamento de Dados
Discute o uso de Unicode e MBCS com CString.

Semântica de CString
Explica como os objetos CString são usados.

Operações CString relacionadas a cadeias de estilo C
Descreve a manipulação do conteúdo de um objeto CString como uma cadeia de caracteres de terminação nula de estilo C.

Alocando e liberando memória para um BSTR
Discute o BSTR uso de memória para objetos e com.

Limpeza de exceção CString
Explica que a limpeza explícita no MFC 3.0 e versões posteriores não é mais necessária.

Passagem de argumento CString
Explica como passar CString objetos para o Functions e como retornar CString objetos de funções.

Suporte a MBCS (conjunto de caracteres multibyte) e Unicode
Discute como o MFC é habilitado para suporte a Unicode e MBCS.

Referência

CStringT
Fornece informações de referência sobre a classe CStringT.

CSimpleStringT Classes
Fornece informações de referência sobre a classe CSimpleStringT.

Cadeias de caracteres (ATL/MFC)
Contem links para tópicos que descrevem várias maneiras de gerenciar dados da cadeia de caracteres.

Cadeias de caracteres (ATL/MFC)