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

endsWith

string がパターンで終了しているかどうかを判別

構文

TF = endsWith(str,pattern)

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

説明

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

pattern が複数のパターンを含む配列の場合、endsWith は、str が pattern のいずれかの要素で終了していることを検出した場合に、1 を返します。

TF = endsWith(str,pattern,'IgnoreCase',true) は、str が pattern で終了しているかどうか判別するときに、大文字小文字の区別を無視します。

例

string がパターンで終了しているかどうかを判別

ファイル名を含む string 配列を作成します。.gz 拡張子で終了するファイル名を判別します。

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

str = ["abstract.docx","data.tar.gz","mycode.m"; ...
       "data-analysis.ppt","results.ptx","temp-archive.gz"]

str = 2x3 string array
    "abstract.docx"        "data.tar.gz"    "mycode.m"       
    "data-analysis.ppt"    "results.ptx"    "temp-archive.gz"

1 に等しい各要素の位置が、.gz で終了する str 内の文字列の位置に対応する logical 配列を返します。

pattern = ".gz";
TF = endsWith(str,pattern)

TF = 2x3 logical array

   0   1   0
   0   0   1

.gz で終了するファイル名を表示します。TF を str のインデックスとして使用します。

str(TF)

ans = 2x1 string array
    "data.tar.gz"
    "temp-archive.gz"

複数パターンに対して string の終了をテスト

ファイル名を含む string 配列を作成します。.docx、.xlsx または .gz の拡張子で終了するファイル名を判別します。

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

str = ["data.tar.gz","mycode.m","outputs.xlsx","results.pptx"]

str = 1x4 string array
    "data.tar.gz"    "mycode.m"    "outputs.xlsx"    "results.pptx"

pattern = [".docx",".xlsx",".gz"];
TF = endsWith(str,pattern)

TF = 1x4 logical array

   1   0   1   0

.docx、.xlsx または .gz で終了するファイル名を表示します。TF を str のインデックスとして使用します。

str(TF)

ans = 1x2 string array
    "data.tar.gz"    "outputs.xlsx"

string の終了のテスト時に大文字小文字の区別を無視

ファイル名を含む string 配列を作成します。大文字小文字の区別を無視して、.gz 拡張子で終了するファイル名を判別します。

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

str = ["DATA.TAR.GZ","mycode.m","SUMMARY.PPT","tmp.gz"]

str = 1x4 string array
    "DATA.TAR.GZ"    "mycode.m"    "SUMMARY.PPT"    "tmp.gz"

pattern = ".gz";
TF = endsWith(str,pattern,'IgnoreCase',true)

TF = 1x4 logical array

   1   0   0   1

.gz で終了するファイル名を表示します。TF を str のインデックスとして使用します。

str(TF)

ans = 1x2 string array
    "DATA.TAR.GZ"    "tmp.gz"

文字ベクトルがパターンで終了しているかどうかを判別

ファイル名を含む文字ベクトルを作成します。名前が指定された拡張子で終了しているかどうかを判別します。

chr = 'MyLatestPaper.docx'

chr = 
'MyLatestPaper.docx'

TF = endsWith(chr,'docx')

TF = logical
   1

TF = endsWith(chr,'gz')

TF = logical
   0

入力引数

str — 入力テキスト

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

入力テキスト。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)を参照してください。

参考

contains | find | regexp | startsWith | strcmp | strfind

トピック

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

R2016b で導入