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

insertBefore

指定した部分文字列の前に文字列を挿入

構文

newStr = insertBefore(str,endStr,newText)

newStr = insertBefore(str,endPos,newText)

説明

newStr = insertBefore(str,endStr,newText) は str 内の endStr で指定された部分文字列の前に newText を挿入し、結果を newStr として返します。endStr が str で複数回現れる場合、insertBefore はすべての endStr の前にテキストを挿入します。

str が string 配列または文字ベクトルの cell 配列の場合、insertBefore は newText を str の各要素に挿入します。出力引数 newStr のデータ型は、str と同じです。

newStr = insertBefore(str,endPos,newText) は、str 内の endPos で指定された位置の前に newText で指定されたテキストを挿入します。

例

テキストを部分文字列の前に挿入

string 配列を作成し、テキストを部分文字列の前に挿入します。

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

str = "bread cheese wine"

str = 
"bread cheese wine"

文字列内の各スペース文字の前にコンマを挿入します。関数 insertBefore は一致する各部分文字列の前にテキストを挿入します。

newStr = insertBefore(str," ",",")

newStr = 
"bread, cheese, wine"

部分文字列を string 配列の各要素に挿入します。異なる部分文字列を位置として指定する場合、その部分文字列は、str と同じサイズの string 配列または cell 配列に含まれていなければなりません。

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

str = 2x1 string array
    "The quick fox jumps"
    "over the dog"

newStr = insertBefore(str,[" fox";" dog"],[" brown";" lazy"])

newStr = 2x1 string array
    "The quick brown fox jumps"
    "over the lazy dog"

部分文字列を位置の前に挿入

string 配列を作成し、部分文字列を挿入する位置を指定します。

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

str = "James Maxwell"

str = 
"James Maxwell"

部分文字列を 7 番目の文字の前に挿入します。

newStr = insertBefore(str,7,"Clerk ")

newStr = 
"James Clerk Maxwell"

部分文字列を string 配列の各要素に挿入します。数値配列を使用して異なる位置を指定する場合、数値配列は入力 string 配列と同じサイズでなければなりません。

str = ["James Maxwell";"Carl Gauss"]

str = 2x1 string array
    "James Maxwell"
    "Carl Gauss"

newStr = insertBefore(str,[7;6],["Clerk ";"Friedrich "])

newStr = 2x1 string array
    "James Clerk Maxwell"
    "Carl Friedrich Gauss"

文字ベクトルでテキストを位置の前に挿入

文字ベクトルを作成し、指定した位置の前にテキストを挿入します。

chr = 'mushrooms and onions'

chr = 
'mushrooms and onions'

テキストを 10 番目の位置の前に挿入します。

newChr = insertBefore(chr,10,', peppers,')

newChr = 
'mushrooms, peppers, and onions'

テキストを部分文字列の前に挿入します。

newChr = insertBefore(chr,' and',', peppers,')

newChr = 
'mushrooms, peppers, and onions'

入力引数

str — 入力テキスト

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

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

データ型: string | char | cell

endStr — 部分文字列 (この前にテキストが挿入される)

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

部分文字列 (この前にテキストが挿入される)。string 配列、文字ベクトルまたは文字ベクトルの cell 配列として指定します。

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

データ型: string | char | cell

endPos — 終了位置 (この前にテキストが挿入される)

数値配列

終了位置 (この前にテキストが挿入される)。数値配列として指定します。

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

データ型: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

newText — 挿入するテキスト

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

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

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

データ型: string | char | cell

出力引数

newStr — 出力テキスト

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

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

データ型: string | char | cell

拡張機能

tall 配列

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

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

C/C++ コード生成

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

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

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

分散配列

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

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

参考

erase | eraseBetween | extractAfter | extractBefore | insertAfter | join | split

トピック

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

R2016b で導入