std::strcoll

 

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)

 

Strings library

Null-terminated strings

Byte strings

Multibyte strings

Wide strings

Classes

basic_string

char_traits

 

Null-terminated byte strings

Functions
Character manipulation
isalnum isalpha islower isupper isdigit isxdigit isblank (C++11)	iscntrl isgraph isspace isprint ispunct tolower toupper
Conversions to numeric formats
atof atoi atol atoll strtol strtoll	strtoul strtoull strtof strtod strtold
String manipulation
strcpy
strncpy
strcat
strncat
strxfrm
String examination
strlen strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtok
Memory manipulation
memchr
memcmp
memset
memcpy
memmove
Miscellaneous
strerror

 

Defined in header <cstring>
int strcoll( const char* lhs, const char* rhs );

Compares two null-terminated byte strings according to the current locale as defined by the LC_COLLATE category.

Parameters

lhs, rhs

-

pointers to the null-terminated byte strings to compare

Return value

Negative value if lhs is less than (precedes) rhs.

​0​ if lhs is equal to rhs.

Positive value if lhs is greater than (follows) rhs.

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

wcscoll	compares two wide strings in accordance to the current locale (function)
do_compare [virtual]	compares two strings using this facet's collation rules (virtual protected member function of std::collate)
strxfrm	transform a string so that strcmp would produce the same result as strcoll (function)