strcmp

比较字符串。

重要

_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

要使用的区域设置。

返回值

这些函数的返回值指明 string1 和 string2 的序号关系。

值string1 和 string2 的关系

< 0

string1 小于 string2。

string1 等于 string2

> 0

string1 大于 string2

参数验证错误时，_mbscmp 和 _mbscmp_l 返回 _NLSCMPERROR，该返回值是在 和 中定义的。

注解

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

默认情况下，此函数的全局状态范围限定为应用程序。 若要更改此行为，请参阅 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”

%>

strcoll 函数