こんにちは!フリーランスの長野です。
Containsって使っていますか?C#ではContainsを使って文字列や配列、Listから指定した対象が含まれるか確認することができます。
この記事では、Containsについて
- Containsメソッドとは
- 文字列内に指定の文字列があるか確認
- Listの要素にあるか確認
- 配列の要素にあるか確認
という基本的な内容から、
- 複数のキーワードがあるか確認
- 正規表現を使う方法
など応用的な内容についても解説していきます。今回はContainsについて、使い方をわかりやすく解説します!
この記事の目次
- 1 Containsメソッドとは
- 2 文字列内に指定の文字列があるか確認
- 3 Listの要素にあるか確認
- 4 配列の要素にあるか確認
- 5 複数のキーワードがあるか確認
- 6 正規表現を使う方法
- 7 まとめ
Containsメソッドとは
Containsメソッドは文字列内に指定の文字、文字列が含まれるか確認することができます。また、Listや配列に指定の要素が含まれているかを確認することもできます。
StringクラスやListクラスなどでContainsメソッドが用意されています。ただし、ArrayクラスにはContainsメソッドはありません。LINQのEnumerable.Containsメソッドを使って代用することができます。
それぞれのクラスのContainsメソッドの使い方について解説していきます!
文字列内に指定の文字列があるか確認
まずは文字列内に指定の文字、もしくは文字列が含まれるか確認する方法についてみていきましょう。
Containsメソッドは以下のように定義されています。
public bool Contains[ string value ]引数valueでは、存在するか確認する文字もしくは文字列を指定します。指定した文字列が含まれる場合はtrue、それ以外はfalseを返します。
サンプルコードで確認しましょう。
using System; namespace Sample { class Sample { static void Main[] { string str = "Hello World!"; string target = "W"; if[str.Contains[target]] { Console.WriteLine["{0}が見つかりました", target]; } else { Console.WriteLine["{0}は見つかりませんでした", target]; } Console.ReadKey[]; } } }実行結果:
Wが見つかりましたこのサンプルコードでは、Containsメソッドを使って"W"が含まれるか確認しています。
Listの要素にあるか確認
Listに指定の要素が含まれるか確認する方法についてもみていきましょう。
Containsメソッドは以下のように定義されています。
public bool Contains[ T item ]引数itemには、存在するか確認する要素を指定します。
サンプルコードで確認しましょう。
using System; using System.Collections.Generic; namespace Sample { class Sample { static void Main[] { string[] src = {"Tokyo", "Osaka", "Nagoya"}; var list = new List[]; list.AddRange[src]; string item = "Osaka"; if[list.Contains[item]] { Console.WriteLine["{0}が見つかりました", item]; } else { Console.WriteLine["{0}は見つかりませんでした", item]; } Console.ReadKey[]; } } }実行結果:
配列の要素にあるか確認
配列に指定の要素が含まれるか確認する方法についてもみていきましょう。
ArrayクラスにはContainsメソッドがありません。代わりとしてLINQのEnumerable.Containsメソッドを使う方法をご紹介します。
using System; using System.Linq; namespace Sample { class Sample { static void Main[] { string[] src = {"Tokyo", "Osaka", "Nagoya"}; string item = "Osaka"; if[src.Contains["Osaka"]] { Console.WriteLine["{0}が見つかりました", item]; } else { Console.WriteLine["{0}は見つかりませんでした", item]; } Console.ReadKey[]; } } }実行結果:
Osakaが見つかりました複数のキーワードがあるか確認
複数のキーワードが含まれるか確認するには論理演算子のAND、ORを使用します。
ANDの場合
キーワードを全て含むか確認する場合はAND演算子を使います。
using System; namespace Sample { class Sample { static void Main[] { string str = "Hello World!"; string val1 = "d"; string val2 = "e"; if[str.Contains[val1] && str.Contains[val2]] { Console.WriteLine["{0}、{1}どちらも見つかりました", val1, val2]; } else { Console.WriteLine["{0}、{1}のどちらかが見つかりませんでした", val1, val2]; } Console.ReadKey[]; } } }実行結果:
d、eどちらも見つかりましたORの場合
キーワードの中のどれかを含むか確認する場合はOR演算子を使います。
using System; namespace Sample { class Sample { static void Main[] { string str = "Hello World!"; string val1 = "d"; string val2 = "e"; if[str.Contains[val1] || str.Contains[val2]] { Console.WriteLine["{0}、{1}のどちらかが見つかりました", val1, val2]; } else { Console.WriteLine["{0}、{1}どちらも見つかりませんでした", val1, val2]; } Console.ReadKey[]; } } }実行結果:
d、eのどちらかが見つかりました正規表現を使う方法
文字列に正規表現にマッチする文字列が含まれているか検索したい場合があります。
正規表現とはいくつかの文字列を一つの形式でまとめて表現するための表現方法のことです。主な正規表現については下記のとおりになります。
. | 任意の1文字。改行文字は除く。 | .+ | 任意の文字列 |
* | 直前の1文字の0回以上の繰り返しと一致 | hoge* | hogeもしくはhogee...と一致 |
^ | 行の先頭 | ^[0-9] | 行頭が数字 |
$ | 行の末尾 | ^.{10}$ | 10文字の行 |
[ ] | カッコ内の任意の1文字と一致。「-」で範囲指定可。 | [a-z] | 小文字のアルファベット1文字と一致 |
[^ ] | カッコ内の任意の1文字と不一致。「-」で範囲指定可。 | [^A-Z] | 大文字のアルファベット以外 |
+ | 直前の文字の1個以上の繰り返しと一致 | hoge+ | hogee...と一致 |
? | 直前の文字の0または1文字と一致 | hoge? | eと一致 |
{ } | カッコ内の数値の繰り返しと一致 | {n} | 直前の文字のn個の繰り返しと一致 |
{,n} | 直前の文字のn個以下の繰り返しと一致 | ||
{m,} | 直前の文字のm個以上の繰り返しと一致 | ||
{m,n} | 直前の文字のm個以上、n個以下の繰り返しと一致 | ||
| | 直前、直後どちらかのパターンに一致 | hoge|piyo | hogeまたはpiyo |
[ ] | カッコ内をグループ化。マッチした内容は参照可。 | ー | ー |
C#で正規表現にマッチする文字列が含まれているか検索するには、System.Text.RegularExpressions.Regexクラスを使います。
用意されているメソッドには、指定した正規表現が含まれているか確認するためのIsMatchメソッドや検索するためのMatchesメソッドなどがあります。
Regexクラスの簡単な使い方について、サンプルコードでご紹介します。
using System; using System.Text.RegularExpressions; namespace Sample { class Sample { static void Main[] { string str = "侍エンジニア"; string target = "[エンジニア]"; if[Regex.IsMatch[str, target]] { Console.WriteLine["{0}にマッチします", target]; } else { Console.WriteLine["{0}にマッチしません", target]; } Console.ReadKey[]; } } }実行結果:
[エンジニア]にマッチしますこのサンプルコードでは、RegularExpressionsクラスを使って正規表現にマッチするか確認しています。
正規表現パターンにはエ、ン、ジ、ニ、アのいずれかの文字を指定しています。IsMachメソッドで指定した正規表現パターンが含まれるか確認を行っています。
まとめ
ここでは、Containsメソッドについて説明しました。Containsメソッドは文字列内に指定の文字、文字列が含まれるか確認することができます。
また、Listや配列に指定の要素が確認することもできます。ただし、配列の要素で確認する場合はLINQのEnumerable.Containsを使うなどの工夫が必要です!
使いこなすことができるように、この記事を何度も参考にして下さいね!