mirror of
https://github.com/curl/curl.git
synced 2025-01-24 14:15:18 +08:00
582429ed47
Previously this was one single manpage for two functions but as they are
two separate ones since a while back, they should each clearly document
their single specific functions.
Follow-up to eefcc1bda4
Closes #14068
59 lines
1.2 KiB
Markdown
59 lines
1.2 KiB
Markdown
---
|
|
c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
|
SPDX-License-Identifier: curl
|
|
Title: curl_strequal
|
|
Section: 3
|
|
Source: libcurl
|
|
See-also:
|
|
- curl_strnequal (3)
|
|
- strcasecmp (3)
|
|
- strcmp (3)
|
|
Protocol:
|
|
- All
|
|
---
|
|
|
|
# NAME
|
|
|
|
curl_strequal - compare two strings ignoring case
|
|
|
|
# SYNOPSIS
|
|
|
|
~~~c
|
|
#include <curl/curl.h>
|
|
|
|
int curl_strequal(const char *str1, const char *str2);
|
|
~~~
|
|
|
|
# DESCRIPTION
|
|
|
|
The curl_strequal(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 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.
|
|
|
|
# EXAMPLE
|
|
|
|
~~~c
|
|
int main(int argc, char **argv)
|
|
{
|
|
const char *name = "compare";
|
|
if(curl_strequal(name, argv[1]))
|
|
printf("Name and input matches\n");
|
|
}
|
|
~~~
|
|
|
|
# AVAILABILITY
|
|
|
|
Always
|
|
|
|
# RETURN VALUE
|
|
|
|
Non-zero if the strings are identical. Zero if they are not.
|