strcmpi
Nach oben zu string.h - Index
Header-Datei
string.h, wchar.h
Kategorie
Routinen für Speicher- und String-Bearbeitung
Prototyp
int strcmpi(const char *s1, const char *s2);
int _wcscmpi(const wchar_t *s1, const wchar_t *s2);
Beschreibung
Vergleicht einen String mit einem anderen, ohne die Groß-/Kleinschreibung zu berücksichtigen.
strcmpi vergleicht s1 mit s2, ohne Vorzeichen zu beachten und ohne die Groß-/Kleinschreibung zu berücksichtigen (wie die als Makro implementierte Routine stricmp).
strcmpi gibt einen auf dem Ergebnis des Vergleichs von s1 (oder eines Teils davon) mit s2 (oder eines Teils davon) basierenden Integerwert (< 0, 0 oder > 0) zurück.
Die Routine strcmpi ist die gleiche wie stricmp. strcmpi ist als Makro in string.h implementiert, das Aufrufe von strcmpi in Aufrufe von stricmp übersetzt. Wenn Sie also strcmpi verwenden wollen, müssen Sie die Header-Datei string.h einbinden, damit das Makro verfügbar ist. Dieses Makro wird aus Gründen der Kompatibilität mit anderen C-Compilern bereitgestellt.
Rückgabewert
kleiner als s2 |
< 0 |
s1 entspricht s2 |
== 0 |
größer als s2 |
> 0 |
Beispiel
/* strncmpi-Beispiel */
#include <string.h>
#include <stdio.h>
int main(void)
{
char *buf1 = "BBB", *buf2 = "bbb";
int ptr;
ptr = strcmpi(buf2, buf1);
if (ptr > 0)
printf("buffer 2 is greater than buffer 1\n");
if (ptr < 0)
printf("buffer 2 is less than buffer 1\n");
if (ptr == 0)
printf("buffer 2 equals buffer 1\n");
return 0;
}
Portabilität
POSIX | Win32 | ANSI C | ANSI C++ | |
---|---|---|---|---|
strcmpi |
+ |
|||
_wcscmpi |
+ |