strcmp， wcscmp， _mbscmp

项目
04/10/2013

比较字符串。

重要事项
_mbscmp 不能在 Windows 运行时执行的应用程序。有关更多信息，请参见 CRT 函数不支持与 /ZW。

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

参数

string1, string2
比较的 null 终止的字符串。

返回值

这些功能中的返回值指示 string1 的字典关系。string2。

值	string1 关系 string2
< 0	string1 比 string2小于
0	string1 与 string2相同
> 0	string1大于string2。

在错误，_mbscmp 返回 _NLSCMPERROR，在 STRING.H 和 MBSTRING.H. 定义。

备注

strcmp 功能字典地比较 string1 和 string2 并返回指示它们之间的关系的值。wcscmp 和 _mbscmp 分别为，strcmp的，宽字符和多字节字符版本。_mbscmp 根据当前多字节代码页识别多字节字符序列并返回该错误的 _NLSCMPERROR。有关更多信息，请参见代码页。此外，如果 string1 或 string2 是 null 指针，_mbscmp 调用无效参数处理程序，如参数验证所述。如果执行允许继续，_mbscmp 返回 _NLSCMPERROR 并将 errno 到 EINVAL。strcmp 和 wcscmp 不验证方法的参数。这三个功能否则具有相同的行为。

一般文本例程映射

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 为字符串字典比较基于 LC_COLLATE 类别以当前区域设置。若要执行区域设置创建一个字典比较上面的示例，请使用 strcoll 而不是 strcmp。或者，可以使用原始字符串的 strxfrm，然后使用在结果字符串的 strcmp。

_stricmp、_wcsicmp和 _mbsicmp 通过首先将它们比较字符串转换为它们的小写形式。两个包含字符" Z”和" a "之间”位于 ASCII 表的字符串 (“[”，'\'，“]”，'^'、'_'和 '`') 基于它们的大小写不同地比较。例如，两个字符串 "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 );
}