文字列

Go言語で指定した文字列が別の文字列に含まれているかを判定する方法を解説

2025-02-19更新日: 2025-02-19

Go言語の標準ライブラリには、文字列操作をシンプルに実現する機能が揃っています。

特に、strings.Contains関数を利用すれば、ある文字列が別の文字列に含まれているかどうかを簡単に判定できます。

本記事では、具体的な使い方や注意点について、実例を交えながらわかりやすく解説します。

目次から探す

Go言語の文字列操作の基礎
- Go言語における文字列の特徴
- 標準ライブラリの役割
strings.Contains関数の解説
実例を用いた応用方法
- 複数の文字列検索の実装例
注意点と活用のポイント
- 大文字小文字の影響への対応
- パフォーマンスへの配慮
まとめ

Go言語の文字列操作の基礎

Go言語における文字列の特徴

Go言語の文字列は不変なバイト列であり、UTF-8でエンコードされています。

このため、文字列を変更する場合は新たな文字列を生成する必要があります。

内部的には配列として扱われるため、インデックスを用いて特定のバイトにアクセスすることはできますが、1文字が1バイトで表現されるとは限らない点に注意が必要です。

また、Goの文字列は読み取り専用であるため、予期せぬ変更を防ぎ、プログラムの安定性が確保されます。

標準ライブラリの役割

Go言語では、文字列操作に関する多くの関数が標準ライブラリに用意されています。

たとえば、以下のようなパッケージが文字列操作に役立ちます。

fmt：文字列のフォーマットや出力のために利用されます。
strings：文字列の検索、分割、置換などの豊富な関数を提供します。
unicode/utf8：UTF-8エンコードされた文字列の操作をサポートします。

これらのライブラリを適切に活用することで、効率的な文字列操作が実現できます。

strings.Contains関数の解説

関数の概要と基本構文

strings.Contains関数は、指定した文字列が別の文字列に含まれているかどうかを判定するための関数です。

この関数は、対象の文字列がサブ文字列を含む場合にtrueを返し、含まれていない場合にfalseを返します。

基本的な構文は以下の通りです。

result := strings.Contains(s, substr)

ここで、sは対象文字列、substrは検索するサブ文字列となります。

引数と返り値の詳細

strings.Contains関数は以下の引数と返り値を持ちます。

引数
- s：検索対象となる文字列
- substr：見つけたいサブ文字列
返り値
- bool型の値を返します。s内にsubstrが存在する場合はtrue、存在しない場合はfalseが返されます。

このシンプルな関数構成により、文字列内のサブ文字列判定が容易に行えます。

シンプルな使用例

以下は、strings.Contains関数を利用したシンプルなサンプルコードです。

package main
import (
	"fmt"
	"strings"
)
func main() {
	// サンプルの対象文字列
	text := "Go言語で文字列操作を学ぶ"
	// 検索するサブ文字列
	subText := "文字列操作"
	// strings.Containsを利用して、サブ文字列が存在するか判定する
	if strings.Contains(text, subText) {
		fmt.Println("対象文字列にはサブ文字列が含まれています。")
	} else {
		fmt.Println("対象文字列にはサブ文字列が含まれていません。")
	}
}

対象文字列にはサブ文字列が含まれています。

実例を用いた応用方法

複数の文字列検索の実装例

複数のサブ文字列を対象文字列内で検索する場合、ループ構文を利用すると効率よく判定が行えます。

以下のサンプルコードは、複数の文字列をリストで管理し、各文字列が対象文字列に含まれているか逐次判定する例です。

package main
import (
	"fmt"
	"strings"
)
func main() {
	// 対象となる文字列
	text := "Go言語の標準ライブラリを活用した文字列操作の例"
	// 検索する複数のサブ文字列リスト
	searchList := []string{"Go言語", "標準ライブラリ", "文字列操作", "エラーチェック"}
	// リスト内の各サブ文字列が対象文字列に含まれるか確認する
	for _, searchItem := range searchList {
		if strings.Contains(text, searchItem) {
			fmt.Printf("対象文字列に '%s' が含まれています。\n", searchItem)
		} else {
			fmt.Printf("対象文字列に '%s' は含まれていません。\n", searchItem)
		}
	}
}

対象文字列に 'Go言語' が含まれています。
対象文字列に '標準ライブラリ' が含まれています。
対象文字列に '文字列操作' が含まれています。
対象文字列に 'エラーチェック' は含まれていません。

コード例の解説

上記のサンプルコードでは、以下のポイントが示されています。

textに対象の文字列を定義しています。
複数の検索キーワードをスライスsearchListに保持しています。
forループを用いて各キーワードについてstrings.Containsで存在判定を行い、結果を出力しています。
コメントによって、各処理の目的がわかるように記述しています。

エラーハンドリングの注意点

strings.Contains関数は基本的にエラーを返さないため、エラーチェックは不要ですが、考慮すべき点がいくつかあります。

対象文字列またはサブ文字列が空の場合でも、関数は正しく動作します(空文字の場合、常にtrueが返る設計になっています)。
実際のアプリケーションでは、入力値が期待通りであるか、事前にチェックを行うと安全です。
検索対象が大量の場合、無駄なループや重複チェックがないように最適化を検討することが大切です。

注意点と活用のポイント

大文字小文字の影響への対応

Go言語のstrings.Contains関数は大文字小文字を区別します。

そのため、ケースインセンシティブな検索を行う場合は、対象文字列とサブ文字列の両方をstrings.ToLowerやstrings.ToUpperを使って統一したうえで検索する方法が一般的です。

以下に、ケースインセンシティブな検索の例を示します。

package main
import (
	"fmt"
	"strings"
)
func main() {
	// 対象文字列の定義(大文字・小文字が混合している)
	text := "Go言語は楽しく学べるプログラミング言語です"
	// 検索するサブ文字列(小文字で指定)
	subText := "プログラミング言語"
	// 大文字小文字を統一してから検索することで、ケースインセンシティブな判定を行う
	if strings.Contains(strings.ToLower(text), strings.ToLower(subText)) {
		fmt.Println("対象文字列に該当するサブ文字列が含まれています。")
	} else {
		fmt.Println("対象文字列に該当するサブ文字列が含まれていません。")
	}
}

対象文字列に該当するサブ文字列が含まれています。

パフォーマンスへの配慮

文字列操作には高速な処理が求められるケースが多いため、アプリケーションのパフォーマンスを考慮することが重要です。

対象文字列やサブ文字列に対して変換処理を頻繁に行う場合、無駄な処理が発生しないように、前処理として変換を済ませた結果を再利用すると良いでしょう。
複数回の検索が発生する場合は、必要に応じて文字列のキャッシュを導入することで、全体のレスポンスを向上させることが可能です。
特に大規模なテキストデータを取り扱う場合、アルゴリズムの計算量に注意し、計算コストを最小限に抑える工夫が求められます。

以上の点を考慮しながら、効率良く文字列操作を行うことで、安定したアプリケーションの構築が可能になります。

まとめ

この記事では、Go言語の文字列操作の基本、strings.Contains関数の概要や応用例、ならびにエラーチェック、大文字小文字の対応、パフォーマンスへの配慮について詳しく解説しましたでした。

各セクションで具体例を交えながら手法と注意点が整理され、実践的な知識が得られる内容となっています。

ぜひ実際にコードを実装して、今回学んだ知識をプロジェクトで活かしてください。