Yolinux.com

strcoll manpage

Search topic Section


STRCOLL(3)		   Linux Programmer's Manual		    STRCOLL(3)



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  pro-
       gram'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 |
       +----------+---------------+----------------+

CONFORMING TO
       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/.



GNU				  2015-08-08			    STRCOLL(3)