std::strncmp

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

文字處理庫

本地化庫

正則表示式庫 (C++11)

格式化庫 (C++20)

空終止序列工具

位元組字串

多位元組字串

寬字串

原生數值轉換

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

文字編碼標識

text_encoding (C++26)

 

空終止位元組字串

函式
字元分類
isalnum isalpha islower isupper isdigit isxdigit	isblank (C++11) iscntrl isgraph isspace isprint ispunct
字元操作
tolower	toupper
轉換為數字格式
atof atoiatolatoll (C++11) strtolstrtoll (C++11)	strtoulstrtoull (C++11) strtofstrtodstrtold (C++11)(C++11) strtoimaxstrtouimax (C++11)(C++11)
字串操作
strcpy strncpy strxfrm	strcat strncat
字串檢查
strlen strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtok
字元陣列函式
memchr memcmp memset	memcpy memmove
雜項
strerror

 

在標頭檔案 <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)
{
    const int rc = std::strncmp(lhs, rhs, sz);
    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";
    else
        std::cout << "First " << sz << " chars of ["
                  << lhs << "] equal [" << 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!]

參閱

strcmp	比較兩個字串 (函式)
wcsncmp	比較兩個寬字串中的一定數量的字元 (函式)
memcmp	比較兩個緩衝區 (函式)
strcoll	根據當前區域設定比較兩個字串 (函式)
C 文件 for strncmp