memcmp

 

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 memcmp( const void* lhs, const void* rhs, size_t count );

比較 lhs 和 rhs 指向物件的首 count 個位元組。比較按字典序進行。

結果的符號是比較物件中第一對不同位元組（均被解釋為 unsigned char）值的差的符號。

如果訪問超出 lhs 和 rhs 指向的任一物件的末尾，則行為未定義。如果 lhs 或 rhs 是空指標，則行為未定義。

引數

lhs, rhs	-	指向要比較的物件的指標
count	-	要檢查的位元組數

返回值

如果 lhs 在字典序上出現在 rhs 之前，則返回負值。

如果 lhs 和 rhs 比較相等，或者 count 為零，則返回零。

如果 lhs 在字典序上出現在 rhs 之後，則返回正值。

注意

此函式讀取物件表示，而非物件值，通常僅對位元組陣列有意義：結構體可能有填充位元組，其值是不確定的，聯合體中最後一個儲存成員之後的任何位元組的值是不確定的，並且一種型別可能具有兩個或多個表示相同值的方式（對於 +0 和 -0 或對於 +0.0 和 –0.0 的不同編碼，型別內不確定的填充位）。

示例

執行此程式碼

#include <stdio.h>
#include <string.h>
 
void demo(const char* lhs, const char* rhs, size_t sz)
{
    for(size_t n = 0; n < sz; ++n)
        putchar(lhs[n]);
 
    int rc = memcmp(lhs, rhs, sz);
    const char *rel = rc < 0 ? " precedes " : rc > 0 ? " follows " : " compares equal ";
    fputs(rel, stdout);
 
    for(size_t n = 0; n < sz; ++n)
        putchar(rhs[n]);
    puts(" in lexicographical order");
}
 
int main(void)
{
    char a1[] = {'a','b','c'};
    char a2[sizeof a1] = {'a','b','d'};
 
    demo(a1, a2, sizeof a1);
    demo(a2, a1, sizeof a1);
    demo(a1, a1, sizeof a1);
}

輸出

abc precedes abd in lexicographical order
abd follows abc in lexicographical order
abc compares equal to abc in lexicographical order

參考

• C23 標準 (ISO/IEC 9899:2024)

• 7.24.4.1 memcmp 函式 (p: TBD)

• C17 標準 (ISO/IEC 9899:2018)

• 7.24.4.1 memcmp 函式 (p: 266)

• C11 標準 (ISO/IEC 9899:2011)

• 7.24.4.1 memcmp 函式 (p: 365)

• C99 標準 (ISO/IEC 9899:1999)

• 7.21.4.1 memcmp 函式 (p: 328)

• C89/C90 標準 (ISO/IEC 9899:1990)

• 4.11.4.1 memcmp 函式

另請參閱

strcmp	比較兩個字串 (函式)
strncmp	比較兩個字串的特定數量的字元 (函式)
C++ 文件 關於 memcmp