最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

contains

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

構文

TF = contains(str,pattern)

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

説明

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

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

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

例

単一のパターンの検索

名前を含む string 配列を作成します。Paul を含む文字列を判別します。

R2017a 以降、二重引用符を使用して string を作成できるようになりました。

str = ["Mary Ann Jones","Paul Jay Burns","John Paul Smith"]

str = 1x3 string array
    "Mary Ann Jones"    "Paul Jay Burns"    "John Paul Smith"

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

pattern = "Paul";
TF = contains(str,pattern)

TF = 1x3 logical array

   0   1   1

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

str(TF)

ans = 1x2 string array
    "Paul Jay Burns"    "John Paul Smith"

複数のパターンの検索

名前を含む string 配列を作成します。Ann または Paul のいずれかを含む文字列を判別します。

R2017a 以降、二重引用符を使用して string を作成できるようになりました。

str = ["Mary Ann Jones","Christopher Matthew Burns","John Paul Smith"]

str = 1x3 string array
    "Mary Ann Jones"    "Christopher Matth..."    "John Paul Smith"

pattern = ["Ann","Paul"];
TF = contains(str,pattern)

TF = 1x3 logical array

   1   0   1

Ann または Paul のいずれかを含む文字列を表示します。TF を str のインデックスとして使用します。

str(TF)

ans = 1x2 string array
    "Mary Ann Jones"    "John Paul Smith"

大文字小文字の区別を無視

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

R2017a 以降、二重引用符を使用して string を作成できるようになりました。

str = ["Anne","Elizabeth","Marianne","Tracy"]

str = 1x4 string array
    "Anne"    "Elizabeth"    "Marianne"    "Tracy"

pattern = "anne";
TF = contains(str,pattern,'IgnoreCase',true)

TF = 1x4 logical array

   1   0   1   0

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

str(TF)

ans = 1x2 string array
    "Anne"    "Marianne"

文字ベクトルにパターンが含まれるかどうかを判別

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

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

TF = logical
   1

TF = contains(chr,'pineapples')

TF = logical
   0

入力引数

str — 入力テキスト

string 配列 | 文字ベクトル | 文字ベクトルの cell 配列

入力文字列。

データ型: string | char | cell

pattern — 検索パターン

string 配列 | 文字ベクトル | 文字ベクトルの cell 配列

検索パターン。string 配列、文字ベクトルまたは文字ベクトルの cell 配列として指定します。

データ型: string | char | cell

拡張機能

tall 配列

メモリの許容量を超えるような多数の行を含む配列を計算します。

この関数は tall 配列を完全にサポートしています。詳細については、tall 配列を参照してください。

C/C++ コード生成

MATLAB® Coder™ を使用して C および C++ コードを生成します。

使用上の注意事項および制限事項:

• str と pattern は、string スカラー、文字ベクトル、または 1 つ以下の文字ベクトルを含む cell 配列でなければなりません。

分散配列

Parallel Computing Toolbox™ を使用して、クラスターの結合メモリ上で大きなアレイを分割します。

この関数は分散配列を完全にサポートしています。詳細については、分散配列を使用した MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

参考

endsWith | find | ismember | regexp | startsWith | strcmp | strfind

トピック

• string 配列の作成
• テキストの検索と置換
• テキストの比較
• 空の string と欠損値のテスト

R2016b で導入