PostgreSQL 9.4.4 中文手册
上一页 | 上一级 |  | 下一页

# WHENEVER

## 名称

WHENEVER -- 当SQL语句导致一个要发生的特定类条件时， 则指定要采取的行动

## 大纲

    WHENEVER { NOT FOUND | SQLERROR | SQLWARNING } action

## 描述

定义在SQL执行结果中特殊情况下（没有发现行，SQL警告或者错误）调用的操作。

## 参数

参阅第 33.8.1 节获取该参数的描述。

## 例子

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

上一页 | 起始页 | 下一页
VAR | 上一级 | Informix兼容模式