memcmp

オブジェクト lhs および rhs が指す先頭 count バイトを比較します。比較は辞書順で行われます。

結果の符号は、比較されるオブジェクト内で異なる最初のバイトのペア（両方とも unsigned char として解釈される）の値の差の符号に基づきます。

lhs および rhs が指すいずれかのオブジェクトの終端を超えてアクセスが発生した場合、動作は未定義です。 lhs または rhs のいずれかがヌルポインタである場合、動作は未定義です。

パラメータ

戻り値

負の値は、 lhs が辞書順で rhs より前に現れる場合を示します。

lhs と rhs が等しい場合、またはcountがゼロの場合、ゼロを返す。

lhs が rhs より辞書順で後に現れる場合、正の値。

注記

この関数は オブジェクト表現 を読み取り、オブジェクト値を読み取るものではなく、通常はバイト配列に対してのみ意味を持ちます：構造体には値が不定のパディングバイトが存在する可能性があり、共用体では最後に格納されたメンバーを超えるバイトの値は不定であり、同じ値に対して2つ以上の表現が存在する型もあります（ + 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

参考文献

関連項目