Usando CString

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

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

As CStringclasses , CStringA, e CStringW são especializações de um modelo de classe chamado CStringT com base no tipo de dados de carácter que suportam.

Um CStringW objeto contém o wchar_t tipo e suporta cadeias Unicode. Um CStringA objeto contém o char tipo e suporta cadeias de um e múltiplo byte (MBCS). Um CString objeto suporta o char tipo ou o wchar_t tipo, dependendo se o símbolo MBCS ou o símbolo UNICODE está definido em tempo de compilação.

Um objeto mantém dados de CString carácter dentro de um CStringData objeto. CString aceita cordas do estilo C terminadas por NULL. CString Acompanha o comprimento da string para um desempenho mais rápido, mas também mantém o NULL carácter nos dados armazenados para suportar a conversão para LPCWSTR. CString inclui o terminador nulo quando exporta uma cadeia ao estilo C. Pode inserir a NULL noutros locais de um CString, mas pode produzir resultados inesperados.

O seguinte conjunto de classes de cadeia pode ser usado sem ligar uma biblioteca MFC, com ou sem suporte CRT: CAtlString, CAtlStringA, e CAtlStringW.

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

Para adicionar mais capacidades do que CString, , ou CStringW atualmente oferece, deve criar uma subclasse de CStringT que contenha as funcionalidades CStringAadicionais.

O seguinte código mostra como criar um CString e imprimi-lo para saída padrão:

#include <atlstr.h>

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

Na presente seção

Operações Básicas CString
Descreve operações básicas CString , incluindo a criação de objetos a partir de cadeias literais em C, o acesso a caracteres individuais num CString, a concatenação de dois objetos e a comparação CString de objetos.

Gestão de Dados de Cadeias
Discute a utilização de Unicode e MBCS com CString.

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

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

Alocar e libertar memória para um BSTR
Discute o uso de memória para um BSTR e dos objetos COM.

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

Aprovação do Argumento CString
Explica como passar CString objetos para funções e como devolver CString objetos a partir de funções.

Suporte a Unicode e MBCS (Multibyte Character set)
Discute como o MFC está ativado para suporte a Unicode e MBCS.

Reference

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

CSimpleStringT Classe
Fornece informações de referência sobre a CSimpleStringT disciplina.

Seções relacionadas

Cordas (ATL/MFC)
Contém ligações para tópicos que descrevem várias formas de gerir dados de cadeias de caracteres.

Cordas (ATL/MFC)