CStringT Class

Artículo
06/09/2015

esta clase representa un objeto de CStringT .

template< typename BaseType, class StringTraits > 
class CStringT :  
public CSimpleStringT<   BaseType,   _CSTRING_IMPL_::_MFCDLLTraitsCheck<      BaseType,      StringTraits   >   ::c_bIsMFCDLLTraits>

Parámetros

BaseType
El tipo de caracteres de la clase de cadena. Puede ser una de las siguientes:
- char (para las cadenas de caracteres ANSI).
- wchar_t (para las cadenas de caracteres Unicode).
- TCHAR (para ANSI y las cadenas de caracteres Unicode).
StringTraits
Determina si la clase de cadena necesita la biblioteca en tiempo de ejecución de (CRT) C admiten y dónde se encuentran los recursos de cadena. Puede ser una de las siguientes:
- wchar_t de StrTraitATL< | char | TCHAR, wchar_t de ChTraitsCRT< | char | TCHAR > >
  
  La clase requiere compatibilidad y las búsquedas de CRT para las cadenas de recursos en el módulo especificado por m_hInstResource (miembro de la clase de módulo de aplicación).
- wchar_t de StrTraitATL< | char | TCHAR, wchar_t de ChTraitsOS< | char | TCHAR > >
  
  La clase no necesita compatibilidad y las búsquedas de CRT para las cadenas de recursos en el módulo especificado por m_hInstResource (miembro de la clase de módulo de aplicación).
- wchar_t de StrTraitMFC< | char | TCHAR, wchar_t de ChTraitsCRT< | char | TCHAR > >
  
  La clase requiere compatibilidad y las búsquedas de CRT para las cadenas de recursos mediante el algoritmo de búsqueda estándar de MFC.
- wchar_t de StrTraitMFC< | char | TCHAR, wchar_t de ChTraitsOS< | char | TCHAR > >
  
  La clase no necesita compatibilidad y las búsquedas de CRT para las cadenas de recursos mediante el algoritmo de búsqueda estándar de MFC.

Members

Constructores públicos

Name	Descripción
CStringT::CStringT	Construye un objeto de CStringT de varias maneras.
CStringT::~CStringT	Destruye un objeto CStringT.

Métodos públicos

Name	Descripción
CStringT::AllocSysString	Asigna BSTR de los datos de CStringT .
CStringT::AnsiToOem	Crea una conversión en el contexto del juego de caracteres ANSI el juego de caracteres OEM.
CStringT::AppendFormat	Appends formateó datos a un objeto existente de CStringT .
CStringT::Collate	Compara dos cadenas (distingue entre mayúsculas y minúsculas, utiliza la información de la configuración regional).
CStringT::CollateNoCase	Compara dos cadenas (sin distinción entre mayúsculas y minúsculas, utiliza la información de la configuración regional).
CStringT::Compare	Compara dos cadenas (distingue entre mayúsculas y minúsculas).
CStringT::CompareNoCase	compara dos cadenas (sin distinción entre mayúsculas y minúsculas).
CStringT::Delete	elimina un carácter o caracteres de una cadena.
CStringT::Find	Encuentra un carácter o una subcadena en una cadena mayor.
CStringT::FindOneOf	Encuentra el primer carácter coincidente de un conjunto.
CStringT::Format	Da formato a la cadena como hace sprintf .
CStringT::FormatMessage	Da formato a una cadena de mensaje.
CStringT::FormatMessageV	Da formato a una cadena de mensaje mediante una lista de argumentos de variable.
CStringT::FormatV	Da formato a la cadena mediante una lista variable de argumentos.
CStringT::GetEnvironmentVariable	Establece la cadena el valor de la variable de entorno especificada.
CStringT::Insert	Inserta un carácter o una subcadena en el índice especificado en la cadena.
CStringT::Left	Extrae la parte izquierda de una cadena.
CStringT::LoadString	carga un objeto existente de CStringT de un recurso de Windows.
CStringT::MakeLower	Convierte todos los caracteres de la cadena a caracteres en minúsculas.
CStringT::MakeReverse	invierte la cadena.
CStringT::MakeUpper	Convierte todos los caracteres de la cadena a caracteres en mayúscula.
CStringT::Mid	Extrae la parte media de una cadena.
CStringT::OemToAnsi	Crea una conversión en el contexto del juego de caracteres OEM el juego de caracteres ANSI.
CStringT::Remove	Quita indicó caracteres de una cadena.
CStringT::Replace	Replaces indicó caracteres con otros caracteres.
CStringT::ReverseFind	Encuentra un carácter en una cadena mayor; sale del extremo.
CStringT::Right	Extrae la parte derecha de una cadena.
CStringT::SetSysString	establece un objeto existente de BSTR con datos de un objeto de CStringT .
CStringT::SpanExcluding	extrae los caracteres de la cadena, empezando por el primer carácter, que no están en el conjunto de caracteres identificados por pszCharSet.
CStringT::SpanIncluding	Dibuja una subcadena que contiene únicamente caracteres en un conjunto.
CStringT::Tokenize	Extrae tokens especificado en la cadena de destino.
CStringT::Trim	Corta todos los caracteres iniciales y finales en blanco la cadena.
CStringT::TrimLeft	Ajustes que conducen los caracteres de espacio en blanco de la cadena.
CStringT::TrimRight	Ajustes que arrastre los caracteres de espacio en blanco de la cadena.

Operadores

CStringT::operator =	asigna un nuevo valor a un objeto de CStringT .
CStringT::operator +	concatena dos cadenas o un carácter y una cadena.
CStringT::operator +=	Concatena una nueva cadena al final de una cadena existente.
CStringT::operator ==	determina si dos cadenas son lógicamente iguales.
CStringT::operator !=	determina si dos cadenas no son lógicamente iguales.
CStringT::operator <	Determina si la cadena en el lado izquierdo del operador es menor que la cadena en el lado derecho.
CStringT::operator >	Determina si la cadena en el lado izquierdo del operador es mayor que la cadena en el lado derecho.
CStringT::operator <=	Determina si la cadena en el lado izquierdo del operador menor o igual que la cadena en el lado derecho.
CStringT::operator >=	Determina si la cadena en el lado izquierdo del operador mayor o igual que la cadena en el lado derecho.

Comentarios

CStringT hereda de clase de CSimpleStringT. Las características avanzadas, como la manipulación de carácter, ordenar, y busque, se implementan en CStringT.

Nota

los objetos deCStringT son capaces de producir excepciones.Esto ocurre cuando se ejecuta un objeto de CStringT fuera de memoria por cualquier motivo.

Un objeto de CStringT consta de una secuencia de longitud variable de caracteres. CStringT proporciona funciones y operadores mediante la sintaxis similar a la de básico. Concatenación y los operadores de comparación, así como la administración de memoria simplificada, crean los objetos de CStringT más fáciles de utilizar que las matrices de caracteres normales.

Nota

Aunque es posible crear instancias de CStringT que contienen caracteres nulos incrustados, recomendamos con ellos.Los métodos y operadores de los objetos de CStringT que contienen caracteres nulos incrustados pueden generar resultados imprevistos.

Usar distintas combinaciones de parámetros de BaseType y de StringTraits , los objetos de CStringT pueden crecer en los siguientes tipos, que se han sido predefinidos por las bibliotecas de ATL.

Si utiliza en una aplicación ATL:

CString, CStringA, y CStringW se exportan DLL de MFC (MF C90 .DLL), nunca de las DLL de usuario. Esto es necesario para evitar que CStringT sea multiplicar definido.

Nota

Si se produjo errores del vinculador para exportar CString- clase derivada de un archivo DLL de extensión MFC en Visual C++ .NET 2002 y ha aplicado la solución alternativa como se describe en el artículo de Knowledge Base, “vinculando clases CString-Derivadas de importación Cuando Se de errores” (Q309801), debe quitar el código de la solución, porque esto se ha solucionado en Visual C++ .NET 2003.Encontrará artículos de Knowledge Base en el CD-ROM de MSDN Library o en la dirección https://support.microsoft.com/support.

Los tipos de cadena siguientes están disponibles en las aplicaciones basadas:

tipo de CStringT	Declaración
CStringA	Un tipo string de caracteres ANSI con compatibilidad de CRT.
CStringW	Un tipo de cadena de caracteres Unicode con compatibilidad de CRT.
CString	ANSI y los tipos de caracteres Unicode con compatibilidad de CRT.

Los tipos de cadena siguientes están disponibles en proyectos donde se define ATL_CSTRING_NO_CRT :

tipo de CStringT	Declaración
CAtlStringA	Un tipo string de caracteres ANSI sin compatibilidad de CRT.
CAtlStringW	Un tipo de cadena de caracteres Unicode sin compatibilidad de CRT.
CAtlString	ANSI y los tipos de caracteres Unicode sin compatibilidad de CRT.

Los tipos de cadena siguientes están disponibles en proyectos donde no está definido ATL_CSTRING_NO_CRT :

tipo de CStringT	Declaración
CAtlStringA	Un tipo string de caracteres ANSI con compatibilidad de CRT.
CAtlStringW	Un tipo de cadena de caracteres Unicode con compatibilidad de CRT.
CAtlString	ANSI y los tipos de caracteres Unicode con compatibilidad de CRT.

los objetos deCString también tienen las siguientes características:

los objetos deCStringT pueden crecer como resultado de las operaciones de concatenación.
los objetos deCStringT siguen la “semántica de valores”. Piense en un objeto de CStringT como cadena real, no como un puntero a una cadena.
Puede sustituir libremente los objetos de CStringT para los argumentos de la función de PCXSTR .
Administración de memoria personalizada para los búferes de cadenas. Para obtener más información, vea administración de memoria y CStringT.

CStringT los tipos

Dado que CStringT utiliza un argumento de plantilla para definir el tipo de carácter ( wchar_t o char) admite, los tipos de parámetro de método pueden ser más complejos a veces. Para simplificar este problema, un conjunto de tipos predefinidos se define y se usa en la clase de CStringT . La tabla siguiente se enumeran los tipos diferentes:

Name	Descripción
XCHAR	Un carácter individual ( wchar_t o char) con el mismo tipo de caracteres que el objeto de CStringT .
YCHAR	Un carácter individual ( wchar_t o char) con el tipo de carácter opuesto como objeto de CStringT .
PXSTR	Un puntero a una cadena de caracteres ( wchar_t o char) con el mismo tipo de caracteres que el objeto de CStringT .
PYSTR	Un puntero a una cadena de caracteres ( wchar_t o char) con el tipo de carácter opuesto como objeto de CStringT .
PCXSTR	Un puntero a una cadena de caracteres const ( wchar_t o char) con el mismo tipo de caracteres que el objeto de CStringT .
PCYSTR	Un puntero a una cadena de caracteres const ( wchar_t o char) con el tipo de carácter opuesto como objeto de CStringT .

Nota

El código que utilizó anteriormente métodos indocumentados de CString (como AssignCopy) se debe reemplazar con el código que utiliza los métodos documentados siguientes de CStringT (como GetBuffer o ReleaseBuffer).estos métodos se heredan de CSimpleStringT.

Jerarquía de herencia

CSimpleStringT

CStringT

Requisitos

Encabezado	Se utiliza para
cstringt.h	Objetos de cadena de MFC-solamente
atlstr.h	Objetos string de MFC

Vea también

Referencia

Gráfico de jerarquías

CSimpleStringT Class

Otros recursos

ATL/MFC Shared Classes

CStringT Class

Parámetros

Members

Constructores públicos

Métodos públicos

Operadores

Comentarios

CStringT los tipos

Jerarquía de herencia

Requisitos

Vea también

Referencia

Otros recursos

Recursos adicionales