STRCASECMP(3) BSD Library Functions Manual STRCASECMP(3)
NAME
strcasecmp, strncasecmp, strcasecmpl, strncasecmpl -- compare strings,
ignoring case
LIBRARY
Standard C Library (libc, -lc)
SYNOPSIS
##include <>
int
strcasecmp(const char *s1, const char *s2);
int
strncasecmp(const char *s1, const char *s2, sizet len);
##include <>
int
strcasecmpl(const char *s1, const char *s2, localet loc);
int
strncasecmpl(const char *s1, const char *s2, sizet len, localet loc);
DESCRIPTION
The strcasecmp() and strncasecmp() functions compare the null-terminated
strings s1 and s2.
The strncasecmp() compares at most len characters.
While the strcasecmp() and strncasecmp() functions use the current
locale, the strcasecmpl() and strncasecmpl() functions may be passed
locales directly. See xlocale(3) for more information.
RETURN VALUES
The strcasecmp() and strncasecmp() return an integer greater than, equal
to, or less than 0, according as s1 is lexicographically greater than,
equal to, or less than s2 after translation of each corresponding charac-
ter to lower-case. The strings themselves are not modified. The compar-
ison is done using unsigned characters, so that `\200' is greater than
`\0'.
SEE ALSO
bcmp(3), memcmp(3), strcmp(3), strcoll(3), strxfrm(3), tolower(3),
xlocale(3)
HISTORY
The strcasecmp() and strncasecmp() functions first appeared in 4.4BSD.
Their prototypes existed previously in before they were moved
to for IE Std 1003.1-2001 (``POSIX.1'') compliance.
BSD June 9, 1993 BSD
|