# WHENEVER ## Name WHENEVER?--?當SQL語句導致一個要發生的特定類條件時， 則指定要采取的行動 ## Synopsis ``` WHENEVER { NOT FOUND | SQLERROR | SQLWARNING } _action_ ``` ## 描述 定義在SQL執行結果中特殊情況下（沒有發現行，SQL警告或者錯誤）調用的操作。 ## 參數 參閱[Section 33.8.1](#calibre_link-2068)獲取該參數的描述。 ## 例子 ``` 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; ``` 一個典型應用是通過結果集處理循環的 `WHENEVER NOT FOUND BREAK`的使用： ``` 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; /*當到達結果集終端時，打破while循環*/ 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; } ``` ## 兼容性 在SQL標準中指定`WHENEVER`，但是大多數操作是PostgreSQL擴展。