.\" generated by cd2nroff 0.1 from curl_strequal.md
.TH curl_strequal 3 "2024-04-19" libcurl
.SH NAME
curl_strequal, curl_strnequal \- case insensitive string comparisons
.SH SYNOPSIS
.nf
#include <curl/curl.h>

int curl_strequal(const char *str1, const char *str2);
int curl_strnequal(const char *str1, const char *str2, size_t length);
.fi
.SH DESCRIPTION
The \fIcurl_strequal(3)\fP function compares the two strings \fIstr1\fP and
\fIstr2\fP, ignoring the case of the characters. It returns a non\-zero (TRUE)
integer if the strings are identical.

The \fBcurl_strnequal()\fP function is similar, except it only compares the
first \fIlength\fP characters of \fIstr1\fP.

These functions are provided by libcurl to enable applications to compare
strings in a truly portable manner. There are no standard portable case
insensitive string comparison functions. These two work on all platforms.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
int main(int argc, char **argv)
{
  const char *name = "compare";
  if(curl_strequal(name, argv[1]))
    printf("Name and input matches\\n");
  if(curl_strnequal(name, argv[1], 5))
    printf("Name and input matches in the 5 first bytes\\n");
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Non\-zero if the strings are identical. Zero if they are not.
.SH SEE ALSO
.BR strcasecmp (3),
.BR strcmp (3)