CStringOperações CString relacionadas a cadeias de caracteres de estilo C

  • Artigo

Um objeto CString contém dados de cadeia de caracteres. CString herda o conjunto dos métodos e operadores que são definidos no modelo de classe CStringT para trabalhar com dados de cadeia de caracteres. (CString é um typedef que especializa CStringT para trabalhar com o tipo de dados de caractere com suporte em CString.)

O CString não armazena dados de caracteres internamente como uma cadeia de caracteres de terminação nula de estilo C. Em vez disso, o CString controla o comprimento dos dados de caracteres, para que ele possa observar de maneira mais segura os dados e o espaço que necessita.

O CString não aceita cadeias de caracteres de estilo C e fornece maneiras de acessar dados de caracteres como uma cadeia de caracteres de estilo C. Este tópico contém as seguintes seções que explicam como usar um objeto CString como se fosse uma cadeia de caracteres de terminação nula e estilo C.

Usando CString como uma cadeia de caracteres de terminação nula de estilo C

Para usar um objeto CString como uma cadeia de caracteres de estilo C, converta o objeto para LPCTSTR. No exemplo a seguir, o CString retorna um ponteiro para uma cadeia de caracteres de terminação nula de estilo C somente leitura. A função strcpy coloca uma cópia da cadeia de caracteres de estilo C na variável myString.

CString aCString = "A string";
char myString[256];
strcpy(myString, (LPCTSTR)aCString);

Você pode usar métodos CString, por exemplo, SetAt, para modificar caracteres individuais no objeto de cadeia de caracteres. No entanto, o ponteiro LPCTSTR é temporário e se torna inválido quando qualquer alteração é feita no CString. O CString também pode sair do escopo e ser automaticamente excluído. Recomendamos que você obtenha um novo ponteiro LPCTSTR de um objeto CString toda vez que você usa um.

Às vezes, você pode precisar que uma cópia de dados do CString seja modificada diretamente. Use a função mais segura strcpy_s (ou o Unicode/MBCS-portable _tcscpy_s) para copiar o objeto CString em um buffer separado. Este é o local onde os caracteres podem ser modificados com segurança, como mostrado no exemplo seguinte.

CString theString(_T("This is a test"));
int sizeOfString = (theString.GetLength() + 1);
LPTSTR lpsz = new TCHAR[sizeOfString];
_tcscpy_s(lpsz, sizeOfString, theString);
//... modify lpsz as much as you want

Observação

O terceiro argumento para strcpy_s (ou o _tcscpy_s portátil de Unicode/MBCS) é um const wchar_t* (Unicode) ou um const char* (ANSI). O exemplo acima passa um CString para este argumento. O compilador C++ aplica automaticamente a função de conversão definida para o CString que converte uma classe CString para um LPCTSTR. A capacidade de definir as operações de conversão de um tipo para outro é um dos recursos mais úteis do C++.

Trabalhando com funções de cadeia de caracteres de biblioteca de tempo de execução padrão

Você conseguirá encontrar um método CString para realizar qualquer operação de cadeia de caracteres para a qual você considere o uso das funções padrão de cadeia de biblioteca em tempo de execução C, como strcmp (ou o Unicode/MBCS-portable _tcscmp).

Se você precisar usar as funções de cadeia de caracteres em tempo de execução C, poderá usar as técnicas descritas em Usar CString como uma cadeia de caracteres terminada em nulo no estilo C. Você pode copiar o objeto CString para um buffer de cadeia estilo C equivalente, executar suas operações no buffer e depois atribuir a cadeia de caracteres de estilo C resultante de novo ao objeto CString.

Modificando conteúdos CString diretamente

Na maioria das situações, você deve usar funções de membro CString para modificar o conteúdo de um objeto CString ou para converter o CString para uma cadeia de caracteres de estilo C.

Existem algumas situações em que faz sentido modificar diretamente o conteúdo CString, por exemplo, quando você trabalha com funções do sistema operacional que exigem um buffer de caracteres.

Os métodos GetBuffer e ReleaseBuffer oferecem acesso ao buffer de caracteres interno de um objeto CString e deixam você modificá-lo diretamente. As etapas a seguir mostram como usar essas funções para essa finalidade.

Para usar GetBuffer e ReleaseBuffer para acessar o buffer de caractere interno de um objeto CString

  1. Chame GetBuffer para um objeto CString e especifique o tamanho do buffer que você necessita.

  2. Use o ponteiro retornado por GetBuffer para escrever caracteres diretamente no objeto CString.

  3. Chame ReleaseBuffer para o objeto CString para atualizar todas as informações de estado internas do CString, por exemplo, o comprimento da cadeia de caracteres. Depois de modificar o conteúdo de um objeto CString diretamente, chame ReleaseBuffer antes de chamar qualquer outra função de membro CString.

Usando objetos CString com funções de argumentos de variável

Algumas funções C usam um número variável de argumentos. Um exemplo notável é printf_s. Devido à forma como esse tipo de função é declarado, o compilador não pode ter certeza do tipo dos argumentos e não pode determinar qual operação de conversão realizar em cada argumento. Portanto, é essencial que você use um tipo de conversão explícita ao passar um objeto CString para uma função que recebe um número variável de argumentos.

Para usar um objeto CString em uma função de argumento variável, converta explicitamente CString para uma cadeia de caracteres LPCTSTR, como mostrado no exemplo a seguir.

CString kindOfFruit = _T("bananas");
int howmany = 25;
_tprintf_s(_T("You have %d %s\n"), howmany, (LPCTSTR)kindOfFruit);

Especificando parâmetros formais CString

Para a maioria das funções que precisam de um argumento de cadeia de caracteres, é melhor especificar o parâmetro formal no protótipo da função como um ponteiro const para um caractere (LPCTSTR), em vez de um CString. Quando um parâmetro formal é especificado como um ponteiro const para um caractere, você pode passar um ponteiro para uma matriz TCHAR, uma cadeia de caracteres literal ["hi there"] ou um objeto CString. O objeto CString será automaticamente convertido para um LPCTSTR. Em todo lugar que você pode usar um LPCTSTR, você também pode usar um objeto CString.

Você também pode especificar um parâmetro formal como uma referência constante de cadeia de caracteres (isto é, const CString&) se o argumento não será modificado. Remova o modificador const se a cadeia de caracteres será modificada pela função. Se você desejar um valor nulo padrão, inicialize-o para a cadeia de caracteres nula [""], como mostrado abaixo:

void AddCustomer(const CString& name, const CString& address, 
   const CString& comment = _T(""));

Para a maioria dos resultados de função, você pode simplesmente retornar um objeto CString por valor.

Confira também

Cadeias de caracteres (ATL/MFC)
CString Transmissão de argumento