CStringElementTraitsI (clase)

Esta clase proporciona funciones estáticas relacionadas con cadenas almacenadas en objetos de clase de la colección. Es similar a CStringElementTraits, pero realiza comparaciones sin distinción entre mayúsculas y minúsculas.

Sintaxis

template <typename T, class CharTraits = CDefaultCharTraits<T ::XCHAR>>
class CStringElementTraitsI : public CElementTraitsBase<T>

Parámetros

T
Tipo de datos que se van a almacenar en la colección.

Miembros

Definiciones de tipos públicas

Nombre	Descripción
CStringElementTraitsI::INARGTYPE	Tipo de datos que se va a usar para agregar elementos al objeto de clase de la colección.
CStringElementTraitsI::OUTARGTYPE	Tipo de datos que se va a usar para recuperar elementos del objeto de clase de la colección.

Métodos públicos

Nombre	Descripción
CStringElementTraitsI::CompareElements	Llame a esta función estática para comparar dos elementos de cadena y comprobar si son iguales, omitiendo las diferencias en cuanto al uso de mayúsculas y minúsculas.
CStringElementTraitsI::CompareElementsOrdered	Llame a esta función estática para comparar dos elementos de cadena, omitiendo las diferencias en cuanto al uso de mayúsculas y minúsculas.
CStringElementTraitsI::Hash	Llame a esta función estática para calcular un valor hash del elemento de cadena indicado.

Comentarios

Esta clase proporciona funciones estáticas para comparar las cadenas y para crear un valor hash. Estas funciones son útiles cuando se usa una clase de colección para almacenar datos basados en cadenas. Use CStringRefElementTraits cuando los objetos de cadena deban tratarse como referencias.

Para obtener más información, consulte Clases de colección en ATL.

Jerarquía de herencia

CElementTraitsBase

CStringElementTraitsI

Requisitos

Encabezado: atlcoll.h

CStringElementTraitsI::CompareElements

Llame a esta función estática para comparar dos elementos de cadena y comprobar si son iguales, omitiendo las diferencias en cuanto al uso de mayúsculas y minúsculas.

static bool CompareElements(INARGTYPE str1, INARGTYPE str2) throw();

Parámetros

str1
El primer elemento de la cadena.

str2
El segundo elemento de la cadena.

Valor devuelto

Devuelve true si los elementos son iguales; de lo contrario, devuelve false.

Comentarios

Las comparaciones no distinguen entre mayúsculas y minúsculas.

CStringElementTraitsI::CompareElementsOrdered

Llame a esta función estática para comparar dos elementos de cadena, omitiendo las diferencias en cuanto al uso de mayúsculas y minúsculas.

static int CompareElementsOrdered(INARGTYPE str1, INARGTYPE str2) throw();

Parámetros

str1
El primer elemento de la cadena.

str2
El segundo elemento de la cadena.

Valor devuelto

Es cero si las cadenas son idénticas, < 0 si str1 es menor que str2 o > 0 si str1 es mayor que str2. El método CStringT::Compare se usa para hacer las comparaciones.

Comentarios

Las comparaciones no distinguen entre mayúsculas y minúsculas.

CStringElementTraitsI::Hash

Llame a esta función estática para calcular un valor hash del elemento de cadena indicado.

static ULONG Hash(INARGTYPE str) throw();

Parámetros

str
Elemento de la cadena.

Valor devuelto

Devuelve un valor hash, calculado con el contenido de la cadena.

CStringElementTraitsI::INARGTYPE

Tipo de datos que se va a usar para agregar elementos al objeto de clase de la colección.

typedef T::PCXSTR INARGTYPE;

CStringElementTraitsI::OUTARGTYPE

Tipo de datos que se va a usar para recuperar elementos del objeto de clase de la colección.

typedef T& OUTARGTYPE;

Consulte también

CElementTraitsBase (clase)
Información general sobre la clase
CStringElementTraits (clase)