strcmp

 

C

Compiler-Unterstützung

Sprache

Header

Typunterstützung

Programm-Dienstprogramme

Unterstützung für variable Funktionsargumente

Fehlerbehandlung

Dynamische Speicherverwaltung

Bibliothek für Zeichenketten

Algorithmen

Numerik

Datums- und Zeitdienstprogramme

Ein-/Ausgabeunterstützung

Lokalisierungsunterstützung

Unterstützung für Nebenläufigkeit (C11)

Technische Spezifikationen

Symbolindex

 

Bibliothek für Zeichenketten

Null-terminierte Byte-Strings

Null-terminierte Multibyte-Strings

Null-terminierte breite Zeichenketten

 

Null-terminierte Byte-Strings

Funktionen
Zeichenmanipulation
isalnum isalpha islower isupper isdigit isxdigit isblank (C99)	iscntrl isgraph isspace isprint ispunct tolower toupper
Konvertierungen zu und von numerischen Formaten
atoiatolatoll (C99) atof strtolstrtoll (C99) strtoulstrtoull (C99)	strtoimaxstrtouimax (C99)(C99) strtofstrtodstrtold (C99)(C99) strfromfstrfromdstrfroml (C23)(C23)(C23)
Stringmanipulation
strcpystrcpy_s (C11) strncpystrncpy_s (C11) strcatstrcat_s (C11)	strncatstrncat_s (C11) strxfrm strdup (C23) strndup (C23)
Stringuntersuchung
strlenstrnlen_s (C11) strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtokstrtok_s (C11)
Speichermanipulation
memchr memcmp memsetmemset_explicitmemset_s (C23)(C11)	memcpymemcpy_s (C11) memmovememmove_s (C11) memccpy (C23)
Sonstiges
strerrorstrerror_sstrerrorlen_s (C11)(C11)

 

Definiert in Header <string.h>
int strcmp( const char* lhs, const char* rhs );

Vergleicht zwei nullterminierte Byte-Strings lexikographisch.

Das Vorzeichen des Ergebnisses ist das Vorzeichen der Differenz zwischen den Werten des ersten Paares von Zeichen (beide interpretiert als unsigned char), die sich in den verglichenen Strings unterscheiden.

Das Verhalten ist undefiniert, wenn lhs oder rhs keine Zeiger auf nullterminierte Byte-Strings sind.

Parameter

lhs, rhs

-

Zeiger auf die zu vergleichenden nullterminierten Byte-Strings

Rückgabewert

Negativer Wert, wenn lhs lexikographisch vor rhs kommt.

Null, wenn lhs und rhs gleich sind.

Positiver Wert, wenn lhs lexikographisch nach rhs kommt.

Hinweise

Diese Funktion ist nicht gebietssensitiv (locale-sensitive), im Gegensatz zu strcoll und strxfrm.

Beispiel

Führen Sie diesen Code aus

#include <stdio.h>
#include <string.h>
 
void demo(const char* lhs, const char* rhs)
{
    const int rc = strcmp(lhs, rhs);
    const char* rel = rc < 0 ? "precedes" : rc > 0 ? "follows" : "equals";
    printf("[%s] %s [%s]\n", lhs, rel, rhs);
}
 
int main(void)
{
    const char* string = "Hello World!";
    demo(string, "Hello!");
    demo(string, "Hello");
    demo(string, "Hello there");
    demo("Hello, everybody!" + 12, "Hello, somebody!" + 11);
}

Ausgabe

[Hello World!] precedes [Hello!]
[Hello World!] follows [Hello]
[Hello World!] precedes [Hello there]
[body!] equals [body!]

Referenzen

• C23-Standard (ISO/IEC 9899:2024)

• 7.24.4.2 Die Funktion strcmp (S. TBD)

• C17-Standard (ISO/IEC 9899:2018)

• 7.24.4.2 Die Funktion strcmp (S. TBD)

• C11-Standard (ISO/IEC 9899:2011)

• 7.24.4.2 Die Funktion strcmp (S. 365-366)

• C99-Standard (ISO/IEC 9899:1999)

• 7.21.4.2 Die Funktion strcmp (S. 328-329)

• C89/C90-Standard (ISO/IEC 9899:1990)

• 4.11.4.2 Die Funktion strcmp

Siehe auch

strncmp	vergleicht eine bestimmte Anzahl von Zeichen zweier Strings (Funktion)
wcscmp (C95)	vergleicht zwei breite Zeichenketten (Funktion)
memcmp	vergleicht zwei Puffer (Funktion)
strcoll	vergleicht zwei Strings gemäß der aktuellen Locale (Funktion)
C++ Dokumentation für strcmp