Click this button to go to the index for this section.

strcoll(3)
NAME
  strcoll - Compares strings using locale collation

LIBRARY
  Standard C Library (libc.so, libc.a)

SYNOPSIS
  #include <string.h>

  int strcoll(
	  const char *s1,
	  const char *s2);

STANDARDS
  Interfaces documented on this reference page conform to industry standards
  as follows:

  strcoll():  XPG4, XPG4-UNIX

  Refer to the standards(5) reference page for more information about
  industry standards and associated tags.

PARAMETERS
  s1	    Specifies first string to be compared.

  s2	    Specifies second string to be compared.

DESCRIPTION
  The strcoll() function compares the string pointed to by the s1 parameter
  with the string pointed to by the s2 parameter, both interpreted as
  appropriate to the LC_COLLATE category of the current locale.

RETURN VALUES
  On successful completion, the strcoll() function returns an integer whose
  value is greater than, equal to, or less than 0 (zero), according to
  whether the s1 string is greater than, equal to, or less than the s2
  string.

  [Digital]  When a successful comparison cannot be made, this function
  returns a value of 0 (zero).

ERRORS
  The strcoll() function sets errno to the specified values for the following
  conditions:

  [EINVAL]  The string pointed to by the s1 or s2 parameter contains
	    characters outside the domain of the collating sequence.




RELATED INFORMATION
  Functions: setlocale(3), string(3)/strcmp(3), strxfrm(3), wcscoll(3)

  Standards: standards(5)