strncasecmp(3) [osf1 man page]

strcasecmp(3)						     Library Functions Manual						     strcasecmp(3)

NAME

       strcasecmp, strncasecmp - Perform case-insensitive string comparisons

LIBRARY

       Standard C Library (libc.so, libc.a)

SYNOPSIS

       #include <strings.h>

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

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

STANDARDS

       Interfaces documented on this reference page conform to industry standards as follows:

       strcasecmp(), strncasecmp():  XPG4-UNIX

       Refer to the standards(5) reference page for more information about industry standards and associated tags.

PARAMETERS

       Points to a location containing first string.  Points to a location containing the second of two strings referenced.  Specifies the maximum
       number of bytes to compare.

DESCRIPTION

       The strcasecmp() function compares the string pointed to by the s1 parameter to the string pointed to by the s2 parameter,  while  ignoring
       differences in case.  The strncasecmp() function is similar to the strcasecmp function, but also compares size.	If the size specified by n
       is reached before a null, the comparison stops.	Note that these functions work for 7-bit ASCII compares only and should  not  be  used	in
       internationalized applications.

RETURN VALUES

       Upon  completion,  the  strcasecmp() function returns an integer whose value is greater than, equal to, or less than 0 (zero), according to
       whether the s1 string, ignoring case, is greater than, equal to, or less than the s2 string.

       Upon successful completion, the strncasecmp() function returns an integer whose value is greater than, equal to, or  less  than	0  (zero),
       according  to whether the s1 array (possibly null-terminated), ignoring case, is greater than, equal to, or less than the s2 string (possi-
       bly null-terminated).

RELATED INFORMATION

       Functions: string(3), strcat(3), strcmp(3), strcpy(3)

       Standards: standards(5) delim off

																     strcasecmp(3)

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)