2
0
mirror of https://codeberg.org/kiss-community/repo synced 2024-11-19 21:20:07 -07:00
repo/core/curl/files/curl_strnequal.3
2024-03-30 13:28:04 -05:00

43 lines
1.3 KiB
Groff

.\" generated by cd2nroff 0.1 from curl_strnequal.md
.TH curl_strequal 3 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)