xref: /csrg-svn/lib/libc/string/strcoll.3 (revision 61193)
1*61193Sbostic.\" Copyright (c) 1990, 1991, 1993
2*61193Sbostic.\"	The Regents of the University of California.  All rights reserved.
341970Sbostic.\"
441970Sbostic.\" This code is derived from software contributed to Berkeley by
550322Sbostic.\" Chris Torek and the American National Standards Committee X3,
650322Sbostic.\" on Information Processing Systems.
750322Sbostic.\"
841970Sbostic.\" %sccs.include.redist.man%
941970Sbostic.\"
10*61193Sbostic.\"     @(#)strcoll.3	8.1 (Berkeley) 06/04/93
1141970Sbostic.\"
1248351Scael.Dd
1348351Scael.Dt STRCOLL 3
1448351Scael.Os
1548351Scael.Sh NAME
1648351Scael.Nm strcoll
1748351Scael.Nd compare strings according to current collation
1848351Scael.Sh SYNOPSIS
1948351Scael.Fd #include <string.h>
2048351Scael.Ft int
2148351Scael.Fn strcoll "const char *s1" "const char *s2"
2248351Scael.Sh DESCRIPTION
2348351ScaelThe
2448351Scael.Fn strcoll
2548351Scaelfunction
2648351Scaellexicographically compares the null-terminated strings
2748351Scael.Fa s1
2841970Sbosticand
2948351Scael.Fa s2
3041970Sbosticaccording to the current locale collation
3141970Sbosticand returns an integer greater than, equal to, or less than 0,
3241970Sbosticaccording as
3348351Scael.Fa s1
3448351Scaelis greater than, equal to, or less than
3548351Scael.Fa s2 .
3648351Scael.Sh SEE ALSO
3748351Scael.Xr bcmp 3 ,
3848351Scael.Xr memcmp 3 ,
3948351Scael.Xr setlocale 3 ,
4048351Scael.Xr strcasecmp 3 ,
4148351Scael.Xr strcmp 3 ,
4248351Scael.Xr strxfrm 3
4348351Scael.Sh STANDARDS
4448351ScaelThe
4548351Scael.Fn strcoll
4648351Scaelfunction
4748351Scaelconforms to
4848351Scael.St -ansiC .
49