Spec-Zone.ru › ColdFusion

replace

Заменяет вхождения подстроки substring1 в строке на obj в указанной области. Поиск чувствителен к регистру. Функция возвращает исходную строку с выполненными заменами.

replace(string, substring1, obj [, scope]) → returns string

Синтаксис функции-члена

string.replace(substring1, obj[, scope])

  • CF
  • Lucee
  • BL 1.0.0+
  • См. также: replaceNoCase replaceList reReplace

    Аргументы

    string строка
    Обязательный

    Строка для поиска

    substring1 строка
    Обязательный

    Подстрока для поиска в строке

    obj любой тип
    Обязательный

    Строка, которой нужно заменить substring1. Начиная с CF 2016+ в этом аргументе также можно передать функцию обратного вызова function(transform, position, original).

    scope строка
    По умолчанию: one

    * one: заменить первое вхождение * all: заменить все вхождения
    Значения:
    • one
    • all

    start число
    По умолчанию: 1

    CF 2021+ Позиция, с которой начинается поиск в строке.

    Ссылки дополнительная информация о replace

    • Регулярные выражения — практические примеры — функции find, replace и match поддерживают поиск с учетом и без учета регистра.

    Примеры
    Пример вызова функции replace

    Замена заглавной 'U' на строчную 'u'

    Замена с использованием синтаксиса скриптов

    getVal = replace("ColdFUsion", "U", "u");
    writeDump(getVal);

    Ожидаемый результат: ColdFusion

    Замена заглавной 'O' на строчную 'o' только один раз

    Аналогичный пример с использованием тегов

    <cfset getVal1 = replace("COldFusiOn", "O", "o", "ONE") />
    <cfdump var = #getVal1# />

    Ожидаемый результат: ColdFusiOn

    Пример использования функции обратного вызова

    В CF 2016+ в третий аргумент функции replace можно передать функцию обратного вызова

    public function upCase(pattern, position, orig) {
        return uCase(pattern);
    }
    result = replace("A man a plan a canal.","an", upCase , "ALL");
    writeOutput(result);

    Ожидаемый результат: A mAN a plAN a cANal.

    Пример с аргументом start (замена строчной 'o' на заглавную 'O', начиная с третьей позиции)

    В CF 2021+ можно указать позицию, с которой начинается поиск в строке

    getRes = replace("Love ColdFusion", "o", "O","ALL","3");
    writeOutput(getRes);

    Ожидаемый результат: Love COldFusiOn

    © 2012–present Foundeo, Inc. and the CFDocs contributors.
    Licensed under the MIT License.
    ColdFusion is a trademark of Adobe Systems Incorporated.
    https://cfdocs.org/replace

    Spec-Zone.ru

    Настройки Оффлайн Что нового Помощь О нас
    Spec-Zone .ru
    спецификации, руководства, описания, API