Content-type: text/html Man page of strcasecmp

strcasecmp

Section: C Library Functions (3)
Index Return to Main Contents
 

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 (possibly null-terminated).  

RELATED INFORMATION

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

Standards: standards(5) delim off


 

Index

NAME
LIBRARY
SYNOPSIS
STANDARDS
PARAMETERS
DESCRIPTION
RETURN VALUES
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:41:14 GMT, October 02, 2010