strcmp

 

C

编译器支持

语言

头文件

类型支持

程序实用程序

可变参数函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间实用程序

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

字符串库

字节字符串

多字节字符串

宽字符串

 

以空字符结尾的字节字符串

函数
字符操作
isalnum isalpha islower isupper isdigit isxdigit isblank (C99)	iscntrl isgraph isspace isprint ispunct tolower toupper
转换为和从数值格式转换
atoiatolatoll (C99) atof strtolstrtoll (C99) strtoulstrtoull (C99)	strtoimaxstrtoumax (C99)(C99) strtofstrtodstrtold (C99)(C99) strfromfstrfromdstrfroml (C23)(C23)(C23)
字符串操作
strcpystrcpy_s (C11) strncpystrncpy_s (C11) strcatstrcat_s (C11)	strncatstrncat_s (C11) strxfrm strdup (C23) strndup (C23)
字符串检查
strlenstrnlen_s (C11) strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtokstrtok_s (C11)
内存操作
memchr memcmp memsetmemset_explicitmemset_s (C23)(C11)	memcpymemcpy_s (C11) memmovememmove_s (C11) memccpy (C23)
其他
strerrorstrerror_sstrerrorlen_s (C11)(C11)

 

定义在头文件 <string.h> 中
int strcmp( const char* lhs, const char* rhs );

按字典序比较两个以空字符结尾的字节字符串。

结果的符号是比较字符串中第一个不同的字符对（均解释为 unsigned char）的值之差的符号。

如果 lhs 或 rhs 不是指向以空字符结尾的字节字符串的指针，则行为未定义。

参数

lhs, rhs

-

指向要比较的以空字符结尾的字节字符串的指针

返回值

如果 lhs 在字典序中出现在 rhs 之前，则为负值。

如果 lhs 和 rhs 相等，则为零。

如果 lhs 在字典序中出现在 rhs 之后，则为正值。

注意

此函数与 strcoll 和 strxfrm 不同，它不依赖于区域设置。

示例

运行此代码

#include <stdio.h>
#include <string.h>
 
void demo(const char* lhs, const char* rhs)
{
    const int rc = strcmp(lhs, rhs);
    const char* rel = rc < 0 ? "precedes" : rc > 0 ? "follows" : "equals";
    printf("[%s] %s [%s]\n", lhs, rel, rhs);
}
 
int main(void)
{
    const char* string = "Hello World!";
    demo(string, "Hello!");
    demo(string, "Hello");
    demo(string, "Hello there");
    demo("Hello, everybody!" + 12, "Hello, somebody!" + 11);
}

输出

[Hello World!] precedes [Hello!]
[Hello World!] follows [Hello]
[Hello World!] precedes [Hello there]
[body!] equals [body!]

参考

• C23 标准 (ISO/IEC 9899:2024)

• 7.24.4.2 strcmp 函数 (p: TBD)

• C17 标准 (ISO/IEC 9899:2018)

• 7.24.4.2 strcmp 函数 (p: TBD)

• C11 标准 (ISO/IEC 9899:2011)

• 7.24.4.2 strcmp 函数 (p: 365-366)

• C99 标准 (ISO/IEC 9899:1999)

• 7.21.4.2 strcmp 函数 (p: 328-329)

• C89/C90 标准 (ISO/IEC 9899:1990)

• 4.11.4.2 strcmp 函数

参见

strncmp	比较两个字符串的特定数量的字符 (函数)
wcscmp (C95)	比较两个宽字符串 (函数)
memcmp	比较两个缓冲区 (函数)
strcoll	根据当前区域设置比较两个字符串 (函数)
C++ 文档 for strcmp