contains

パターンが文字列内にあるかどうかの判別

ページ内をすべて折りたたむ

構文

TF = contains(str,pat)
TF = contains(str,pat,'IgnoreCase',true)

説明

TF = contains(str,pat) は、str に指定されたパターンが含まれる場合に 1 (true) を返し、それ以外の場合に 0 (false) を返します。

pat が複数のパターンを含む配列の場合、contains は、pat の任意の要素が str 内で見つかった場合に 1 を返します。

str が string 配列または cell 配列である場合、TF は str と同じサイズの logical 配列です。

例

TF = contains(str,pat,'IgnoreCase',true) は、str に pat が含まれるかどうかを判別するときに大文字小文字の区別を無視します。

例

例

すべて折りたたむ

ライブ スクリプトを開く

名前の string 配列を作成します。一部の名前に Paul が含まれます。

string は二重引用符を使用して作成できます。

str = ["Mary Ann Jones","Paul Jay Burns","John Paul Smith"]
str = 1×3 string
    "Mary Ann Jones"    "Paul Jay Burns"    "John Paul Smith"

1 に等しい各要素の位置が、str 内で Paul を含む string の位置に対応する logical 配列を返します。

pat = "Paul";
TF = contains(str,pat)
TF = 1×3 logical array

   0   1   1

Paul を含む string を表示します。TF を str のインデックスとして使用します。

str(TF)
ans = 1×2 string
    "Paul Jay Burns"    "John Paul Smith"
ライブ スクリプトを開く

R2020b 以降

住所を含む string 配列を作成します。

str = ["221B Baker St.","Tour Eiffel Champ de Mars","4059 Mt Lee Dr."]
str = 1×3 string
    "221B Baker St."    "Tour Eiffel Champ de Mars"    "4059 Mt Lee Dr."

数値が含まれる住所を検索するには、関数 digitsPattern を使用して任意の桁数と一致するパターンを作成します。

pat = digitsPattern
pat = pattern
  Matching:

    digitsPattern

桁が含まれる string を示す logical 配列を返します。一致する string を表示します。

TF = contains(str,pat)
TF = 1×3 logical array

   1   0   1


str(TF)
ans = 1×2 string
    "221B Baker St."    "4059 Mt Lee Dr."

1 文字が続く桁のシーケンスがある string を検索します。単純なパターンを組み合わせて、より複雑なパターンを作成できます。

pat = digitsPattern + lettersPattern(1)
pat = pattern
  Matching:

    digitsPattern + lettersPattern(1)


TF = contains(str,pat);
str(TF)
ans = 
"221B Baker St."

pattern オブジェクトを作成する関数の一覧については、patternを参照してください。

ライブ スクリプトを開く

名前の string 配列を作成します。一部の名前に Ann または Paul が含まれます。

str = ["Mary Ann Jones","Christopher Matthew Burns","John Paul Smith"]
str = 1×3 string
    "Mary Ann Jones"    "Christopher Matthew Burns"    "John Paul Smith"

Ann または Paul が含まれる str の要素を検索します。

pat = ["Ann","Paul"];
TF = contains(str,pat)
TF = 1×3 logical array

   1   0   1

TF を str のインデックスとして使用します。

str(TF)
ans = 1×2 string
    "Mary Ann Jones"    "John Paul Smith"
ライブ スクリプトを開く

名前を含む string 配列を作成します。大文字小文字の区別を無視して、anne を含む名前を判別します。

string は二重引用符を使用して作成できます。

str = ["Anne","Elizabeth","Marianne","Tracy"]
str = 1×4 string
    "Anne"    "Elizabeth"    "Marianne"    "Tracy"


pat = "anne";
TF = contains(str,pat,'IgnoreCase',true)
TF = 1×4 logical array

   1   0   1   0

anne を含む string を表示します。TF を str のインデックスとして使用します。

str(TF)
ans = 1×2 string
    "Anne"    "Marianne"
ライブ スクリプトを開く

食品のリストを含む文字ベクトルを作成します。異なる食品の名前が文字ベクトル内にあるかどうかを判別します。

chr = 'peppers, onions, and mushrooms';
TF = contains(chr,'onion')
TF = logical
   1


TF = contains(chr,'pineapples')
TF = logical
   0

入力引数

すべて折りたたむ

入力テキスト。string 配列、文字ベクトルまたは文字ベクトルの cell 配列として指定します。

検索パターン。次のいずれかとして指定します。

  • string 配列

  • 文字ベクトル

  • 文字ベクトルの cell 配列

  • pattern 配列

ヒント

  • 文字を含まない string ("") または文字を含まない文字ベクトル ('') は、すべての string の部分文字列です。したがって、contains では、このような部分文字列がどの入力テキストにも必ず含まれていると判定されます。詳細については、空の string と欠損値のテストを参照してください。

拡張機能

すべて展開する

バージョン履歴

R2016b で導入

参考

| | | | | | | | |

トピック