Clase CStringRefElementTraits

Nota:

La biblioteca de plantillas activas (ATL) sigue siendo compatible. Sin embargo, ya no estamos agregando características ni actualizando la documentación.

Esta clase proporciona funciones estáticas relacionadas con cadenas almacenadas en objetos de clase de la colección. Los objetos de cadena se tratan como referencias.

Sintaxis

template <typename T>
class CStringRefElementTraits : public CElementTraitsBase<T>

Parámetros

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

Miembros

Métodos públicos

Nombre	Descripción
CStringRefElementTraits::CompareElements	Llame a esta función estática para comparar dos elementos de cadena y comprobar si son iguales.
CStringRefElementTraits::CompareElementsOrdered	Llame a esta función estática para comparar dos elementos de cadena.
CStringRefElementTraits::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. A diferencia de CStringElementTraits y CStringElementTraitsI, CStringRefElementTraits hace que los CString argumentos se pasen como constCString& referencias.

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

Jerarquía de herencia

CElementTraitsBase

CStringRefElementTraits

Requisitos

Encabezado: atlcoll.h

CStringRefElementTraits::CompareElements

Llame a esta función estática para comparar dos elementos de cadena y comprobar si son iguales.

static bool CompareElements(INARGTYPE element1, INARGTYPE element2) throw();

Parámetros

element1
El primer elemento de la cadena.

element2
El segundo elemento de la cadena.

Valor devuelto

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

CStringRefElementTraits::CompareElementsOrdered

Llame a esta función estática para comparar dos elementos de cadena.

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.

CStringRefElementTraits::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.

Consulte también

CElementTraitsBase (clase)
Información general sobre la clase