Index for Section 3

Alphabetical listing for S

Bottom of page

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 standards
  as follows:

  strcasecmp(), strncasecmp():	XPG4-UNIX

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

PARAMETERS
  s1  Points to a location containing first string.

  s2  Points to a location containing the second of two strings referenced.

  n   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).

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

  Standards: standards(5)

Index for Section 3

Alphabetical listing for S

Top of page