strcasecmp(3)strcasecmp(3)NAME
strcasecmp, strncasecmp - Perform case-insensitive string comparisons
SYNOPSIS
#include <strings.h>
int strcasecmp(
const char *s1,
const char *s2 ); int strncasecmp(
const char *s1,
const char *s2,
size_t n );
LIBRARY
Standard C Library (libc)
STANDARDS
Interfaces documented on this reference page conform to industry stan‐
dards 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 str‐
casecmp 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 interna‐
tionalized 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 inte‐
ger 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 (possibly
null-terminated).
SEE ALSO
Functions: string(3), strcat(3), strcmp(3), strcpy(3)
Standards: standards(5)strcasecmp(3)