C++ 参考手册
- C++11
- C++14
- C++17
- C++20
- C++ 编译器支持情况表
- 独立与宿主实现
- C++ 语言
- C++ 关键词
- 预处理器
- C++ 标准库头文件
- 具名要求
- 功能特性测试 (C++20)
- 工具库
- 类型支持(基本类型、RTTI、类型特性)
- 概念库 (C++20)
- 错误处理
- 动态内存管理
- 日期和时间工具
- 字符串库
- std::basic_string
- std::basic_string_view
- 空终止字节字符串
- std::isalnum
- std::isalpha
- std::islower
- std::isupper
- std::isdigit
- std::isxdigit
- std::isblank
- std::iscntrl
- std::isgraph
- std::isspace
- std::isprint
- std::ispunct
- std::tolower
- std::toupper
- std::atof
- std::atoi, std::atol, std::atoll
- std::strtol, std::strtoll
- std::strtoul, std::strtoull
- std::strtof, std::strtod, std::strtold
- std::strtoimax, std::strtoumax
- std::strcpy
- std::strncpy
- std::strcat
- std::strncat
- std::strxfrm
- std::strlen
- std::strcmp
- std::strncmp
- std::strcoll
- std::strchr
- std::strrchr
- std::strspn
- std::strcspn
- std::strpbrk
- std::strstr
- std::strtok
- std::memchr
- std::memcmp
- std::memset
- std::memcpy
- std::memmove
- std::strerror
- 空终止多字节字符串
- 空终止宽字符串
- std::char_traits
- 注释
- 容器库
- 迭代器库
- 范围库 (C++20)
- 算法库
- 数值库
- 输入/输出库
- 文件系统库
- 本地化库
- 正则表达式库
- 原子操作库
- 线程支持库
- 实验性 C++ 特性
- 有用的资源
- 索引
- std 符号索引
- 协程支持 (C++20)
- C++ 关键词
std::strncmp
定义于头文件 <cstring>
|
||
int strncmp( const char* lhs, const char* rhs, std::size_t count ); |
||
比较二个可能空终止的数组的至多 count
个字符。按字典序进行比较。不比较后随空字符的字符。
结果的符号是被比较的数组中首对字符(都转译成 unsigned char )的值间的差的符号。
若出现越过 lhs
或 rhs
结尾的访问,则行为未定义。若 lhs
或 rhs
为空指针,则行为未定义。
参数
lhs, rhs | - | 指向要比较的可能空终止的数组的指针 |
count | - | 要比较的最大字符数 |
返回值
若字典序中 lhs
先出现于 rhs
则为负值。
若 lhs
与 rhs
比较相等,或若 count 为零,则为零。
若字典序中 lhs
后出现于 rhs
则为正值。
注解
不同于 std::strcoll 和 std::strxfrm ,此函数不考虑本地环境。
示例
运行此代码
#include <cstring> #include <iostream> void demo(const char* lhs, const char* rhs, int sz) { int rc = std::strncmp(lhs, rhs, sz); if(rc == 0) std::cout << "First " << sz << " chars of [" << lhs << "] equal [" << rhs << "]\n"; else if(rc < 0) std::cout << "First " << sz << " chars of [" << lhs << "] precede [" << rhs << "]\n"; else if(rc > 0) std::cout << "First " << sz << " chars of [" << lhs << "] follow [" << rhs << "]\n"; } int main() { demo("Hello, world!", "Hello, everybody!", 13); demo("Hello, everybody!", "Hello, world!", 13); demo("Hello, everybody!", "Hello, world!", 7); demo("Hello, everybody!" + 12, "Hello, somebody!" + 11, 5); }
输出:
First 13 chars of [Hello, world!] follow [Hello, everybody!] First 13 chars of [Hello, everybody!] precede [Hello, world!] First 7 chars of [Hello, everybody!] equal [Hello, world!] First 5 chars of [body!] equal [body!]
参阅
比较两个字符串 (函数) | |
比较来自两个宽字符串的一定量宽字符 (函数) | |
比较两个缓冲区 (函数) | |
按照当前本地环境比较两个字符串 (函数) |