Exemples

Example 1. Déclaration d’une fonction externe avec des paramètres d’entrée et de sortie par référence

DECLARE EXTERNAL FUNCTION addDay
TIMESTAMP, INT
RETURNS TIMESTAMP
ENTRY_POINT 'addDay' MODULE_NAME 'fbudf';

Example 2. Déclaration d’une fonction externe avec transfert des paramètres d’entrée et de sortie par descripteur

DECLARE EXTERNAL FUNCTION invl
INT BY DESCRIPTOR, INT BY DESCRIPTOR
RETURNS INT BY DESCRIPTOR
ENTRY_POINT 'idNvl' MODULE_NAME 'fbudf';

Example 3. Déclaration d’une fonction externe avec paramètres d’entrée par référence, paramètres de sortie par valeur

DECLARE EXTERNAL FUNCTION isLeapYear
TIMESTAMP
RETURNS INT BY VALUE
ENTRY_POINT 'isLeapYear' MODULE_NAME 'fbudf';

Example 4. Déclaration d’une fonction externe avec des paramètres d’entrée et de sortie transmis par le descripteur. Le deuxième paramètre de la fonction est utilisé comme paramètre de sortie.

DECLARE EXTERNAL FUNCTION i64Truncate
NUMERIC(18) BY DESCRIPTOR, NUMERIC(18) BY DESCRIPTOR
RETURNS PARAMETER 2
ENTRY_POINT 'fbtruncate' MODULE_NAME 'fbudf';

Voir aussi :

ALTER EXTERNAL FUNCTION,DROP EXTERNAL FUNCTION,CREATE FUNCTION.

`ALTER EXTERNAL FUNCTION`

affectation

Modifier le point d’entrée et/ou le nom du module pour une fonction définie par l’utilisateur (UDF).

Disponible en

DSQL

Syntaxe

ALTER EXTERNAL FUNCTION funcname
[ENTRY_POINT 'new_entry_point']
[MODULE_NAME 'new_library_name'];

Table 1. Paramètres de l’opérateur `ALTER EXTERNAL FUNCTION`
Paramètre	Description
funcname	Le nom de la fonction externe.
new_entry_point	Nouveau nom de la fonction à exporter (point d’entrée).
new_library_name	Le nouveau nom du module dans lequel se trouve la fonction.

L’instruction ALTER EXTERNAL FUNCTION change le point d’entrée et/ou le nom du module pour une fonction définie par l’utilisateur (UDF). Les dépendances existantes sont conservées.

La phrase ENTRY_POINT permet de spécifier un nouveau point d’entrée (le nom de la fonction à exporter).

La proposition MODULE_NAME vous permet de spécifier un nouveau nom de module où se trouve la fonction exportée.

docnext count = 5

Qui peut modifier une fonction externe ?

L’instruction `ALTER EXTERNAL FUNCTION' peut être exécutée :

administrators.
Le propriétaire de la fonction externe ;
Les utilisateurs ayant le privilège de `ALTER ANY FUNCTION'.

Exemples

Example 1. Changement du point d’entrée d’une fonction externe

ALTER EXTERNAL FUNCTION invl ENTRY_POINT 'intNvl';

Example 2. Modification du nom du module pour une fonction externe

ALTER EXTERNAL FUNCTION invl MODULE_NAME 'fbudf2';

Voir aussi :

DECLARE EXTERNAL FUNCTION,DROP EXTERNAL FUNCTION.

`DROP EXTERNAL FUNCTION`

affectation

Suppression d’une déclaration de fonction définie par l’utilisateur (UDF) dans la base de données.

Disponible en

DSQL, ESQL.

Syntaxe

DROP EXTERNAL FUNCTION funcname

Table 1. Paramètres de l’opérateur `DROP EXTERNAL FUNCTION`
Paramètre	Description
funcname	Le nom de la fonction externe.

L’instruction DROP EXTERNAL FUNCTION supprime de la base de données une déclaration de fonction définie par l’utilisateur. S’il existe des dépendances sur une fonction externe, la suppression n’aura pas lieu et une erreur correspondante sera émise.

Qui peut supprimer une fonction externe ?

L’instruction `DROP EXTERNAL FUNCTION' peut être exécutée :

administrators.
Le propriétaire de la fonction externe ;
Utilisateurs avec le privilège `DROP ANY FUNCTION'.

Exemples

Example 1. Suppression d’une fonction externe

DROP EXTERNAL FUNCTION addDay;

Voir aussi :

DECLARE EXTERNAL FUNCTION.