A1sCodeбиблиотека 1С

A1sS.ReplaceText

Replaces text with support for case sensitivity and replace-all.

Скачать A1sS.bsl →

Сигнатура


Function ReplaceText(SourceText,
    SearchText,
    ReplaceText,
    CaseSensitive = True,
    ReplaceAll = True,
    ConfigPerformanceLog = False,
    ConfigDebugMode = False)

Как работает

  • Основана на стандартной замене подстрок (без регулярок).
  • Поддерживает чувствительность к регистру.

Параметры

  • SourceText — Source text.
  • SearchText — Text to find.
  • ReplaceText — Replacement text.
  • CaseSensitive — Case sensitive search (Boolean, по умолчанию: True).
  • ReplaceAll — Replace all occurrences (Boolean, по умолчанию: True).
  • ConfigPerformanceLog — Performance log (Boolean, опционально: True).
  • ConfigDebugMode — Debug mode (Boolean, опционально: True).

Возврат

Возвращает: Строка.

Примеры (по нарастающей)

1) Базово 

A1sS.ReplaceText("красный, Красный, КРАСНЫЙ", "красный", "зелёный");
// "зелёный, Красный, КРАСНЫЙ"
2) Без учёта регистра 

Опции = Новый Структура("CaseSensitive", Ложь);
A1sS.ReplaceText("красный, Красный, КРАСНЫЙ", "красный", "зелёный", Опции);
// "зелёный, зелёный, зелёный"
3) Только целые слова 

Опции = Новый Структура("WholeWord", Истина);
A1sS.ReplaceText("контракт, контрактор", "контракт", "договор", Опции);
// "договор, контрактор"
4) Лимит замен 

Опции = Новый Структура("Limit", 1);
A1sS.ReplaceText("a a a a", "a", "b", Опции);
// "b a a a"

Нюансы

  • Для сложных шаблонов/масок используйте A1sS.RegexReplace.
  • При замене целых слов учитывайте язык и правила разделителей слов.

Рядом