InRange

InRange (Логические функции)
Объект: Функции общего назначения Статус разработки: Реализована Тип: Магическая функция или конструкция Обращение к БД: Нет Исключения: Аргументы неверного типа Визуальность: Нет

• Начальная страница
• Общее описание
• Объекты
• Функции общего назначения

Магическая функция проверяет, присутствует ли значение поиска в диапазонах значений для проверки. Искомое значение может быть числом, датой или строкой. Функция может упростить конструкцию If. Для проверки используются нестрогие неравенства ( >= или =< ). Функция возвращает 1, если искомое значение присутствует по крайней мере в одном диапазоне. Вычисление следующих аргументов диапазона не выполняется, если текущий удовлетворил условию поиска. При смешивании типов данных (к примеру, при поиске числа в диапазонах дат), значение считается ненайденным.

Синтаксис

InRange(<Значение поиска>,<Начало диапазона 1>,<Конец диапазона 1>,<Начало диапазона 2>,<Конец диапазона 2>...):<Искомое значение присутствует в диапазоне (диапазонах) (INT)>

Аргументы

• <Значение поиска> - Значение для поиска.
• <Начало диапазона X> - (необязательный аргумент) Значения начала дипазона.
• <Конец диапазона X> - (необязательный аргумент) Значения окончания дипазона.

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

Возвращает 1, если значение поиска найдено в диапазонах поиска, заданных другими аргументами, иначе возвращает 0.

Примеры

If not InRange(зДата,НачДата,КонДата) Then
  Message("Выбрана неверная дата","!");
  Exit;
EndIf;

If (зДата<НачДата)Or(зДата>КонДата) Then
  Message("Выбрана неверная дата","!");
  Exit;
EndIf;

//Обе представленные конструкции имеют одинаковую функцию, при этом первая проще для понимания.