_mbsnbicmp

Nach oben zu String.h - Index

Header-Datei

mbstring.h

Kategorie

Routinen für Speicher- und String-Bearbeitung

Prototyp

int _mbsnbicmp(const unsigned char *s1, const unsigned char s2, size_t maxlen);

Beschreibung

_mbsnbicmp vergleicht maximal maxlen Bytes von s1 mit s2 ohne Berücksichtigung der Groß-/Kleinschreibung. Der Vergleich beginnt mit dem ersten Byte jeden Strings und wird mit den folgenden Bytes fortgesetzt, bis sich die jeweiligen Bytes unterscheiden oder maxlen Bytes geprüft wurden.

_mbsnbicmp berücksichtigt die Groß-/Kleinschreibung nicht.

_mbsnbicmp arbeitet unabhängig vom aktuellen Gebietsschema.

_mbsnbicmp vergleicht die Bytes auf der Grundlage der aktuellen Multibyte-Codeseite.

Rückgabewert

• _mbsnbicmp gibt einen auf dem Ergebnis des Vergleichs von s1 (oder eines Teils davon ) mit s2 (oder eines Teils davon) basierenden Integerwert zurück:
• < 0, wenn s1 kleiner s2 ist
• == 0, wenn s1 gleich s2 ist
• > 0, wenn s1 größer s2 ist

Beispiel

 #include <mbstring.h>
 /* Diese Funktion wird in qsort zum Sortieren zweier String-Arrays verwendet */
 int qsort_func(char* left, char* right)
 {
   /* Länge der beiden Strings ermitteln */
   int left_len = strlen(left);
   int right_len = strlen(right);
 
   /* Die beiden Strings ohne Berücksichtigung der Groß-/Kleinschreibung und des Gebietsschemas vergleichen */
   return _mbsnbicmp(left, right, (left_len > right_len) ? right_len : left_len);
 }