GENWiki

Premier IT Outsourcing and Support Services within the UK

User Tools

Site Tools


man:strcasecmp

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  histori-
     cal compatibility, the glibc <string.h> header file also declares these
     functions, if the _DEFAULT_SOURCE  (or,  in  glibc  2.19  and  earlier,
     _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 per-
            formed.  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.16 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)
/data/webs/external/dokuwiki/data/pages/man/strcasecmp.txt · Last modified: 2019/05/17 09:47 by 127.0.0.1

Was this page helpful?-10+1

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki