std::collate::compare, std::collate::do_compare

 

C++

Language

Concepts

Utilities library

Strings library

Containers library

Algorithms library

Iterators library

Numerics library

Input/output library

Localizations library

Regular expressions library (C++11)

Atomic operations library (C++11)

Thread support library (C++11)

 

Localizations library

Locales and facets
locale
use_facet	has_facet
Character classification
isspace isblank (C++11) iscntrl isupper islower isalpha	isdigit ispunct isxdigit isalnum isprint isgraph
Conversions
toupper tolower	wstring_convert (C++11) wbuffer_convert (C++11)
Facet category base classes
ctype_base codecvt_base messages_base	time_base money_base
Facet categories
ctype ctype<char> codecvt collate messages time_get time_put	num_get num_put numpunct money_get money_put moneypunct
Locale-specific facets
ctype_byname ctype_byname<char> codecvt_byname messages_byname collate_byname	time_get_byname time_put_byname numpunct_byname moneypunct_byname
Code conversion facets
codecvt_utf8 (C++11) codecvt_utf16 (C++11)	codecvt_utf8_utf16 (C++11) codecvt_mode (C++11)
C locale
setlocale localeconv lconv	LC_ALL LC_COLLATE LC_CTYPE LC_MONETARY LC_NUMERIC LC_TIME

 

std::collate

Member functions

collate::collate

collate::~collate

collate::compare collate::do_compare

collate::transform collate::do_transform

collate::hash collate::do_hash

 

Defined in header <locale>
public: int compare( const CharT* low1, const CharT* high1,              const CharT* low2, const CharT* high2 ) const;	(1)
protected: int do_compare( const CharT* low1, const CharT* high1,                 const CharT* low2, const CharT* high2 ) const;	(2)

1) public member function, calls the protected virtual member function do_compare of the most derived class.

2) Compares the character sequence [low1, high1) to the character sequence [low2, high2), using this locale's collation rules, and returns 1 if the first string follows the second, -1 if the first string precedes the second, zero if the two strings are equivalent.

Parameters

low1	-	pointer to the first character of the first string
high1	-	one past the end pointer for the first string
low2	-	pointer to the first character of the second string
high2	-	one past the end pointer for the second string

Return value

1 if the first string is greater than the second (that is, follows the second in the collation order), -1 if the first string is less than the second (precedes the second in the collation order), zero if the two strings are equivalent.

Notes

Collation order is typically lexicographic case-insensitive comparison according to the locale's alphabet, but in some locales, groups of characters compare as single collation units. For example, "ch" in Czech follows "h" and precedes "i", and "ng" in Welsh follows "g" and precedes "h".

See also

strcoll	compares two strings in accordance to the current locale (function)
wcscoll	compares two wide strings in accordance to the current locale (function)
operator()	lexicographically compares two strings using this locale's collate facet (public member function of std::locale)