IsEmpty

IsEmpty (Проверка аргумента)
Объект: Функции общего назначения Статус разработки: Реализована Тип: Функция Обращение к БД: Нет Визуальность: Нет

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

Функция возвращает 1, если аргумент является пустым объектом, иначе будет возвращен 0. Случаи, когда функция возвратит 1 (правда):

• Объект является пустым значением
• Целое число равно нулю
• Вещественное число равно нулю с точностью представления системы
• ANSI или UTF-16 строка имеет нулевую длину, либо состоит только из символов с кодами 32,9,13 или 10
• Объект типа дата равна '01.01.1601' (пустая дата) или '01.01.1900'.
• Объект базы данных не указывает на физический объект в базе данных (вид, либо тип не выбран, либо объект не имеет позиционирования (не задан внутренний код базы данных)). Если объект новый (не произведена его запись в базу данных), функция возвратит 0. Проверка, осуществляемая таким образом, аналогична конструкции <Переменная>.Selected()=0, однако, не будет вызывать исключения, если вид объекта не выбран, поэтому, безопаснее в использовании.

Во всех остальных случаях, функция возвратит 0.

Синтаксис

IsEmpty(<Аргумент>):<Является ли аргумент пустым объектом (INT)>

Аргументы

• <Аргумент> - Объект, который необходимо проверить.

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

Возвращает целое число.

Примеры

//Будет выведено 1 (объект базы данных с невыбранным типом)
Message(IsEmpty(DB));

//Будет выведено 1 (пустое значение)
Message(IsEmpty(GetNothing));

//Будет выведено 1 (объект не был позиционирован), если документ с видом Реализация существует в проекте
Message(IsEmpty(GetNothing("DOC.Реализация")));

//Будет выведено 0, если справочник с видом Номенклатура существует в проекте и элемент с реквизитом "Code" равным "000000000123" существует в базе данных.
aNom:=DB("Ref.Номенклатура","Code","000000000123");
Message(IsEmpty(aNom));

//Будет выведено 0, так как число 123 не равно нулю
Message(IsEmpty(123));

//Будет выведено 1, так как строка содержит только знаки переноса строки и табуляции
Message(IsEmpty(_NEWLINE+_TAB+_NEWLINE));