FBUDF

INULLIF(VALUE1, VALUE2)

Linux, Win32

Возвращает NULL для подвыражения, если оно преобразуется в непустое значение; иначе возвращает значение подвыражения. Применимо только для числовых типов с фиксированной точкой и только в Firebird 1.0.x. В Firebird 1.5 и выше используйте внутреннюю функцию NULLIF()

Аргументы

VALUE1: столбец или вычисляемое выражение

VALUE2: константа или выражение, с которым сравнивается VALUE1. ЕСЛИ они равны, функция вернет HULL

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

NULL, если VALUE1 и VALUE равны; если равенства нет, будет возвращено VALUE 1

Замечания

INULLIFO имеет результат, эквивалентный использованию внутренней SQL-функции NULLIFO, реализованной в Firebird 1.5 и выше для числовых типов с фиксированной точкой

Внешняя функция INULLIFO существует в трех реализациях: две для 32-битовых и 16-битовых типов (inullif и dnullif), а третья для 64- битовых типов (i64nullif). Если вы хотите использовать ее с любыми числовыми типами с фиксированной точкой, объявите все реализации. Объявления можно найти в скрипте fbudf.sql в каталоге /UDF вашей инсталляции Firebird.

Не объявляйте реализацию i64nullif для баз данных, которые не поддерживают 64-битовые числа- например, для не перенесенной базы данных InterBase 5

Пример

Следующий оператор приведет к тому, что значение STOCK в таблице PRODUCTS будет установлено в NULL для всех строк, где оно имеет значение 0:

UPDATE PRODUCTS

SET STOCK = iNULLIF(STOCK, 0)

Связанные или похожие функции

См. также NULLIF() , sNullIf()

FBUDF

INVL(VALUE1, VALUE2)

Linux, Win32

Эта функция пытается повторить функцию Oracle NVL() только для числовых типов с фиксированной точкой. Она возвращает указанное непустое значение, если заданный столбец имеет значение NULL

Аргументы

VALUE1: столбец или выражение, включающее столбец. Типы с плавающей точкой не поддерживаются. При необходимости используйте в вашем выражении CAST() для преобразования значения в числовой тип.

VALUE2: выражение или константа, которая будет возвращаемым значением, если VALUE1 дает NULL

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

Непустое значение. Если VALUE1 не является NULL, то оно будет возвращаемым значением; иначе будет возвращаться VALUE1. Если и VALUE1, и VALUE2 имеют значение NULL, то будет возвращено значение NULL

Замечания

Логически эта функция эквивалентна простой форме функции COALESCE О версии 1.5, когда она используется со столбцом числового типа с фиксированной точкой, а именно COALESCE(VALUE1, VALUE2) .

Она должна рассматриваться как нерекомендуемая для Firebird версии 1.5 и выше.

Внешняя функция iNVL() существует в трех реализациях: две для 32-битовых и 16-битовых типа (invl и dnvi), а третья для 64-битовых типов (i64nvi). Если вы хотите использовать ее с любыми числовыми типами с фиксированной точкой, объявите все реализации. Объявления можно найти в скрипте fbudf.sql в каталоге /UDF вашей инсталляции Firebird.

Не объявляйте реализацию i64nvi для баз данных, которые не поддерживают 64-битовые числа - например, для не перенесенной базы данных InterBase 5

Пример

Следующий запрос возвращает 0, если STOCK имеет значение NULL:

SELECT

PRODUCT ID, PRODUCT NAME,

INVL(STOCK, 0)

FROM PRODUCTS;

Связанные или похожие функции

См. также sNVL(), iNullIf(), внутреннюю функцию COALESCE()

FBUDF

SNULLIF(VALUE1, VALUE2)

Linux, Win32

Возвращает NULL для подвыражения, если оно иначе возвращает значение этого подвыражения. Применимо только для символьных типов и должно быть использовано только в Firebird 1,0.x. В Firebird 1.5 и выше используйте NULLIFO

Аргументы

VALUE1: столбец или вычисляемое выражение.

VALUE2: константа или выражение, с которым сравнивается VALUE1. ЕСЛИ они равны, SNULLIF вернет NULL

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

NULL, если VALUE1 и VALUE2 равны. Если не равны, то возвращается VALUE1

Замечания

SNOLLIF имеет результат, эквивалентный использованию внутренней функции SQL NULLIFO, реализованной в Firebird 1.5 и выше с символьными типами

Пример

Следующий запрос устанавливает значение столбца IS_REGISTERED в NULL для всех столбцов, где его значение ' Т', a REGISTERED имеет значение NOLL:

UPDATE ATABLE

SET IS REGISTERED = SNOLLIF(IS REGISTERED, 'T')

WHERE REGISTRATION_DATE IS NULL;

Связанные или похожие функции

См. также iNullif(). Для Firebird 1.5 и вышё см. внутреннюю функцию NULLIF()

FBUDF

SNVL(VALUE1, VALUE2)

Linux, Win32

Эта функция пытается повторить функцию Oracle NVLO только для строковых типов. Она возвращает указанное непустое значение, если заданный столбец имеет значение NULL

Аргументы

VALUE1: столбец или выражение, включающее столбец.

VALUE2: выражение или константа, которая будет возвращаемым значением, если VALUE1 дает NOLL

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

Непустое значение. Если VALUE1 не является NULL, то оно будет возвращаемым значением; иначе будет возвращаться VALUE2. Если и VALUE1, и VALUE2 имеют значение NULL, ТО будет возвращено значение NULL

Замечания

Логически эта функция эквивалентна простой форме функции COALESCE() версии 1.5, когда она используется со столбцом символьного типа, а именно COALESCE(VALUE1, VALUE2).

Она должна рассматриваться как нерекомендуемая для Firebird 1.5 и выше

Пример

Следующий оператор вычисляет и выводит столбец времени выполнения BIRTH YEAR для каждого студента. Если это значение вычисляется в NULL, то вместо дня рождения выводится 'Not known' (Неизвестно):

SELECT

FIRST_NAME, LAST_NAME,

SNVL(CAST(EXTRACT(YEAR FROM BIRTH DATE) AS

VARCHAR (9) ) , ' Not known')

AS BIRTH_YEAR

FROM STUDENT_REGISTER;

Связанные или похожие функции

См. также iNVL(), sNullif() , внутреннюю функцию COALESCE()