Share via


CStringT::CollateNoCase

Compara dos cadenas mediante la función _tcscollde texto genérico.

int CollateNoCase(
   PCXSTR psz
) const throw();

Parámetros

  • psz
    la otra cadena utilizada para la comparación.

Valor devuelto

Cero si las cadenas son idénticas (omitiendo el caso), < 0 si este objeto de CStringT es menor que psz (que omite el caso), o > 0 si este objeto de CStringT es mayor que psz (que omite el caso).

Comentarios

La función _tcscollde texto genérico, que se define en TCHAR.H, asigna a stricoll, a wcsicoll, o a _mbsicoll, dependiendo del juego de caracteres definido en tiempo de compilación. Cada función realiza una comparación sin distinción entre mayúsculas y minúsculas de las cadenas, según la página de códigos actualmente en uso. Para obtener más información, vea strcoll, wcscoll, _mbscoll, _strcoll_l, _wcscoll_l, _mbscoll_l.

Ejemplo

// typedef CStringT<TCHAR, StrTraitATL<TCHAR, ChTraitsCRT<TCHAR>>> CAtlString;

CAtlString str1 = _T("Co-Op");
CAtlString str2 = _T("con");

int n;

// Collation uses language rules, such as ignoring dashes. 
// NoCase version ignores case.
n = str1.CollateNoCase(str2);
ASSERT(n < 0);

// Comparison is a strict ASCII comparison with no language rules 
// but still ignores case in NoCase version.
n = str1.CompareNoCase(str2);
ASSERT(n < 0);   

Requisitos

encabezado: cstringt.h

Vea también

Referencia

CStringT Class