Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
STRCASECMP(3)          FreeBSD Library Functions Manual          STRCASECMP(3)

NAME
     strcasecmp, strncasecmp - compare strings, ignoring case

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     #include <strings.h>

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

     int
     strncasecmp(const char *s1, const char *s2, size_t len);

     #include <string.h>
     #include <xlocale.h>

     int
     strcasecmp_l(const char *s1, const char *s2, locale_t loc);

     int
     strncasecmp_l(const char *s1, const char *s2, site_t len, locale_t loc);

DESCRIPTION
     The strcasecmp() and strncasecmp() functions compare the null-terminated
     strings s1 and s2.

     The strncasecmp() function compares at most len characters.  The
     strcasecmp_l() and strncasecmp_l() functions do the same as their non-
     locale versions above, but take an explicit locale rather than using the
     current locale.

RETURN VALUES
     The functions strcasecmp() and strncasecmp() return an integer greater
     than, equal to, or less than 0, depending on whether s1 is
     lexicographically greater than, equal to, or less than s2 after
     translation of each corresponding character to lower-case.  The strings
     themselves are not modified.  The comparison is done using unsigned
     characters, so that `\200' is greater than `\0'.  The functions
     strcasecmp_l() and strncasecmp_l() do the same but take explicit locales.

SEE ALSO
     bcmp(3), memcmp(3), strcmp(3), strcoll(3), strxfrm(3), tolower(3),
     wcscasecmp(3)

HISTORY
     The strcasecmp() and strncasecmp() functions first appeared in 4.4BSD.
     Their prototypes existed previously in <string.h> before they were moved
     to <strings.h> for IEEE Std 1003.1-2001 (``POSIX.1'') compliance.

FreeBSD 11.0-PRERELEASE          June 9, 1993          FreeBSD 11.0-PRERELEASE

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | SEE ALSO | HISTORY

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=strcasecmp_l&sektion=3&manpath=FreeBSD+9.1-RELEASE>

home | help