replace_strings()

Заменяет все строки на указанные строки.

Чтобы заменить отдельную строку, см . раздел replace_string().

Синтаксис

replace_strings(перезаписи текстовых, подстановок, )

Дополнительные сведения о соглашениях синтаксиса.

Параметры

Имя (название)	Type	Обязательно	Описание
text	string	✔️	Исходная строка.
Поиск	dynamic	✔️	Массив, содержащий строки подстановки. Элемент массива, который не является строкой, игнорируется.
Перезаписывает	dynamic	✔️	Массив, содержащий перезаписи. Элемент массива, который не является строкой, игнорируется (замена не выполнена).

Возвраты

Возвращает текст после замены всех совпадений подстановок оценкой перезаписей. Совпадения не перекрываются.

Примеры

Простая замена

Выполнить запрос

print Message="A magic trick can turn a cat into a dog"
| extend Outcome = replace_strings(
        Message,
        dynamic(['cat', 'dog']), // Lookup strings
        dynamic(['dog', 'pigeon']) // Replacements
        )

Сообщение	Результат
Волшебный трюк может превратить кота в собаку	Волшебный трюк может превратить собаку в голубь

Замена пустой строкой

Замена пустой строкой удаляет соответствующую строку.

Выполнить запрос

print Message="A magic trick can turn a cat into a dog"
| extend Outcome = replace_strings(
        Message,
        dynamic(['turn', ' into a dog']), // Lookup strings
        dynamic(['disappear', '']) // Replacements
        )

Сообщение	Результат
Волшебный трюк может превратить кота в собаку	Волшебный трюк может исчезнуть кот

Порядок замены

Порядок элементов соответствия имеет значение: более раннее совпадение имеет приоритет. Обратите внимание на разницу между результатом1 и Результатом2: This и Thwas.

Выполнить запрос

 print Message="This is an example of using replace_strings()"
| extend Outcome1 = replace_strings(
        Message,
        dynamic(['This', 'is']), // Lookup strings
        dynamic(['This', 'was']) // Replacements
        ),
        Outcome2 = replace_strings(
        Message,
        dynamic(['is', 'This']), // Lookup strings
        dynamic(['was', 'This']) // Replacements
        )

Сообщение	Результат1	Результат2
Это пример использования replace_strings()	Это был пример использования replace_strings()	Thwas был примером использования replace_strings()

Замена нестроки

Заменить элементы, которые не являются строками, не заменяются, и исходная строка хранится. Совпадение по-прежнему считается допустимым, и другие возможные замены не выполняются в соответствующей строке. В следующем примере "Это" не заменяется числовым 12345значением, и он остается в выходных данных, не затронутых возможным совпадением с "is".

Выполнить запрос

 print Message="This is an example of using replace_strings()"
| extend Outcome = replace_strings(
        Message,
        dynamic(['This', 'is']), // Lookup strings
        dynamic([12345, 'was']) // Replacements
        )

Сообщение	Результат
Это пример использования replace_strings()	Это был пример использования replace_strings()

Связанный контент

• Сведения о замене одной строки см. в разделе replace_string().
• Сведения о замене на основе регулярного выражения см. в разделе replace_regex().
• Сведения о замене набора символов см. в разделе translate().