Index for Section 3

Alphabetical listing for S

Bottom of page

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

SYNOPSIS
  #include <string.h>

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

LIBRARY
  Standard C Library (libc)

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

  strcoll():  XSH4.2

  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.

  [Tru64 UNIX]	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.

SEE ALSO
  Functions: setlocale(3), string(3), strcmp(3), strxfrm(3), wcscoll(3)

  Standards: standards(5)

Index for Section 3

Alphabetical listing for S

Top of page