repo/core/curl/files/curl_strequal.3

.\" generated by cd2nroff 0.1 from curl_strequal.md
.TH curl_strequal 3 "2024-11-09" libcurl
.SH NAME
curl_strequal \- compare two strings ignoring case
.SH SYNOPSIS
.nf
#include <curl/curl.h>

int curl_strequal(const char *str1, const char *str2);
.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.

This function uses plain ASCII based comparisons completely disregarding the
locale \- contrary to how \fBstrcasecmp\fP and other system case insensitive
string comparisons usually work.

This function is provided by libcurl to enable applications to compare strings
in a truly portable manner. There are no standard portable case insensitive
string comparison functions. This function works on all platforms.
.SH PROTOCOLS
This functionality affects all supported protocols
.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");
}
.fi
.SH AVAILABILITY
Added in curl 7.1
.SH RETURN VALUE
Non\-zero if the strings are identical. Zero if they are not.
.SH SEE ALSO
.BR curl_strnequal (3),
.BR strcasecmp (3),
.BR strcmp (3)