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));
