Content-type: text/html Man page of strcoll

strcoll

Section: C Library Functions (3)
Index Return to Main Contents
 

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

Specifies first string to be compared. 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: 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) delim off


 

Index

NAME
LIBRARY
SYNOPSIS
STANDARDS
PARAMETERS
DESCRIPTION
RETURN VALUES
ERRORS
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:41:35 GMT, October 02, 2010