Documentation PostgreSQL 9.1.24 > Interfaces client > ECPG SQL embarqué en C > Commandes SQL Embarquées > WHENEVER | |
Mode de Compatibilité Informix |
WHENEVER — spécifie l'action à effectuer quand un ordre SQL entraîne le déclenchement d'une classe d'exception
WHENEVER { NOT FOUND | SQLERROR | SQLWARNING } action
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.
Voyez Section 33.8.1, « Mettre en Place des Callbacks » pour une description des paramètres.
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 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; }