strnicmp, _mbsnicmp, _wcsnicmp
Nach oben zu string.h - Index
Header-Datei
string.h, mbstring.h
Kategorie
Routinen für Speicher- und String-Bearbeitung
Prototyp
int strnicmp(const char *s1, const char *s2, size_t maxlen);
int _wcsnicmp(const wchar_t *s1, const wchar_t *s2, size_t maxlen);
int _mbsnicmp(const unsigned char *s1, const unsigned char *s2, size_t maxlen);
Beschreibung
Vergleicht einen Teil eines String mit einem Teil eines anderen, ohne die Groß-/Kleinschreibung zu berücksichtigen.
strnicmp vergleicht, unter Berücksichtigung des Vorzeichens, maximal maxlen Bytes von s1 mit s2. Der Vergleich beginnt mit dem ersten Zeichen eines jeden Strings und wird mit den folgenden Zeichen fortgesetzt, bis sich die jeweiligen Zeichen unterscheiden oder das Ende der Strings erreicht wird. Im Vergleich wird die Groß-/Kleinschreibung nicht berücksichtigt.
strnicmp 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.
Rückgabewert
kleiner als s2 |
< 0 |
s1 entspricht s2 |
== 0 |
größer als s2 |
> 0 |
Beispiel
#include <string.h>
#include <stdio.h>
int main(void)
{
char *buf1 = "BBBccc", *buf2 = "bbbccc";
int ptr;
ptr = strnicmp(buf2, buf1, 3);
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++ | |
---|---|---|---|---|
strnicmp |
+ |
|||
_mbsnicmp |
+ |
|||
_wcsnicmp |
+ |