strncmp, wcsncmp, _mbsncmp, _mbsncmp_l

Artikel
03/12/2013

Vergleichen Sie Zeichen von zwei Zeichenfolgen, unter Verwendung des aktuellen Gebietsschemas oder eines angegebenen Gebietsschemas.

Wichtig
_mbsncmp und _mbsncmp_l können in Anwendungen nicht verwendet werden, die in der Windows Runtime ausführen.Weitere Informationen finden Sie unter CRT-Funktionen unterstützt nicht mit /ZW.

int strncmp( const char *string1, const char *string2, size_t count ); int wcsncmp( const wchar_t *string1, const wchar_t *string2, size_t count ); int _mbsncmp( const unsigned char *string1, const unsigned char *string2, size_t count ); int _mbsncmp_l( const unsigned char *string1, const unsigned char *string2, size_t count, _locale_t locale );int _mbsnbcmp( const unsigned char *string1, const unsigned char *string2, size_t count );

Parameter

string1, string2
So vergleichen Zeichenfolgen.
count
Zahl Zeichen zu vergleichen.
locale
Zu verwendende Gebietsschema.

Rückgabewert

Der Rückgabewert gibt die Beziehung der Teilzeichenfolgen in string1 und von string2 wie folgt an.

Rückgabewert	Beschreibung
< 0	string1 Teilzeichenfolge kleiner als string2 Teilzeichenfolge
0	string1 Teilzeichenfolge identisch zu string2 Teilzeichenfolge
> 0	string1 Teilzeichenfolge größer als string2 Teilzeichenfolge

Auf einem Fehler gibt _mbsncmp_NLSCMPERROR zurück, der in STRING.H und in MBSTRING.H. definiert ist.

Hinweise

Die strncmp-Funktion vergleicht lexikografisch höchstens die ersten count Zeichen in string1 und in string2 und gibt einen Wert die Beziehung zwischen den Teilzeichenfolgen angibt.strncmp ist eine Groß-/Kleinschreibung Version von _strnicmp.wcsncmp und _mbsncmp wird die Groß-/Kleinschreibung beachtet Versionen von _wcsnicmp und von _mbsnicmp.

wcsncmp und _mbsncmp sind Breitzeich und Mehrbytezeichen-Versionen von strncmp.Die Argumente und der Rückgabewert von wcsncmp sind Breitzeichen-Zeichenfolgen; die von _mbsncmp sind Mehrbyte-Zeichenfolgen._mbsncmp erkennt Mehrbytezeichensequenzen entsprechend der Mehrbyte-Codepage und gibt _NLSCMPERROR auf einem Fehler zurück.

Außerdem _mbsncmp überprüft seine Parameter.Wenn string1 oder string2 ein NULL-Zeiger ist, wird der ungültige Parameterhandler aufgerufen, wie in Parametervalidierung beschrieben.Wenn die Ausführung zulässig ist, um fortzufahren, gibt _mbsncmp_NLSCMPERROR zurück und legt errno zu EINVAL fest.strncmp und wcsncmp überprüfen nicht ihre Parameter.Diese drei Funktionen verhalten sich andernfalls identisch.

Der Ausgabewert wird durch die Einstellung der LC_CTYPE Kategorieneinstellung des Gebietsschemas betroffen; setlocale finden Sie weitere Informationen.Die Versionen dieser Funktionen ohne das _l Suffix verwenden das aktuelle Gebietsschema für dieses Verhalten abhängig; die Versionen mit dem _l Suffix sind identisch, allerdings verwenden den Gebietsschemaparameter, der in stattdessen übergeben wird.Weitere Informationen finden Sie unter Gebietsschema.

Zuordnung generische Textroutinen

TCHAR.H-Routine	_UNICODE & _MBCS nicht definiert.	_MBCS definiert	_UNICODE definiert
_tcsnccmp	strncmp	_mbsncmp	wcsncmp
_tcsncmp	strncmp	_mbsnbcmp	wcsncmp
_tccmp	Zuordnungen zum Makro oder die Inlinefunktion	_mbsncmp	Zuordnungen zum Makro oder die Inlinefunktion
nicht verfügbar	nicht verfügbar	_mbsncmp_l	nicht verfügbar

Anforderungen

Routine	Erforderlicher Header
strncmp	<string.h>
wcsncmp	<string.h> oder <wchar.h>
_mbsncmp, _mbsncmp_l	<mbstring.h>

So zusätzlicher Kompatibilitätsinformation finden Sie unter Kompatibilität in der Einführung.

Beispiel

// crt_strncmp.c
#include <string.h>
#include <stdio.h>

char string1[] = "The quick brown dog jumps over the lazy fox";
char string2[] = "The QUICK brown fox jumps over the lazy dog";

int main( void )
{
   char tmp[20];
   int result;
   printf( "Compare strings:\n      %s\n      %s\n\n",
           string1, string2 );
   printf( "Function:   strncmp (first 10 characters only)\n" );
   result = strncmp( string1, string2 , 10 );
   if( result > 0 )
      strcpy_s( tmp, sizeof(tmp), "greater than" );
   else if( result < 0 )
      strcpy_s( tmp, sizeof(tmp), "less than" );
   else
      strcpy_s( tmp, sizeof(tmp), "equal to" );
   printf( "Result:      String 1 is %s string 2\n\n", tmp );
   printf( "Function:   strnicmp _strnicmp (first 10 characters only)\n" );
   result = _strnicmp( string1, string2, 10 );
   if( result > 0 )
      strcpy_s( tmp, sizeof(tmp), "greater than" );
   else if( result < 0 )
      strcpy_s( tmp, sizeof(tmp), "less than" );
   else
      strcpy_s( tmp, sizeof(tmp), "equal to" );
   printf( "Result:      String 1 is %s string 2\n", tmp );
}