読み込み中...

C++でstrcmp関数を使いこなす7つの方法

C++のstrcmp関数を使用したプログラミングのコード画像 C++
2024.04.28
この記事は約15分で読めます。

【サイト内のコードはご自由に個人利用・商用利用いただけます】

この記事では、プログラムの基礎知識を前提に話を進めています。

説明のためのコードや、サンプルコードもありますので、もちろん初心者でも理解できるように表現してあります。

本記事のサンプルコードを活用して機能追加、目的を達成できるように作ってありますので、是非ご活用ください。

※この記事は、一般的にプロフェッショナルの指標とされる『実務経験10,000時間以上』を満たす現役のプログラマチームによって監修されています。

※Japanシーモアは、常に解説内容のわかりやすさや記事の品質に注力しております。不具合、分かりにくい説明や不適切な表現、動かないコードなど気になることがございましたら、記事の品質向上の為にお問い合わせフォームにてご共有いただけますと幸いです。
(送信された情報は、プライバシーポリシーのもと、厳正に取扱い、処分させていただきます。)

はじめに

この記事では、C++におけるstrcmp関数の使い方を初心者から上級者まで段階を追って詳しく解説していきます。

プログラミングにおいて文字列の比較は非常に一般的な操作ですが、正しく理解して適切に使いこなすためのポイントがあります。

この関数の基本的な動作から、より複雑な使用方法まで、具体的なサンプルコードを交えて説明しますので、C++をこれから学び始める方にも、すでにある程度使い慣れている方にも役立つ内容となっています。

●strcmp関数の基本

C++で文字列を比較する際に頻繁に使用されるのが、strcmp関数です。

この関数は、またはヘッダに定義されており、二つの文字列を比較してその結果を整数で返します。

基本的に、strcmp関数は二つの文字列を辞書順に比較し、第一引数の文字列が第二引数の文字列より小さい場合は負の整数、等しい場合は0、大きい場合は正の整数を返します。

○strcmp関数とは何か？

strcmp関数は、標準Cライブラリに含まれる関数で、主に文字列の比較に用いられます。

この関数のプロトタイプは次の通りです。

int strcmp(const char *s1, const char *s2);

ここで、s1とs2は比較したい二つのC文字列（NULLで終端される文字配列）を指します。

関数はs1がs2と完全に一致する場合は0を返し、s1がs2より辞書順で先に来る（小さい）場合は負の整数、後に来る（大きい）場合は正の整数を返します。

○strcmp関数の基本的な使い方

strcmp関数の使い方を理解するために、基本的な文字列比較のサンプルコードを見てみましょう。

このコードは、二つの文字列が等しいかどうかをチェックして、結果をコンソールに出力するものです。

#include <iostream>
#include <cstring>

int main() {
    const char *str1 = "Hello";
    const char *str2 = "Hello";
    const char *str3 = "World";

    // str1とstr2を比較
    if (strcmp(str1, str2) == 0) {
        std::cout << "str1とstr2は等しいです。" << std::endl;
    } else {
        std::cout << "str1とstr2は異なります。" << std::endl;
    }

    // str1とstr3を比較
    if (strcmp(str1, str3) != 0) {
        std::cout << "str1とstr3は異なります。" << std::endl;
    } else {
        std::cout << "str1とstr3は等しいです。" << std::endl;
    }

    return 0;
}

このサンプルコードでは、最初にstr1とstr2が等しいことを確認しています。両方とも”Hello”という同じ文字列を指しているため、結果として”str1とstr2は等しいです。”と出力されます。

次に、str1とstr3を比較していますが、これらは異なる文字列なので”str1とstr3は異なります。”と出力されます。

●strcmp関数の注意点

strcmp関数を使用する際には、注意すべき点があります。

特に、文字列の終端に関する理解が不十分だと、予期せぬバグやセキュリティリスクにつながる可能性があります。

それでは、具体的な注意点を見ていきましょう。

○文字列の長さが異なる場合の取り扱い

strcmp関数は、NULL文字（’\0’）に達するまでの文字列を比較します。

そのため、文字列の長さが異なる場合でも、共通の部分が一致していれば、その後の比較は行われません。

例えば、”Hello”と”HelloWorld”を比較すると、”Hello”部分は一致しているため、そこで比較が終了し、最終的には”Hello”の方が短いため負の値が返されます。

この挙動は意図したものと異なる場合があるため、使用する際は注意が必要です。

#include <iostream>
#include <cstring>

int main() {
    const char *str1 = "Hello";
    const char *str2 = "HelloWorld";

    int result = strcmp(str1, str2);
    if (result < 0) {
        std::cout << "str1はstr2より辞書順で先に来ます。" << std::endl;
    } else if (result > 0) {
        std::cout << "str1はstr2より辞書順で後に来ます。" << std::endl;
    } else {
        std::cout << "str1とstr2は等しいです。" << std::endl;
    }

    return 0;
}

このコードでは、”Hello”と”HelloWorld”を比較しています。出力結果は”str1はstr2より辞書順で先に来ます。”となりますが、これは”Hello”が”HelloWorld”の部分文字列として存在しているためです。

○エンコーディングの違いによる影響

strcmp関数は、ASCII文字に基づいた比較を行いますが、異なるエンコーディングを持つ文字列を比較した場合、正しく動作しないことがあります。

特に、UTF-8のようなマルチバイト文字セットを扱う際には、strcmp関数だけでは不十分で、エンコーディングを意識した比較関数を使用する必要があります。

例えば、日本語の文字列を比較する場合には、wchar_t型を使った比較や、C++11以降でサポートされているstd::wstringを使用することが推奨されます。

これで、マルチバイト文字の比較が正確に行われ、期待する結果を得ることができます。

●strcmp関数のカスタマイズ方法

C++での文字列操作は多岐にわたりますが、場合によっては標準のstrcmp関数では要件を満たせないこともあります。

そのため、特定の状況や要件に合わせてstrcmp関数をカスタマイズする方法を学ぶことが重要です。

例えば、大文字と小文字を区別せずに比較を行いたい場合や、特定のロケール設定に基づいて文字列を比較したい場合などです。

ここでは、基本的なカスタマイズ方法として、大小文字を区別しない比較関数の作成方法について解説します。

○サンプルコード4：独自の比較関数の作成

大小文字を区別しない文字列比較を行うカスタム関数を作成することで、strcmp関数の機能を拡張することができます。

この関数では、C標準ライブラリに含まれるtolower関数を使用して、比較する前に文字列の各文字を小文字に変換しています。

#include <iostream>
#include <cstring>
#include <cctype>

int caseInsensitiveCompare(const char *s1, const char *s2) {
    while (*s1 != '\0' && *s2 != '\0') {
        if (tolower(*s1) != tolower(*s2)) {
            return tolower(*s1) - tolower(*s2);
        }
        s1++;
        s2++;
    }
    return *s1 - *s2;
}

int main() {
    const char *str1 = "hello";
    const char *str2 = "HELLO";

    if (caseInsensitiveCompare(str1, str2) == 0) {
        std::cout << "str1とstr2は等しいです（大文字小文字を区別せず）" << std::endl;
    } else {
        std::cout << "str1とstr2は異なります。" << std::endl;
    }

    return 0;
}

この関数は、与えられた二つの文字列が大文字小文字の違いを無視して等しいかどうかを判断します。

これにより、より柔軟な文字列比較が可能となり、アプリケーションの国際化を支援する一環としても利用できます。

○サンプルコード5：ラッパー関数の実装

さらに複雑な比較ロジックやエラーハンドリングが必要な場合は、strcmp関数をラップする関数を作成することが効果的です。

ラッパー関数を使用することで、元のstrcmp関数のインターフェースはそのままに、追加の機能を実装することができます。

#include <iostream>
#include <cstring>

int safeCompare(const char *s1, const char *s2) {
    if (s1 == nullptr || s2 == nullptr) {
        throw std::invalid_argument("Null pointer passed to compare function");
    }
    return strcmp(s1, s2);
}

int main() {
    try {
        const char *str1 = "Hello";
        const char *str2 = nullptr; // 故意にnullを設定

        std::cout << "比較結果: " << safeCompare(str1, str2) << std::endl;
    } catch (const std::exception &e) {
        std::cout << "エラー: " << e.what() << std::endl;
    }

    return 0;
}

このラッパー関数safeCompareは、どちらかの文字列がnullである場合に例外を投げることで、より安全な文字列比較を実現します。

これで、プログラムの安定性を向上させると同時に、デバッグ作業を効率化することが可能になります。

●strcmp関数の応用例

strcmp関数は単なる文字列比較以上の応用が可能です。

ここでは、データベースのクエリ最適化やファイル名のソートなど、具体的な応用例を通じて、その実用性を探ります。

○サンプルコード6：データベースのクエリにおける使用例

データベースのクエリ処理において、strcmp関数を用いることで、文字列フィールドの比較を効率的に行うことができます。

例えば、ユーザー名やメールアドレスなど、特定の条件に基づいてレコードを検索する際に役立ちます。

このサンプルコードは、ユーザー名が特定の値に一致するレコードを検索する簡単な例です。

#include <iostream>
#include <vector>
#include <cstring>

struct User {
    std::string name;
    int id;
};

std::vector<User> filterUsersByName(const std::vector<User>& users, const char* targetName) {
    std::vector<User> filteredUsers;
    for (const auto& user : users) {
        if (strcmp(user.name.c_str(), targetName) == 0) {
            filteredUsers.push_back(user);
        }
    }
    return filteredUsers;
}

int main() {
    std::vector<User> users = {{ "Alice", 1 }, { "Bob", 2 }, { "Alice", 3 }};
    auto result = filterUsersByName(users, "Alice");
    for (const auto& user : result) {
        std::cout << "User ID: " << user.id << ", Name: " << user.name << std::endl;
    }
    return 0;
}

このコードでは、ユーザーリストから名前が”Alice”のユーザーのみを抽出しています。

strcmp関数は、文字列が完全に一致する場合に0を返すため、この条件を満たすユーザーだけが結果のリストに含まれます。

○サンプルコード7：ファイル名のソートに使用する場合

ファイル名のリストを辞書順にソートする場合、strcmp関数が非常に便利です。

このサンプルコードは、ファイル名を辞書順にソートする処理をしています。

#include <iostream>
#include <algorithm>
#include <vector>
#include <cstring>

int main() {
    std::vector<const char*> filenames = { "file1.txt", "file2.txt", "file10.txt", "file20.txt" };
    std::sort(filenames.begin(), filenames.end(), [](const char* a, const char* b) {
        return strcmp(a, b) < 0;
    });

    std::cout << "Sorted filenames:" << std::endl;
    for (const auto& filename : filenames) {
        std::cout << filename << std::endl;
    }
    return 0;
}

このコードでは、std::sort関数とラムダ式を使用して、strcmp関数の結果に基づいてファイル名をソートしています。

strcmpが負の値を返すとき、それは第一引数が辞書順で第二引数よりも前にくることを意味します。

この挙動により、ファイル名が正しくソートされます。

●よくあるエラーとその対処法

プログラミングにおける文字列処理では、特にstrcmp関数を使用する際に多くのエラーが発生します。

ここでは、一般的なエラーとその対策を詳しく見ていきましょう。

○ヌルポインタを渡したときのセグメンテーションフォルト

strcmp関数にNULLポインタが渡された場合、アクセス違反が発生し、プログラムがセグメンテーションフォルトを引き起こします。

この問題を防ぐためには、関数に文字列を渡す前に必ずNULLチェックを行うことが重要です。

#include <iostream>
#include <cstring>

int safe_strcmp(const char* s1, const char* s2) {
    if (s1 == nullptr || s2 == nullptr) {
        std::cerr << "エラー: NULLポインタが渡されました。" << std::endl;
        return 0; // またはエラーコードを返す
    }
    return strcmp(s1, s2);
}

int main() {
    const char* str1 = nullptr;
    const char* str2 = "Hello";

    // セーフなstrcmpの使用
    std::cout << "比較結果: " << safe_strcmp(str1, str2) << std::endl;
    return 0;
}

このコードは、NULLポインタが渡された場合に適切なエラーメッセージを出力し、プログラムのクラッシュを防ぎます。

○文字列終端の扱いにおける常識ミスと対策

文字列の終端はNULL文字(‘\0’)によって表されますが、この終端を正しく設定しないことで予期しない結果が生じることがあります。

たとえば、メモリから直接読み込んだデータをNULL終端せずにstrcmpに渡すと、メモリ領域外を読み込んでしまう可能性があります。

#include <iostream>
#include <cstring>
#include <vector>

void print_comparison(const char* s1, const char* s2) {
    int result = strcmp(s1, s2);
    if (result == 0) {
        std::cout << "文字列は等しいです。" << std::endl;
    } else if (result < 0) {
        std::cout << "最初の文字列が辞書順で小さいです。" << std::endl;
    } else {
        std::cout << "最初の文字列が辞書順で大きいです。" << std::endl;
    }
}

int main() {
    char data1[] = {'H', 'e', 'l', 'l', 'o'};
    char data2[] = "Hello";

    // NULL終端を確実にする
    std::vector<char> str1(std::begin(data1), std::end(data1));
    str1.push_back('\0');

    print_comparison(str1.data(), data2);
    return 0;
}

この例では、配列data1がNULLで終端されていない場合に対処するため、std::vectorを使用して動的にNULL文字を追加しています。

これで、安全にstrcmp関数を使用することができます。

まとめ

この記事では、C++のstrcmp関数の使い方とその応用例を詳しく解説しました。

基本的な使い方からエラーハンドリング、カスタマイズ方法まで、豊富なサンプルコードを交えて紹介しました。

プログラミング初心者から中級者まで、文字列の比較を正確に行う方法を理解することで、自身のプロジェクトに適用することができるようになるでしょう。