Using CString

 

Para obtener la documentación más reciente de Visual Studio 2017 RC, consulte Documentación de Visual Studio 2017 RC.

En los temas de esta sección se describe cómo programar con CString. Consulte la documentación relativa a la clase CString como referencia sobre estahttps://msdn.microsoft.com/es-es/library/5bzxfsea.aspxclase.

Para usar CString, incluya el encabezado atlstr.h.

Las clases CString, CStringA y CStringW son especializaciones de una plantilla de clase denominada CStringT, que se basa en el tipo de datos de caracteres que admiten.

Un objeto CStringW contiene el tipo wchar_t y admite cadenas Unicode. Un objeto CStringA contiene el tipo char y admite cadenas de un solo byte o multibyte (MBCS). Un objeto CString admite el tipo char o el tipo wchar_t, dependiendo de si se ha definido el símbolo MBCS o el símbolo UNICODE en el tiempo de compilación.

Un objeto CString conserva los datos de caracteres en un objeto CStringData. CString acepta cadenas de estilo C terminadas en null, pero no conserva el carácter null en los datos de caracteres almacenados. En su lugar, CString realiza un seguimiento de la longitud de la cadena. CString sí proporciona un terminador nulo cuando exporta una cadena de estilo C. Se puede insertar un elemento null en CString, pero esto podría generar resultados inesperados.

El siguiente conjunto de clases de cadena se puede usar sin vincular a una biblioteca MFC, tanto si hay o no compatibilidad de CRT: CAtlString, CAtlStringA y CAtlStringW.

CString se usa en objetos nativos. En los proyectos de código administrado (C++/CLI), use System::String.

Para agregar más capacidades de las que CString, CStringA o CStringW ofrecen actualmente, conviene crear una subclase de CStringT que contenga las características extra.

El siguiente código muestra cómo crear una CString e imprimirla en una salida estándar:

#include <atlstr.h>  
  
int main() {  
    CString aCString = CString(_T("A string"));  
    _tprintf(_T("%s"), (LPCTSTR) aCString);  
}  

Operaciones básicas de CString
Se describen las operaciones básicas de CString, por ejemplo, cómo crear objetos a partir de cadenas literales de C, cómo acceder a caracteres individuales de una CString, cómo concatenar dos objetos y cómo comparar objetos CString.

Administración de datos de cadena
Se aborda el uso de Unicode y MBCS con CString.

Semántica de CString
Se explica el uso de objetos CString.

Operaciones de CString relacionadas con cadenas de estilo C
Se describe cómo manipular el contenido de un objeto CString como una cadena terminada en un valor nulo de estilo C.

Asignación y liberación de memoria para un BSTR
Se explica el uso de memoria en relación con un BSTR y objetos COM.

Limpieza de excepciones de CString
Se explica que la limpieza expresa en MFC 3.0 y en versiones posteriores ya no es necesaria.

Paso de argumentos de CString
Se detalla cómo pasar objetos CString a funciones y cómo obtener objetos CString de las funciones.

Compatibilidad con Unicode y con el juego de caracteres multibyte (MBCS)
Se centra en cómo MFC permite el uso de Unicode y MBCS.

CStringT
Contiene información de referencia sobre la clase CStringT.

CSimpleStringT Class
Contiene información de referencia sobre la clase CSimpleStringT.

Cadenas
Contiene vínculos a temas en los que se describen las diversas formas de administrar datos de cadena.

Crear instancias de plantillas de clase
CString es un typedef basado en CStringT, que es instancia de una especialización de una plantilla de clase.

Mostrar: