CKTIS / C
wcsncmp — begrenzter Vergleich weiter Zeichen
wcsncmp vergleicht höchstens n wchar_t-Elemente. Das Ergebnis beschreibt die Reihenfolge oder Gleichheit des verglichenen Abschnitts, nicht unbedingt die der gesamten Zeichenketten.
Version: C23; repository compiler flag, production runtime not attested
Syntax
#include <wchar.h>
int wcsncmp(const wchar_t *s1, const wchar_t *s2, size_t n);wcsncmp, deklariert in <wchar.h>, vergleicht höchstens n weite Zeichen. Zeichen nach L'\0' werden nicht verglichen. Das erste Paar unterschiedlicher Zeichen im Vergleich bestimmt das Vorzeichen des Ergebnisses, aber C garantiert nicht, dass die Implementierung an dieser Stelle aufhört zu lesen. Die Grenze zählt wchar_t-Elemente, keine Bytes.
Ein negatives, null oder positives Ergebnis bedeutet, dass der verglichene Abschnitt entsprechend kleiner, gleich oder größer ist. Prüfe das Vorzeichen, nicht die exakten Werte -1 oder 1. Die Reihenfolge richtet sich nach den Zeichenwerten, nicht nach sprachspezifischen Sortierregeln des Gebietsschemas.
Bei n == 0 ist das Ergebnis null; übergib trotzdem gültige Zeiger. Jedes Array muss mindestens n Elemente bereitstellen oder unter seinen verfügbaren Elementen ein L'\0' als Abschlusszeichen enthalten. Verlass dich bei einem kürzeren Array ohne Abschlusszeichen nicht auf einen früheren Unterschied. Gleiche Präfixe beweisen nicht, dass die gesamten Zeichenketten gleich sind.
Beispiele
#include <stdio.h>
#include <wchar.h>
int main(void)
{
const wchar_t a[] = L"cat";
const wchar_t b[] = L"car";
printf("prefix_equal=%d\n", wcsncmp(a, b, 2) == 0);
printf("whole_equal=%d\n", wcsncmp(a, b, 3) == 0);
printf("zero_equal=%d\n", wcsncmp(a, b, 0) == 0);
return 0;
}Ergebnis
prefix_equal=1 whole_equal=0 zero_equal=1
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.