| 9487f7f | 2011-08-03 07:05:30 -0700 | [diff] [blame] | 1 | .\" |
| 2 | .TH curl_strequal 3 "30 April 2004" "libcurl 7.12" "libcurl Manual" |
| 3 | .SH NAME |
| 4 | curl_strequal, curl_strnequal - case insensitive string comparisons |
| 5 | .SH SYNOPSIS |
| 6 | .B #include <curl/curl.h> |
| 7 | .sp |
| 8 | .BI "int curl_strequal(char *" str1 ", char *" str2 ");" |
| 9 | .sp |
| 10 | .BI "int curl_strenqual(char *" str1 ", char *" str2 ", size_t " len ");" |
| 11 | .SH DESCRIPTION |
| 12 | The |
| 13 | .B curl_strequal() |
| 14 | function compares the two strings \fIstr1\fP and \fIstr2\fP, ignoring the case |
| 15 | of the characters. It returns a non-zero (TRUE) integer if the strings are |
| 16 | identical. |
| 17 | .sp |
| 18 | The \fBcurl_strnequal()\fP function is similar, except it only compares the |
| 19 | first \fIlen\fP characters of \fIstr1\fP. |
| 20 | .sp |
| 21 | These functions are provided by libcurl to enable applications to compare |
| 22 | strings in a truly portable manner. There are no standard portable case |
| 23 | insensitive string comparison functions. These two work on all platforms. |
| 24 | .SH AVAILABILITY |
| 25 | These functions will be removed from the public libcurl API in a near |
| 26 | future. They will instead be made "available" by source code access only, and |
| 27 | then as curlx_strequal() and curlx_strenqual(). |
| 28 | .SH RETURN VALUE |
| 29 | Non-zero if the strings are identical. Zero if they're not. |
| 30 | .SH "SEE ALSO" |
| 31 | .BR strcmp "(3), " strcasecmp "(3)" |