replaceBetween

始点と終点の間の部分文字列の置換

構文

newStr = replaceBetween(str,startPat,endPat,newText)

newStr = replaceBetween(str,startPos,endPos,newText)

newStr = replaceBetween(___,'Boundaries',bounds)

説明

newStr = replaceBetween(str,startPat,endPat,newText) は、str 内の部分文字列を newText 内のテキストで置き換えます。置き換えられる部分文字列は、部分文字列 startPat と endPat の間に出現します。ただし、replaceBetween は startPat および endPat 自体は置き換えません。replaceBetween は結果を newStr として返します。引数 newText は置き換える部分文字列とは異なる文字数をもつことができます。

str が string 配列または文字ベクトルの cell 配列の場合、replaceBetween は str の各要素の部分文字列を置き換えます。出力引数 newStr のデータ型は、str と同じです。

newStr = replaceBetween(str,startPos,endPos,newText) は、str 内の部分文字列を置き換えます。置き換えられる部分文字列は、str 内の startPos と endPos の間の位置に出現し、これらの位置にある文字を含みます。

newStr = replaceBetween(___,'Boundaries',bounds) は、前述の任意の構文で指定した始点と終点について、含めるか除外するかを指示します。bounds が 'inclusive' の場合はそれらを含め、bounds が 'exclusive' の場合は除外します。たとえば、replaceBetween(str,startPat,endPat,newText,'Boundaries','inclusive') は、startPat、endPat およびそれらの間にあるすべてのテキストを newText で指定されたテキストに置き換えます。

例

部分文字列の間のテキストを置換

string 配列を作成し、部分文字列の間に出現するテキストを置き換えます。

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

str = "The quick brown fox"

str = 
"The quick brown fox"

部分文字列 quick と fox の間に出現するテキストを置き換えます。関数 replaceBetween は、出力でテキストを置き換えますが、quick と fox は置き換えません。

newStr = replaceBetween(str,"quick "," fox","red")

newStr = 
"The quick red fox"

string 配列の各要素にある部分文字列を置き換えます。開始インジケーターと終了インジケーターとして異なる部分文字列を指定する場合、それらを含む string 配列または cell 配列は、str と同じサイズでなければなりません。置換テキストも、同じサイズの string 配列または cell 配列内になければなりません。

str = ["The quick brown fox jumps";"over the lazy dog"]

str = 2×1 string
    "The quick brown fox jumps"
    "over the lazy dog"

newText = ["red";"sleeping"];
newStr = replaceBetween(str,["quick ";"the "],[" fox";" dog"],newText)

newStr = 2×1 string
    "The quick red fox jumps"
    "over the sleeping dog"

指定したパターンの間のテキストを置換

R2020b 以降

"internationalization" について "i18n" のような省略形を作成します。これを行うには、単語の最初と最後の文字の間のテキストを文字数に置き換えます。

まず、string 配列を作成します。

str = ["globalization";
       "internationalization";
       "localization"]

str = 3×1 string
    "globalization"
    "internationalization"
    "localization"

文字列の最初と最後の文字が一致するパターンを作成します。関数 textBoundary は文字列の最初と最後の境界に一致しますが、呼び出し lettersPattern(1) は任意の文字と一致します。

startPat = textBoundary + lettersPattern(1)

startPat = pattern
  Matching:

    textBoundary + lettersPattern(1)

endPat = lettersPattern(1) + textBoundary

endPat = pattern
  Matching:

    lettersPattern(1) + textBoundary

str 内の各 string の長さを求めます。最初と最後の文字を考慮して、各長さから 2 を減算します。長さを文字列に変換します。

L = strlength(str) - 2;
L = string(L)

L = 3×1 string
    "11"
    "18"
    "10"

str の要素の省略形を作成します。最初と最後の文字の間の文字を L の要素に置き換えます。

newStr = replaceBetween(str,startPat,endPat,L)

newStr = 3×1 string
    "g11n"
    "i18n"
    "l10n"

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

開始位置と終了位置の間の部分文字列を置換

string 配列を作成し、数値で指定した開始位置と終了位置の間の部分文字列を置き換えます。

string は二重引用符を使用して作成できます。名前を含む string を作成します。ミドル ネームを置き換えるため、string の 7 番目と 11 番目の位置を指定します。

str = "Edgar Allen Poe"

str = 
"Edgar Allen Poe"

newStr = replaceBetween(str,7,11,'A.')

newStr = 
"Edgar A. Poe"

string 配列の各要素にある部分文字列を置き換えます。数値配列を使用して異なる開始位置と終了位置を指定する場合、数値配列は入力 string 配列と同じサイズでなければなりません。置換テキストも、同じサイズの string 配列または cell 配列内になければなりません。

str = ["Edgar Allen Poe";"Louisa May Alcott"]

str = 2×1 string
    "Edgar Allen Poe"
    "Louisa May Alcott"

newText = ["A.";"M."];
newStr = replaceBetween(str,[7;8],[11;10],newText)

newStr = 2×1 string
    "Edgar A. Poe"
    "Louisa M. Alcott"

境界値の包含/排他を指定してテキストを置換

境界値を含めるかどうかを強制的に指定して string 配列の境界内のテキストを置き換えます。包含境界の場合、replaceBetween はテキストと共に境界も置き換えます。排他境界の場合、replaceBetween は境界を置き換えません。

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

str = "small|medium|large"

str = 
"small|medium|large"

6 番目と 13 番目の位置の間にあるテキストを置き換えます。これらの位置にある文字は置き換えません。

newText = "regular";
newStr = replaceBetween(str,6,13,newText,'Boundaries','exclusive')

newStr = 
"small|regular|large"

2 つの部分文字列の間にあるテキストと、これらの部分文字列自体も置き換えます。

str = "The quick brown fox jumps over the lazy dog"

str = 
"The quick brown fox jumps over the lazy dog"

newText = "red bird flies";
newStr = replaceBetween(str,'brown','jumps',newText,'Boundaries','inclusive')

newStr = 
"The quick red bird flies over the lazy dog"

文字ベクトル内の位置間のテキストを置換

文字ベクトルを作成し、開始位置と終了位置の間のテキストを置き換えます。

chr = 'mushrooms, peppers, and onions'

chr = 
'mushrooms, peppers, and onions'

newChr = replaceBetween(chr,12,18,'pineapple')

newChr = 
'mushrooms, pineapple, and onions'

部分文字列の間のテキストを置き換えます。

newChr = replaceBetween(chr,'mushrooms,',' and',' extra cheese,')

newChr = 
'mushrooms, extra cheese, and onions'

入力引数

str — 入力テキスト

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

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

startPat — 開始位置をマークするテキストまたはパターン

string 配列 | 文字ベクトル | 文字ベクトルの cell 配列 | pattern 配列 (R2020b 以降)

置き換えるテキストの開始位置をマークするテキストまたはパターン。次のいずれかとして指定します。

• string 配列

• 文字ベクトル

• 文字ベクトルの cell 配列

• pattern 配列 "(R2020b 以降)"

str が string 配列または文字ベクトルの cell 配列の場合、str の各要素の部分文字列を置き換えることができます。すべての部分文字列の開始位置が同じであるか、あるいは str の要素ごとに開始位置が異なるかを指定できます。

• 同じ開始位置を指定するには、startPat を文字ベクトル、string スカラー、または pattern オブジェクトとして指定します。

• 異なる開始位置を指定するには、startPat を string 配列、文字ベクトルの cell 配列、または pattern 配列として指定します。

例: replaceBetween(str,"AB","YZ",newText) は、str の各要素にある AB と YZ の間の部分文字列を newText で指定したテキストに置き換えます。

例: str が 2 行 1 列の string 配列の場合、replaceBetween(str,["AB";"FG"],["YZ";"ST"],newText) は、str(1) 内にある AB と YZ の間の部分文字列、および str(2) 内にある FG と ST の間の部分文字列を置き換えます。

endPat — 終了位置をマークするテキストまたはパターン

string 配列 | 文字ベクトル | 文字ベクトルの cell 配列 | pattern 配列 (R2020b 以降)

置き換えるテキストの終了位置をマークするテキストまたはパターン。次のいずれかとして指定します。

• string 配列

• 文字ベクトル

• 文字ベクトルの cell 配列

• pattern 配列 "(R2020b 以降)"

str が string 配列または文字ベクトルの cell 配列の場合、str の各要素の部分文字列を置き換えることができます。すべての部分文字列の終了位置が同じであるか、あるいは str の要素ごとに終了位置が異なるかを指定できます。

• 同じ終了位置を指定するには、endPat を文字ベクトル、string スカラー、または pattern オブジェクトとして指定します。

• 異なる終了位置を指定するには、endPat を string 配列、文字ベクトルの cell 配列、または pattern 配列として指定します。

例: replaceBetween(str,"AB","YZ",newText) は、str の各要素にある AB と YZ の間の部分文字列を newText で指定したテキストに置き換えます。

例: str が 2 行 1 列の string 配列の場合、replaceBetween(str,["AB";"FG"],["YZ";"ST"],newText) は、str(1) 内にある AB と YZ の間の部分文字列、および str(2) 内にある FG と ST の間の部分文字列を置き換えます。

startPos — 開始位置

数値配列

開始位置。数値配列として指定します。

str が string 配列または文字ベクトルの cell 配列の場合、startPos は数値スカラー、または str と同じサイズの数値配列にすることができます。

例: replaceBetween(str,5,9,newText) は、str の各要素の 5 ～ 9 番目の位置にある部分文字列を newText で指定されたテキストに置き換えます。

例: str が 2 行 1 列の string 配列の場合、replaceBetween(str,[5;10],[9;21],newText) は、str(1) の 5 ～ 9 番目の位置にある部分文字列と、str(2) の 10 ～ 21 番目の位置にある部分文字列を置き換えます。

endPos — 終了位置

数値配列

終了位置。数値配列として指定します。

str が string 配列または文字ベクトルの cell 配列の場合、endPos は数値スカラー、または str と同じサイズの数値配列にすることができます。

例: replaceBetween(str,5,9,newText) は、str の各要素の 5 ～ 9 番目の位置にある部分文字列を newText で指定されたテキストに置き換えます。

例: str が 2 行 1 列の string 配列の場合、replaceBetween(str,[5;10],[9;21],newText) は、str(1) の 5 ～ 9 番目の位置にある部分文字列と、str(2) の 10 ～ 21 番目の位置にある部分文字列を置き換えます。

newText — 置換テキスト

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

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

str が string 配列または文字ベクトルの cell 配列の場合、newText は、文字ベクトル、string スカラー、str と同じサイズの string 配列または cell 配列のいずれかとして指定できます。

例: replaceBetween(str,"AB","YZ","efg") は str の各要素で AB と YZ の間にある部分文字列を efg に置き換えます。

例: str が 2 行 1 列の string 配列である場合、replaceBetween(str,["AB";"FG"],["YZ";"ST"],["efg";"lmnop"]) は、str(1) 内にある AB と YZ の間の部分文字列を efg に置き換え、str(2) 内にある FG と ST の間の部分文字列を lmnop に置き換えます。

bounds — 境界の動作

'inclusive' | 'exclusive'

境界の動作。'inclusive' または 'exclusive' として指定します。境界の動作が inclusive である場合、前の引数で指定された始点と終点は置き換え対象のテキストに含められます。境界の動作が exclusive である場合、開始位置と終了位置は含まれません。

出力引数

newStr — 出力テキスト

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

出力テキスト。string 配列、文字ベクトルまたは文字ベクトルの cell 配列として返されます。str と newStr は同じデータ型です。

拡張機能

tall 配列

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

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

C/C++ コード生成

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

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

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

スレッドベースの環境

MATLAB® の backgroundPool を使用してバックグラウンドでコードを実行するか、Parallel Computing Toolbox™ の ThreadPool を使用してコードを高速化します。

この関数はスレッドベースの環境を完全にサポートしています。詳細については、スレッドベースの環境での MATLAB 関数の実行を参照してください。

分散配列

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

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

バージョン履歴

R2016b で導入

参考

split | join | replace | erase | eraseBetween | extract | extractBetween | pattern | lettersPattern | textBoundary | insertAfter | insertBefore | count

トピック

• string 配列の作成
• テキストの検索と置換
• パターン表現の作成
• 空の string と欠損値のテスト