WHENEVER

WHENEVER — spécifie l'action à effectuer quand un ordre SQL entraîne le déclenchement d'une classe d'exception

Synopsis

WHENEVER { NOT FOUND | SQLERROR | SQLWARNING } action
 

Description

Définit un comportement qui sera appelé dans des cas spéciaux ( enregistrements non trouvés, avertissements ou erreurs SQL) dans le résultat de l'exécution SQL.

Paramètres

Voyez Section 34.8.1, « Mettre en Place des Callbacks » pour une description des paramètres.

Exemples

EXEC SQL WHENEVER NOT FOUND CONTINUE;
EXEC SQL WHENEVER NOT FOUND DO BREAK;
EXEC SQL WHENEVER SQLWARNING SQLPRINT;
EXEC SQL WHENEVER SQLWARNING DO warn();
EXEC SQL WHENEVER SQLERROR sqlprint;
EXEC SQL WHENEVER SQLERROR CALL print2();
EXEC SQL WHENEVER SQLERROR DO handle_error("select");
EXEC SQL WHENEVER SQLERROR DO sqlnotice(NULL, NONO);
EXEC SQL WHENEVER SQLERROR DO sqlprint();
EXEC SQL WHENEVER SQLERROR GOTO error_label;
EXEC SQL WHENEVER SQLERROR STOP;
 

Une application classique est l'utilisation de WHENEVER NOT FOUND BREAK pour gérer le bouclage sur des jeux de résultats:

int
main(void)
{
 EXEC SQL CONNECT TO testdb AS con1;
 EXEC SQL SELECT pg_catalog.set_config('search_path', '', false); EXEC SQL COMMIT;
 EXEC SQL ALLOCATE DESCRIPTOR d;
 EXEC SQL DECLARE cur CURSOR FOR SELECT current_database(), 'hoge', 256;
 EXEC SQL OPEN cur;
 /* quand la fin du jeu de résultat est atteinte, sortir de la boucle */
 EXEC SQL WHENEVER NOT FOUND DO BREAK;
 while (1)
 {
 EXEC SQL FETCH NEXT FROM cur INTO SQL DESCRIPTOR d;
 ...
 }
 EXEC SQL CLOSE cur;
 EXEC SQL COMMIT;
 EXEC SQL DEALLOCATE DESCRIPTOR d;
 EXEC SQL DISCONNECT ALL;
 return 0;
}
 

Compatibilité

WHENEVER est spécifié dans le standard SQL, mais la plupart des actions sont des extensions PostgreSQL.