Replace および Substitute 関数

適用対象: キャンバス アプリ Dataverse 数式列 デスクトップ フロー モデル駆動型アプリ Power Pages Power Platform CLI

テキストの文字列の一部を別の文字列に置換します。

Description

Replace 関数は、開始位置と長さによって、置換するテキストを識別します。

Substitute 関数は、文字列を照合することで、置換するテキストを識別します。 複数の一致が見つかった場合、それらすべてを置き換えるか、または置き換えるものを指定できます。

1 つの文字列を渡すと、変更された文字列が戻り値として返されます。 文字列を含む単一列 テーブル を渡すと、戻り値は、変更された文字列の Value 列を持つ単一列テーブルになります。 複数列テーブルがある場合は、テーブルの使用 に関するページの説明に従って、そのテーブルを単一列テーブルにすることができます。

構文

置換( 文字列, 開始位置, 文字数、 NewString )

• 文字列 - 必須。 操作の対象となる文字列。
• StartingPosition - 必須。 置換を開始する文字の位置。 String の最初の文字の位置は 1 です。
• NumberOfCharacters - 必須。 String で置換する文字の数。
• NewString - 必須。 置換後の文字列。 この引数の文字数は、NumberOfCharacters 引数とは異なっていてもかまいません。

置換( 文字列, 古い文字列, 新しい文字列 [, インスタンス番号 ] )

• 文字列 - 必須。 操作の対象となる文字列。
• OldString - 必須。 置換の対象となる文字列。
• NewString - 必須。 置換後の文字列。 OldString と NewString の長さは異なる場合があります。
• InstanceNumber - オプション。 String に複数のインスタンスが含まれている場合、この引数を使用して OldString のどのインスタンスを置換するか指定します。 この引数を指定しない場合、すべてのインスタンスが置き換えられます。

置換( SingleColumnTable, 開始位置, 文字数, 新しい文字列 )

• SingleColumnTable - 必須。 操作対象となる複数の文字列の単一列テーブル。
• StartingPosition - 必須。 置換を開始する文字の位置。 テーブル内の各文字列の最初の文字の位置は 1 です。
• NumberOfCharacters - 必須。 各文字列で置換する文字の数。
• NewString - 必須。 置換後の文字列。 この引数の文字数は、NumberOfCharacters 引数とは異なっていてもかまいません。

置換( SingleColumnTable, OldString, NewString [, InstanceNumber ] )

• SingleColumnTable - 必須。 操作対象となる複数の文字列の単一列テーブル。
• OldString - 必須。 置換の対象となる文字列。
• NewString - 必須。 置換後の文字列。 OldString と NewString の長さは異なる場合があります。
• InstanceNumber - オプション。 String に複数のインスタンスが含まれている場合、この引数を使用して OldString のどのインスタンスを置換するか指定します。 この引数を指定しない場合、すべてのインスタンスが置き換えられます。

例

計算式	内容	結果
置換( "abcdefghijk", 6, 5, "*" )	「abcdefghijk」の 5 つの文字を、6 番目の文字 (「f」) で始まる単一の「*」文字に置き換えます。	「abcde*k」
置換( "2019", 3, 2, "20" )	「2019」の最後の 2 文字を「20」に置き換えます。	「2020」
置換( "123456", 1, 3, "_" )	「123456」の最初の 3 つの文字を単一の「_」文字に置き換えます。	「_456」
置換(「売上データ」、「売上」、「コスト」)	文字列「Cost」を「Sales」に置換します。	「Cost Data」
代替(「2018年第1四半期」、「1」、「2」、「1」)	4 番目の引数 (InstanceNumber) に 1 が指定されているので、最初の「1」のインスタンスのみを「2」に置換します。	「2018 年第 2 四半期」
代替(「2011年第1四半期」、「1」、「2」、「3」)	4 番目の引数 (InstanceNumber) に 3 が指定されているので、3 番目の「1」のインスタンスのみを「2」に置換します。	「2012 年第 1 四半期」
代替(「2011年第1四半期」、「1」、「2」)	4 番目の引数 (InstanceNumber) が指定されていないので、「1」のすべてのインスタンスは「2」に置換されます。	「2022 年第 2 四半期」
交換する（ [ "Quarter 1, 2018", "Quarter 2, 2011", "Quarter 4, 2019" ], 9, 1, "3" )	単一列テーブルの各レコード内で 9 番目の文字を「3」に置き換えます。	次の値を含む Value 列を持つ単一列テーブル: [ "Quarter 3, 2018", "Quarter 3, 2011", "Quarter 3, 2019" ]
代わりの（ [ "Qtr 1, 2018", "Quarter 1, 2011", "Q1, 2019" ], "1", "3", 1 )	4 番目の引数 (InstanceNumber) に 1 の値が指定されている場合、単一列テーブルの各レコード内で「1」の最初のインスタンスのみが「3」に置き換えられます。	次の値を含む Value 列を持つ単一列テーブル: [ "Qtr 3, 2018", "Quarter 3, 2011", "Q3,2019"]
代わりの（ [ "Qtr 1, 2018", "Quarter 1, 2011", "Q1, 2019" ], "1", "3" )	4 番目の引数 (InstanceNumber) が指定されていない場合、単一列テーブルの各レコード内で「1」のすべてのインスタンスが「3」に置換されます。	次の値を含む Value 列を持つ単一列テーブル: [ "Qtr 3, 2038", "Quarter 3, 2033", "Q3,2039"]