mirror of
https://codeberg.org/kiss-community/repo
synced 2024-12-23 07:40:11 -07:00
45 lines
1.4 KiB
Groff
45 lines
1.4 KiB
Groff
.\" generated by cd2nroff 0.1 from curl_strnequal.md
|
|
.TH curl_strnequal 3 "2024-08-02" libcurl
|
|
.SH NAME
|
|
curl_strnequal \- compare two strings ignoring case
|
|
.SH SYNOPSIS
|
|
.nf
|
|
#include <curl/curl.h>
|
|
|
|
int curl_strnequal(const char *str1, const char *str2, size_t length);
|
|
.fi
|
|
.SH DESCRIPTION
|
|
The \fIcurl_strnequal(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 compares no more than the first \fIlength\fP bytes of \fIstr1\fP and
|
|
\fIstr2\fP.
|
|
|
|
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_strnequal(name, argv[1], 5))
|
|
printf("Name and input matches in the 5 first bytes\\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_strequal (3),
|
|
.BR strcasecmp (3),
|
|
.BR strcmp (3)
|