文字列を検索する際、C言語において標準ライブラリのstrstr関数は非常に便利です。しかし、「検索対象が見つからない場合」「NULLが返ってきた時の扱い」「引数にNULLを渡した時の挙動」など、誤解や実装ミスが多く見られます。この記事では、C言語 strstr 使い方 NULLをテーマに、strstrの基本、NULLの意味、正しい使い方、実例、トラブル対策までを丁寧に解説します。読み終える頃には、strstrの使い方とNULLに対する理解が確実に身につきます。
C言語 strstr 使い方 NULL の基本概念と仕様
strstr関数は、文字列の中で別の文字列を検索するための関数です。第一引数が検索対象の文字列（haystack）、第二引数が探したい文字列（needle）であり、どちらもヌル終端文字列である必要があります。検索対象が見つかれば、見つけた位置を指すポインタを返し、見つからなければNULLを返します。これが仕様であり、C89やC99などの標準で定義されています。strstrは二つの文字列を比較し、第二引数が空文字列の場合には第一引数をそのまま返すという挙動も持っています。
関数のプロトタイプとヘッダ
strstr関数は標準ヘッダstring.hに宣言されています。プロトタイプは以下のような形です。
char *strstr(const char *haystack, const char *needle);
const char *を引数に取る版とmutable（書き換え可能）な文字列を取る版があり、返り値もそれに応じます。引数および戻り値はヌル終端文字列を前提としています。
返り値: 見つかればポインタ、見つからなければNULL
検索に成功すると、haystack内でneedle文字列が最初に現れる位置を指すポインタを返します。部分文字列の最初の文字を指し、文字列の終端文字（”）は比較に含まれない仕様です。見つからない場合はNULLが返されます。これが“NULLの判定”の基礎であり、戻り値がNULLであるかどうかで条件分岐を行います。
needleが空文字列の場合の挙動
第二引数のneedleが空文字列（””）である場合、strstrはhaystack自身を返します。つまり検索対象文字列全体が結果になるという意味で、空文字列はどの文字列にも“含まれる”と見なされます。これは標準仕様であり、多くの実装で空文字列を検索すると最初からマッチするとの結果になります。
NULL が返る具体的なケースと原因
strstr関数を使った際にNULLが返るのは、必ずしもエラーではありません。仕様として正当な結果です。ですが、NULLが返ってくる原因を理解していないと予期せぬ不具合につながります。この章では、どのような状況でNULLが返るのかを具体的に見ていきます。
substringがhaystackに含まれていない
最も典型的なケースは、needleがhaystackの中にまったく存在しない時です。この場合、strstrはNULLを返します。たとえば“apple”を“tutorial gateway”の中で検索すると見つからず、NULLが返るので条件分岐で“見つからない”として処理する必要があります。
needleが長すぎる、または不正な文字を含む
needleの長さがhaystackより長い、あるいは期待する文字列でない文字が含まれているときもNULLが返ります。比較は文字単位で行われ、文字列が一致しないと判断されると次の開始位置へと移りますが、最後まで一致が見られなければNULLが返ります。
引数にNULLを渡した場合の不正動作
検索対象かまたは探す文字列のいずれかにNULLポインタを渡すと、未定義動作となります。プログラムがセグメンテーションフォルトを起こすことがあり、これを避けるための事前チェックが必要です。引数のNULLチェックを怠ると予測不能なクラッシュにつながります。
strstrの使い方とNULL判定のベストプラクティス
正しくstrstrを使うためには、NULLの判定を含めたエラーチェックを行うことが重要です。ここでは使い方の流れを具体的に示し、NULLを安全に扱う方法、さらに比較的よくある落とし穴への対処を紹介します。これによりコードの堅牢性が一気に向上します。
戻り値のNULLチェックの流れ
strstrを使った検索処理では、呼び出し直後に戻り値がNULLかどうかを確認します。NULLでなければ部分文字列が存在するのでそのポインタを使って文字列を処理できます。NULLであれば存在しないと判断し、その場合のフォールバック処理やエラーメッセージを用意しておくことが望ましいです。
比較演算子を使ったNULL判定
戻り値がNULLかどうかを調べる方法としては、if (result != NULL) や if (result) が一般的です。不正確なコードでは if (result == 0) のように0と比較するパターンがあり、わかりにくさを招くことがあります。必ずNULLというキーワードを用いるか、真偽値として評価することが読みやすさと保守性を高めます。
引数のNULLチェックを忘れない
検索対象の文字列または探す文字列のどちらかがNULLならば、関数呼び出し前にNULL判定を行い、それを処理するコードを入れることがベストです。引数がNULLであることを想定しないと、予期せぬクラッシュや未定義動作を引き起こす可能性があります。例外処理やエラーハンドリングを含めた設計が必要です。
実践例：strstr を使った文字列検索と NULL 判定のコード
ここでは実例を示して、strstr と NULL 判定を組み合わせた安全なサンプルコードを解説します。実際にどのように使うかイメージしやすくなるよう、典型的なパターンを複数紹介します。これらはすぐに自分のコードに取り入れられるものです。
単純な部分文字列検索の例
以下は、haystackの中からneedleを検索して、見つかったらその位置と文字列以降を表示し、見つからなければメッセージを出す例です。
“`
char *result = strstr(haystack, needle);
if (result != NULL) {
printf(“見つかった位置: %ld\n”, result – haystack);
printf(“以降の文字列: %s\n”, result);
} else {
printf(“文字列が見つかりませんでした\n”);
}
“`
このようにNULLチェックを条件分岐に入れておくことで、見つからない場合の処理も明確になります。
空文字列を探すケース
needleが空文字列のとき、仕様により、strstrはhaystackを返します。空文字列を探す必要があるのか確認し、それに応じて意図した動作になるようにif文で扱いを明示すると良いでしょう。たとえば、needleが空ならば検索をスキップするか、haystack全体を「一致」と見なすかを設計仕様として決めておくことが重要です。
引数チェックを含めた安全なラッパー関数
strstrを直接使うのではなく、ラッパー関数を作って、引数がNULLでないか、needleが空でないかをチェックしておく方法があります。そうすることで、呼び出し元のコードをシンプルに保ちつつ安全性を確保できます。例として、haystackやneedleがNULLの場合に取得したエラーコードを返す関数や、ポインタの検証を統一して行うことが挙げられます。
よくある間違いとトラブルシューティング
strstrを使うときに初心者が陥りやすい間違いがいくつかあります。NULLを正しく評価できない、文字列末尾の改行を含んでいて意図せぬ不一致が生じるなどです。この章では具体的な失敗例とその修正方法を紹介しますので、自分のコードを客観的にチェックするための参考になります。
改行文字が含まれる入力での失敗
標準入力から文字列を取得した場合、fgetsなどを使うと末尾に改行文字が残ることがあります。これがneedleやhaystackに含まれていると、期待する部分文字列検索が失敗し、NULLが返される原因になります。対策として、改行文字を取り除く処理を入れることが有効です。
0 と NULL の混同
ポインタと整数の比較で 0 を使うコードを見かけますが、NULLと0は同じではあっても可読性と意図が伝わりにくくなります。条件文で if (result == 0) と書くと、resultがNULL（ポインタ）であるのか、整数演算の結果なのかが不明瞭になります。必ずNULLというキーワードを使うか、ポインタ型としての真偽を利用するようにしましょう。
部分文字列の重複や多数検索したい場合の誤用
strstrは最初の一致のみを返します。複数回出現する部分文字列をすべて見つけたい場合、NULLを返されるまでループさせながら次の検索開始位置を調整する必要があります。この処理を誤ると、最初の一致だけで終わってしまったり、無限ループになったりすることがあります。
性能と実装上の注意点および標準準拠事項
strstrは標準仕様で定義されており、複数のC標準（C89、C99、C11など）で採用されています。最新情報であるところによれば、多くの実装が仕様に厳密に従っており、needleが空文字列の扱いやNULLの返却なども仕様どおりです。性能面では、入力文字列が長かったり部分文字列が頻繁に現れない場合に全体をスキャンするためコストがかかります。用途に応じて最適化や別のアルゴリズム（KMPなど）を検討する場面があります。
標準準拠と規格の整合性
仕様ではstrstrはC89以降の標準で定義されており、多くのコンパイラでその仕様が守られています。特に、返回値としてNULLを用いること、needleが空文字列ならばhaystackを返すこと、終端文字は比較に含まれないことなどが標準仕様です。実装違いによる微妙な挙動のずれがほとんどないのが現状です。
性能上の制約と大きな文字列処理への影響
haystackが極端に長い文字列で、needleが見つからない場合、strstrはhaystack全体をスキャンするので時間がかかります。繰り返し検索する場合や多数の文字列を処理する場合、時間計算量を考慮し、必要であれば高速な文字列検索アルゴリズムを使うことも検討しましょう。
マルチバイト文字列やロケールの問題
C言語の標準のstrstrはバイト単位での比較を行うため、マルチバイト文字（日本語など）やエンコーディングによっては意図した検索結果にならないことがあります。ロケール設定やワイド文字列（wchar_t 等）の関数を利用することで解決できるケースがあります。
まとめ
strstr関数は文字列検索において基本かつ強力なツールであり、NULLが戻る状況を理解しておくことが安全で確実なプログラムを書く鍵です。検索対象が見つからない、多すぎる入力、空文字列、引数にNULLを渡す、改行が含まれるなどのケースを想定してコードを組むことが大切です。NULL判定を忘れずに行い、明示的に意図した動作を設計することでバグを減らせます。
コメント