strncmp, wcsncmp, _mbsncmp, _mbsncmp_l

Artigo
08/25/2010

comparar os caracteres de duas seqüências de caracteres, usando a localidade corrente ou uma localidade específica.

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
);

Parâmetros

string1, string2
Cadeias de caracteres para comparar.
count
Número de caracteres para comparar.
locale
Localidade usar.

Valor de retorno

O valor retornado indica a relação de substrings de string1 e string2 sistema autônomo a seguir.

Valor de Retorno	Descrição
< 0	string1 substring menor que string2 substring
0	string1 idêntico a substring string2 substring
> 0	string1 subseqüência de caracteres maior que string2 substring

Em um erro, _mbsncmp Retorna _NLSCMPERROR, que é definido em STRING.H e MBSTRING.H.

Comentários

The strncmp função lexicograficamente compara, no máximo, o primeiro count caracteres em string1 e string2 e retorna um valor que indica a relação entre as subseqüências. strncmp é uma versão de distinção entre diferenciar diferenciar maiúsculas de minúsculas _strnicmp. wcsncmp e _mbsncmp são versões distinção entre diferenciar diferenciar maiúsculas de minúsculas _wcsnicmp e _mbsnicmp.

wcsncmp e _mbsncmpsão versões de caractere largo e caracteres de multibyte de strncmp. Os argumentos e o valor retornado do wcsncmp são caractere largos strings; as de _mbsncmp são seqüências de caractere de multibyte. _mbsncmp seqüências de caractere de multibyte de acordo com a uma página de código multibyte reconhece e retorna _NLSCMPERROR em um erro.

Além disso, _mbsncmp valida os parâmetros. If string1 or string2 is a null pointer,the invalid parameter handler is invoked, as described in Validação de parâmetro .Se a execução for permitida para continuar, _mbsncmp Retorna _NLSCMPERROR e conjuntos errno para EINVAL. strncmp e wcsncmp não validam seus parâmetros. Especifique estas três funções identicamente outro comportam.

O valor de saída é afetado pela configuração do LC_CTYPE categoria de configuração da localidade; consulte setlocale para obter mais informações.As versões dessas funções sem o _l sufixo use a localidade corrente para esse comportamento dependente de localidade; as versões com o _l sufixo são idênticas exceto que usarem o parâmetro de localidade passado em vez disso. For more information, see Localidade.

Mapeamentos de rotina de texto genérica

Rotina TCHAR.H	_UNICODE & _MBCS não definido	_MBCS definido	_UNICODE definido
_tcsnccmp	strncmp	_mbsnbcmp	wcsncmp
_tcsncmp	strncmp	_mbsnbcmp	wcsncmp
_tccmp	Mapas de macro ou função in-line	_mbsncmp	Mapas de macro ou função in-line
n/d	n/d	_mbsncmp_l	n/d

Requisitos

Rotina	Cabeçalho necessário
strncmp	<string.h>
wcsncmp	<string.h> ou <wchar.h>
_mbsncmp, _mbsncmp_l	<mbstring.h>

Para obter informações adicionais compatibilidade, consulte Compatibilidade na introdução.

Exemplo

// 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 );
}

Compare strings:       The quick brown dog jumps over the lazy fox       The QUICK brown fox jumps over the lazy dog  Function:   strncmp (first 10 characters only) Result:      String 1 is greater than string 2  Function:   strnicmp _strnicmp (first 10 characters only) Result:      String 1 is equal to string 2