strncmp, wcsncmp, _mbsncmp, _mbsncmp_l

  • 项目

比较高达两个字符串指定数量的字符。

重要

_mbsncmp 和 _mbsncmp_l 无法用于在 Windows 运行时中执行的应用程序。 有关详细信息，请参阅通用 Windows 平台应用中不支持的 CRT 函数。

语法

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

参数

string1，string2
要比较的字符串。

count
要比较的字符数。

locale
要使用的区域设置。

返回值

返回值指示 string1 和 string2 的子字符串之间关系，如下所示。

返回值 说明
< 0 string1 的子字符串小于 string2 的子字符串
0 string1 的子字符串等于 string2 的子字符串
> 0 string1 的子字符串大于 string2 的子字符串

参数验证错误时，_mbsncmp 和 _mbsncmp_l 返回 _NLSCMPERROR，该返回值是在 <string.h> 和 <mbstring.h> 中定义的。

备注

strncmp 函数对 count 和 string1 中最多前 string2 个字符执行序号比较，并返回一个指示子字符串之间关系的值。 strncmp 是 _strnicmp 的区分大小写版本。 wcsncmp 和 _mbsncmp 是 _wcsnicmp 和 _mbsnicmp 的一个区分大小写的版本。

wcsncmp 和 _mbsncmp 分别是 strncmp 的宽字符及多字节字符版本。 wcsncmp 的自变量是宽字符字符串。 _mbsncmp 的自变量是多字节字符字符串。 _mbsncmp 根据多字节代码页识别多字节字符序列，并在发生错误时返回 _NLSCMPERROR。

此外，_mbsncmp 和 _mbsncmp_l 验证参数。 如果 string1 或 string2 是空指针，且 count 不等于 0，则将调用无效的参数处理程序，如参数验证中所述。 如果允许继续执行，则 _mbsncmp 和 _mbsncmp_l 返回 _NLSCMPERROR，并将 errno 设置为 EINVAL。 strncmp 和 wcsncmp 不会验证其参数。 否则这些函数具有相同行为。

_mbsncmp 和 _mbsncmp_l 的比较行为受到区域设置的 LC_CTYPE 类别设置的设置影响。 这会控制对多字节字符的前导和尾随字节的检测。 有关详细信息，请参阅 setlocale。 _mbsncmp 函数对与区域设置相关的行为使用当前区域设置。 _mbsncmp_l 函数完全相同，只不过它转而使用 locale 参数。 有关详细信息，请参阅 Locale。 如果区域设置是单字节的，则这些函数的行为等同于 strncmp。

默认情况下，此函数的全局状态范围限定为应用程序。 若要更改此行为，请参阅 CRT 中的全局状态。

一般文本例程映射

TCHAR.H 例程 _UNICODE 和 _MBCS 未定义 _MBCS 已定义 _UNICODE 已定义
_tcsnccmp strncmp _mbsncmp wcsncmp
_tcsncmp strncmp _mbsnbcmp wcsncmp
_tccmp 映射到宏或内联函数 _mbsncmp 映射到宏或内联函数

要求

例程 必需的标头
strncmp <string.h>
wcsncmp <string.h> 或 <wchar.h>
_mbsncmp，_mbsncmp_l <mbstring.h>

有关兼容性的详细信息，请参阅 兼容性。

示例

// 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

另请参阅

字符串操作
区域设置
多字节字符序列的解释
_mbsnbcmp、_mbsnbcmp_l
_mbsnbicmp、_mbsnbicmp_l
strcmp、wcscmp、_mbscmp
strcoll 函数
_strnicmp、_wcsnicmp、_mbsnicmp、_strnicmp_l、_wcsnicmp_l、_mbsnicmp_l
strrchr、wcsrchr、_mbsrchr、_mbsrchr_l
_strset、_strset_l、_wcsset、_wcsset_l、_mbsset、_mbsset_l
strspn、wcsspn、_mbsspn、_mbsspn_l