NAME¶
strcoll - compare two strings using the current locale
SYNOPSIS¶
#include <string.h>
int strcoll(const char *s1, const char *s2);
DESCRIPTION¶
The
strcoll() function compares the two strings
s1 and
s2.
It returns an integer less than, equal to, or greater than zero if
s1
is found, respectively, to be less than, to match, or be greater than
s2. The comparison is based on strings interpreted as appropriate for
the program's current locale for category
LC_COLLATE. (See
setlocale(3).)
RETURN VALUE¶
The
strcoll() function returns an integer less than, equal to, or greater
than zero if
s1 is found, respectively, to be less than, to match, or
be greater than
s2, when both are interpreted as appropriate for the
current locale.
ATTRIBUTES¶
For an explanation of the terms used in this section, see
attributes(7).
| Interface |
Attribute |
Value |
| strcoll () |
Thread safety |
MT-Safe locale |
POSIX.1-2001, POSIX.1-2008, C89, C99, SVr4, 4.3BSD.
NOTES¶
In the
POSIX or
C locales
strcoll() is equivalent to
strcmp(3).
SEE ALSO¶
bcmp(3),
memcmp(3),
setlocale(3),
strcasecmp(3),
strcmp(3),
string(3),
strxfrm(3)
COLOPHON¶
This page is part of release 4.10 of the Linux
man-pages project. A
description of the project, information about reporting bugs, and the latest
version of this page, can be found at
https://www.kernel.org/doc/man-pages/.
