Namespaces
Variants

std::collate<CharT>:: compare, std::collate<CharT>:: do_compare

From cppreference.net
C++
Text processing library
Localization library
std::collate
Definido en el encabezado <locale>
public :

int compare ( const CharT * low1, const CharT * high1,

const CharT * low2, const CharT * high2 ) const ;
(1)
protected :

virtual int do_compare ( const CharT * low1, const CharT * high1,

const CharT * low2, const CharT * high2 ) const ;
(2)
1) Función miembro pública, llama a la función miembro virtual protegida do_compare de la clase más derivada.
2) Compara la secuencia de caracteres [ low1 , high1 ) con la secuencia de caracteres [ low2 , high2 ) , utilizando las reglas de colación de esta configuración regional, y devuelve 1 si la primera cadena sigue a la segunda, - 1 si la primera cadena precede a la segunda, cero si las dos cadenas son equivalentes.

Contenidos

Parámetros

low1 - puntero al primer carácter de la primera cadena
high1 - puntero una posición después del final para la primera cadena
low2 - puntero al primer carácter de la segunda cadena
high2 - puntero una posición después del final para la segunda cadena

Valor de retorno

1 si la primera cadena es mayor que la segunda (es decir, sigue a la segunda en el orden de intercalación), - 1 si la primera cadena es menor que la segunda (precede a la segunda en el orden de intercalación), cero si las dos cadenas son equivalentes.

Notas

Cuando no se requiere una comparación de tres vías (como al proporcionar un argumento Compare a algoritmos estándar como std::sort ), std::locale::operator() puede ser más apropiado.

El orden de intercalación es el orden del diccionario: la posición de la letra en el alfabeto nacional (su clase de equivalencia ) tiene mayor prioridad que su caso o variante. Dentro de una clase de equivalencia, los caracteres en minúscula se intercalan antes que sus equivalentes en mayúscula y puede aplicarse un orden específico de la configuración regional a los caracteres con diacríticos. En algunas configuraciones regionales, grupos de caracteres se comparan como unidades de intercalación individuales. Por ejemplo, "ch" en checo sigue a "h" y precede a "i" , y "dzs" en húngaro sigue a "dz" y precede a "g" .

Ejemplo

Ejecutar este código 
#include <iostream>
#include <locale>
#include <string>
template<typename CharT>
void try_compare(const std::locale& l, const CharT* p1, const CharT* p2)
{
    auto& f = std::use_facet<std::collate<CharT>>(l);
    std::basic_string<CharT> s1(p1), s2(p2);
    if (f.compare(&s1[0], &s1[0] + s1.size(),
                  &s2[0], &s2[0] + s2.size()) < 0)
        std::wcout << p1 << " before " << p2 << '\n';
    else
        std::wcout << p2 << " before " << p1 << '\n';
}
int main()
{
    std::locale::global(std::locale("en_US.utf8"));
    std::wcout.imbue(std::locale());
    std::wcout << "In the American locale: ";
    try_compare(std::locale(), "hrnec", "chrt");
    std::wcout << "In the Czech locale: ";
    try_compare(std::locale("cs_CZ.utf8"), "hrnec", "chrt");
    std::wcout << "In the American locale: ";
    try_compare(std::locale(), L"år", L"ängel");
    std::wcout << "In the Swedish locale: ";
    try_compare(std::locale("sv_SE.utf8"), L"år", L"ängel");
}

Salida: 

In the American locale: chrt before hrnec
In the Czech locale: hrnec before chrt
In the American locale: ängel before år
In the Swedish locale: år before ängel

Véase también

compara dos cadenas de acuerdo a la configuración regional actual
(función)
compara dos cadenas anchas de acuerdo a la configuración regional actual
(función)
compara lexicográficamente dos cadenas usando la faceta de colación de esta configuración regional
(función miembro pública de std::locale )