# 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扩展。