curl_strnequal(3) Introduction to Library Functions curl_strnequal(3)
NAME
curl_strnequal - compare two strings ignoring case
SYNOPSIS
#include <curl/curl.h>
int curl_strnequal(const char *str1, const char *str2, size_t length);
DESCRIPTION
The
curl_strnequal(3) function compares the two strings
str1 and
str2, ignoring the case of the characters. It returns a non-zero
(TRUE) integer if the strings are identical.
This function compares no more than the first
length bytes of
str1 and
str2.
This function uses plain ASCII based comparisons completely
disregarding the locale - contrary to how
strcasecmp 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.
PROTOCOLS
This functionality affects all supported protocols
EXAMPLE
int main(int argc, char **argv)
{
const char *name = "compare";
if(curl_strnequal(name, argv[1], 5))
printf("Name and input matches in the 5 first bytes\n");
}
AVAILABILITY
Added in curl 7.1
RETURN VALUE
Non-zero if the strings are identical. Zero if they are not.
SEE ALSO
curl_strequal(3),
strcasecmp(3),
strcmp(3)libcurl 2025-02-25 curl_strnequal(3)