C 参考手册
- C 语言
- C 关键词
- 预处理器
- C 标准库头文件
- 类型支持
- 程序支持工具
- 变参数函数
- 错误处理
- 动态内存管理
- 日期和时间工具
- 字符串库
- 空终止字节字符串
- isalpha
- islower
- isalnum
- strcpy, strcpy_s
- isupper
- isdigit
- isxdigit
- isblank
- iscntrl
- isgraph
- isspace
- isprint
- ispunct
- tolower
- toupper
- atof
- atoi, atol, atoll
- strtol, strtoll
- strtoul, strtoull
- strtof, strtod, strtold
- strtoimax, strtoumax
- strncpy, strncpy_s
- strcat, strcat_s
- strncat, strncat_s
- strxfrm
- strlen, strnlen_s
- strcmp
- strncmp
- strcoll
- strchr
- strrchr
- strspn
- strcspn
- strpbrk
- strstr
- strtok, strtok_s
- memchr
- memcmp
- memset, memset_s
- memcpy, memcpy_s
- memmove, memmove_s
- strerror, strerror_s, strerrorlen_s
- 空终止多字节字符串
- 空终止宽字符串
- 算法
- 数值
- 文件输入/输出
- 本地化支持
- 原子操作库
- 线程支持库
- 实验性 C 标准库
- 有用的资源
- 符号索引
- 注释
strncmp
定义于头文件 <string.h>
|
||
int strncmp( const char *lhs, const char *rhs, size_t count ); |
||
比较二个可能空终止的数组的至多 count
个字符。按字典序进行比较。不比较后随空字符的字符。
结果的符号是被比较的数组中首对字符(都转译成 unsigned char )的值间的差的符号。
若出现越过 lhs
或 rhs
结尾的访问,则行为未定义。若 lhs
或 rhs
为空指针,则行为未定义。
参数
lhs, rhs | - | 指向要比较的可能空终止的数组的指针 |
count | - | 要比较的最大字符数 |
返回值
若字典序中 lhs
先出现于 rhs
则为负值。
若 lhs
与 rhs
比较相等,或若 count 为零,则为零。
若字典序中 lhs
后出现于 rhs
则为正值。
注解
不同于 strcoll 和 strxfrm ,此函数不考虑本地环境。
示例
运行此代码
#include <string.h> #include <stdio.h> void demo(const char* lhs, const char* rhs, int sz) { int rc = strncmp(lhs, rhs, sz); if(rc == 0) printf("First %d chars of [%s] equal [%s]\n", sz, lhs, rhs); else if(rc < 0) printf("First %d chars of [%s] precede [%s]\n", sz, lhs, rhs); else if(rc > 0) printf("First %d chars of [%s] follow [%s]\n", sz, lhs, rhs); } int main(void) { const char* string = "Hello World!"; demo(string, "Hello!", 5); demo(string, "Hello", 10); demo(string, "Hello there", 10); demo("Hello, everybody!" + 12, "Hello, somebody!" + 11, 5); }
输出:
First 5 chars of [Hello World!] equal [Hello!] First 10 chars of [Hello World!] follow [Hello] First 10 chars of [Hello World!] precede [Hello there] First 5 chars of [body!] equal [body!]
引用
- C11 standard (ISO/IEC 9899:2011):
- 7.24.4.4 The strncmp function (p: 366)