Функции Replace и Substitute в PowerAppsReplace and Substitute functions in PowerApps

Замена части текстовой строки другой строкой.Replace a portion of a string of text with another string.

ОписаниеDescription

В функции Replace текст, который требуется заменить, определяется начальной позицией и длиной.The Replace function identifies the text to replace by starting position and length.

Функция Substitute ищет текст, который нужно заменить, сравнивая его с определенной строкой.The Substitute function identifies the text to replace by matching a string. На случай если обнаружится несколько совпадений с этой строкой, можно указать, какую из них следует заменить.If more than one match is found, you can control which one is replaced.

Если передать одну строку, функция возвращает ее измененную версию.If you pass a single string, the return value is the modified string. Если передать содержащую строки таблицу из одного столбца, функция возвращает таблицу из одного столбца с измененными строками.If you pass a single-column table that contains strings, the return value is a single-column table of modified strings. Таблицу с несколькими столбцами можно преобразовать в таблицу с одним столбцом, как описано в статье об использовании таблиц.If you have a multi-column table, you can shape it into a single-column table, as working with tables describes.

СинтаксисSyntax

Replace(строка, начальная_позиция, количество_символов, новая_строка)Replace( String, StartingPosition, NumberOfCharacters, NewString )

  • строка — обязательный аргумент.String - Required. Это строка, с которой выполняется преобразование.The string to operate on.
  • начальная_позиция — обязательный аргумент.StartingPosition - Required. Позиция символа, с которого нужно начать замену.Character position to start the replacement. Первый символ аргумента строка находится в позиции 1.The first character of String is at position 1.
  • количество_символов — обязательный аргумент.NumberOfCharacters - Required. Число символов, которые нужно заменить в аргументе строка.The number of characters to replace in String.
  • новая_строка — обязательный аргумент.NewString - Required. Строка, которой нужно заменить текст в исходной строке.The replacement string. Количество символов в этом аргументе может отличаться от значения аргумента количество_символов.The number of characters in this argument can differ from the NumberOfCharacters argument.

Substitute(строка, старая_строка, новая_строка[, номер_вхождения])Substitute( String, OldString, NewString [, InstanceNumber ] )

  • строка — обязательный аргумент.String - Required. Это строка, с которой выполняется преобразование.The string to operate on.
  • старая_строка — обязательный аргумент.OldString - Required. Строка, которую требуется заменить.The string to replace.
  • новая_строка — обязательный аргумент.NewString - Required. Строка, которой нужно заменить текст в исходной строке.The replacement string. У аргументов старая_строка и новая_строка может быть разная длина.OldString and NewString can have different lengths.
  • номер_вхождения — необязательный аргумент.InstanceNumber - Optional. По умолчанию заменяется первое вхождение аргумента старая_строка.By default, the first instance of OldString is replaced. Если аргумент строка содержит несколько вхождений искомого текста, с помощью этого аргумента можно указать, какой из них следует заменить.If String contains more than one instance, you can specify which instance to replace.

Replace(таблица_с_одним_столбцом, начальная_позиция, количество_символов, новая_строка)Replace( SingleColumnTable, StartingPosition, NumberOfCharacters, NewString )

  • SingleColumnTable — обязательный аргумент.SingleColumnTable - Required. Таблица с одним столбцом, для строк в котором нужно выполнить преобразование.A single-column table of strings to operate on.
  • начальная_позиция — обязательный аргумент.StartingPosition - Required. Позиция символа, с которого нужно начать замену.Character position to start the replacement. Первый символ каждой строки из таблицы находится в позиции 1.The first character of each string in the table is at position 1.
  • количество_символов — обязательный аргумент.NumberOfCharacters - Required. Число символов, которые нужно заменить в каждой из строк.The number of characters to replace in each string.
  • новая_строка — обязательный аргумент.NewString - Required. Строка, которой нужно заменить текст в исходной строке.The replacement string. Количество символов в этом аргументе может отличаться от значения аргумента количество_символов.The number of characters in this argument can differ from the NumberOfCharacters argument.

Substitute(таблица_с_одним_столбцом, старая_строка, новая_строка[, номер_вхождения])Substitute( SingleColumnTable, OldString, NewString [, InstanceNumber ] )

  • SingleColumnTable — обязательный аргумент.SingleColumnTable - Required. Таблица с одним столбцом, для строк в котором нужно выполнить преобразование.A single-column table of strings to operate on.
  • старая_строка — обязательный аргумент.OldString - Required. Строка, которую требуется заменить.The string to replace.
  • новая_строка — обязательный аргумент.NewString - Required. Строка, которой нужно заменить текст в исходной строке.The replacement string. У аргументов старая_строка и новая_строка может быть разная длина.OldString and NewString can have different lengths.
  • номер_вхождения — необязательный аргумент.InstanceNumber - Optional. По умолчанию заменяется первое вхождение аргумента старая_строка.By default, the first instance of OldString is replaced. Если строки в таблице содержат несколько вхождений искомого текста, с помощью этого аргумента можно указать, какой из них следует заменить.If the table contains more than one instance, you can specify which instance to replace.