strncasecmp_l(3) [mojave man page]

STRCASECMP(3)						   BSD Library Functions Manual 					     STRCASECMP(3)

NAME

     strcasecmp, strcasecmp_l, strncasecmp, strncasecmp_l -- 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 n);

     #include <strings.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, size_t n, locale_t loc);

DESCRIPTION

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

     The strncasecmp() compares at most n characters.

     Although the strcasecmp() and strncasecmp() functions use the current locale, the strcasecmp_l() and strncasecmp_l() 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 character to lower-case.  The strings themselves are not modified.
     The comparison is done using unsigned characters, so that '200' is greater than ''.

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 <string.h> before they were
     moved to <strings.h> for IEEE Std 1003.1-2001 (``POSIX.1'') compliance.

BSD
								   June 9, 1993 							       BSD

STRCASECMP(3)						     Linux Programmer's Manual						     STRCASECMP(3)

NAME

       strcasecmp, strncasecmp - compare two strings ignoring case

SYNOPSIS

       #include <strings.h>

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

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

DESCRIPTION

       The  strcasecmp() function performs a byte-by-byte comparison of the strings s1 and s2, ignoring the case of the characters.  It returns an
       integer less than, equal to, or greater than zero if s1 is found, respectively, to be less than, to match, or be greater than s2.

       The strncasecmp() function is similar, except that it compares no more than n bytes of s1 and s2.

RETURN VALUE

       The strcasecmp() and strncasecmp() functions return an integer less than, equal to, or greater than zero if s1  is,  after  ignoring  case,
       found to be less than, to match, or be greater than s2, respectively.

ATTRIBUTES

       For an explanation of the terms used in this section, see attributes(7).

       +----------------------------+---------------+----------------+
       |Interface		    | Attribute     | Value	     |
       +----------------------------+---------------+----------------+
       |strcasecmp(), strncasecmp() | Thread safety | MT-Safe locale |
       +----------------------------+---------------+----------------+
CONFORMING TO

       4.4BSD, POSIX.1-2001, POSIX.1-2008.

NOTES

       The  strcasecmp()  and strncasecmp() functions first appeared in 4.4BSD, where they were declared in <string.h>.  Thus, for reasons of his-
       torical compatibility, the glibc <string.h> header file also declares these functions, if the _DEFAULT_SOURCE (or, in glibc 2.19  and  ear-
       lier, _BSD_SOURCE) feature test macro is defined.

       The POSIX.1-2008 standard says of these functions:

	      When  the  LC_CTYPE  category  of the locale being used is from the POSIX locale, these functions shall behave as if the strings had
	      been converted to lowercase and then a byte comparison performed.  Otherwise, the results are unspecified.

SEE ALSO

       bcmp(3), memcmp(3), strcmp(3), strcoll(3), string(3), strncmp(3), wcscasecmp(3), wcsncasecmp(3)

COLOPHON

       This page is part of release 4.15 of the Linux man-pages project.  A description of the project, information about reporting bugs, and  the
       latest version of this page, can be found at https://www.kernel.org/doc/man-pages/.

								    2017-09-15							     STRCASECMP(3)