Перейти к содержанию

содержит

Функция содержит проверяет, встречается ли указанная подстрока внутри строки. Она подходит для условий, когда дальнейшее формирование документа зависит от наличия определённого текста в значении.

Синтаксис

содержит(Строка, Подстрока, Учитывать регистр)
  • Строка — обязательный параметр. Исходная строка, в которой выполняется поиск.
  • Подстрока — обязательный параметр. Последовательность символов, которую необходимо найти в строке.
  • Учитывать регистр — необязательный логический параметр. Определяет, учитывать ли различия между прописными и строчными буквами.

Если параметр Учитывать регистр не указан, регистр учитывается.

Чтобы выполнить поиск без учёта регистра, передайте в третьем параметре ложь.

Возвращаемое значение

Функция возвращает логическое значение:

  • True — указанная подстрока найдена в строке;
  • False — указанная подстрока в строке отсутствует.

Полученное значение можно использовать в условиях и других выражениях.

Особенности

Если Подстрока пустая, функция возвращает True.

Пример

Допустим, поле Условие оплаты содержит значение:

Оплата производится в течение 10 рабочих дней после поставки товара

Необходимо проверить, содержит ли значение поля слово ПОСТАВКИ, не учитывая регистр:

содержит(УсловиеОплаты, "ПОСТАВКИ", ложь)

Результат:

True

Поскольку в третьем параметре указано ложь, различие регистра не влияет на результат.