比较字符串。

重要

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

语法

int strcmp(
   const char *string1,
   const char *string2
);
int wcscmp(
   const wchar_t *string1,
   const wchar_t *string2
);
int _mbscmp(
   const unsigned char *string1,
   const unsigned char *string2
);
int _mbscmp_l(
   const unsigned char *string1,
   const unsigned char *string2,
   _locale_t locale
);

参数

%>
要比较的 null 终止的字符串。

locale
要使用的区域设置。

返回值

这些函数的返回值指明 string1string2 的序号关系。

string1string2 的关系
< 0 string1 小于 string2
0 string1 等于 string2
> 0 string1 大于 string2

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

注解

strcmp 函数对 string1string2 执行序号比较并返回一个指示它们关系的值。 wcscmp_mbscmp 分别是 strcmp 的宽字符和多字节字符版本。 _mbscmp 根据当前的多字节代码页识别多字节字符序列,并在发生错误时返回 _NLSCMPERROR_mbscmp_l 具有相同的行为,但使用传入的区域设置参数,而不是当前区域设置。 有关详细信息,请参阅代码页。 同样,如果 string1string2 为空指针,则 _mbscmp 将调用无效参数处理程序,如参数验证中所述。 如果允许继续执行,则 _mbscmp_mbscmp_l 返回 _NLSCMPERROR,并将 errno 设置为 EINVALstrcmpwcscmp 不会验证其参数。 否则这些函数具有相同行为。

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

一般文本例程映射

TCHAR.H 例程 _UNICODE_MBCS 未定义 _MBCS 已定义 _UNICODE 已定义
_tcscmp strcmp _mbscmp wcscmp

strcmp 函数与 strcoll 的不同之处在于 strcmp 比较是按顺序进行的且不受区域设置影响。 strcoll 通过使用当前区域设置的 LC_COLLATE 类别以字典顺序来比较字符串。 有关 LC_COLLATE 类别的详细信息,请参阅 setlocale_wsetlocale

在“C”区域设置中,字符集 (ASCII 字符集) 中的字符顺序与字典中的字符顺序一样。 但是在其他区域设置中,字符集中的字符顺序可能与字典中的顺序不同。 例如,在某些欧洲区域设置中,字符集中的字符“a”(值 0x61)位于字符“ä”(值 0xE4)之前,但在字典顺序中,字符“ä”位于字符“a”之前。

在字符集和字典字符顺序不同的区域设置中,可以使用 strcoll(而非 strcmp)来对字符串进行字典顺序的比较。 或者,也可以对原始字符串使用 strxfrm,然后对结果字符串使用 strcmp

strcmp 函数区分大小写。 _stricmp_wcsicmp_mbsicmp 在比较字符串之前会首先将它们转换成小写形式。 包含 ASCII 表中“Z”和“a”之间的字符(“[”、“\\”、“]”、“^”、“_”和“`”)的两个字符串,将会有不同的比较方式,这要取决于它们的大小写形式。 例如,如果比较采用小写形式,则“ABCDE”和“ABCD^”这两个字符串件将以一种方式进行比较(“abcde”>“abcd^”),而如果比较采用大写形式,则将采用另一种方式进行比较 (“ABCDE”<“ABCD”)。

要求

例程 必需的标头
strcmp <string.h>
wcscmp <string.h><wchar.h>
_mbscmp <mbstring.h>

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

C 运行时库的所有版本。

示例

// crt_strcmp.c

#include <string.h>
#include <stdio.h>
#include <stdlib.h>

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

int main( void )
{
   char tmp[20];
   int result;

   // Case sensitive
   printf( "Compare strings:\n   %s\n   %s\n\n", string1, string2 );
   result = strcmp( string1, string2 );
   if( result > 0 )
      strcpy_s( tmp, _countof(tmp), "greater than" );
   else if( result < 0 )
      strcpy_s( tmp, _countof (tmp), "less than" );
   else
      strcpy_s( tmp, _countof (tmp), "equal to" );
   printf( "   strcmp:   String 1 is %s string 2\n", tmp );

   // Case insensitive (could use equivalent _stricmp)
   result = _stricmp( string1, string2 );
   if( result > 0 )
      strcpy_s( tmp, _countof (tmp), "greater than" );
   else if( result < 0 )
      strcpy_s( tmp, _countof (tmp), "less than" );
   else
      strcpy_s( tmp, _countof (tmp), "equal to" );
   printf( "   _stricmp:  String 1 is %s string 2\n", tmp );
}
Compare strings:
   The quick brown dog jumps over the lazy fox
   The QUICK brown dog jumps over the lazy fox

   strcmp:   String 1 is greater than string 2
   _stricmp:  String 1 is equal to string 2

另请参阅

字符串操作
%>
%>
strcoll 函数