std:: strncmp

最大で count 文字まで、2つのヌル終端配列（可能性あり）を比較します。比較は辞書順で行われます。ヌル文字以降の文字は比較されません。

結果の符号は、比較対象の配列において異なる値を持つ最初の文字ペア（両方とも unsigned char として解釈される）の値の差の符号に基づきます。

いずれかの配列 lhs または rhs の終端を超えてアクセスが発生した場合、動作は未定義です。 lhs または rhs のいずれかがヌルポインタである場合も、動作は未定義です。

パラメータ

戻り値

負の値は、 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!]

関連項目