\if

中文定义与说明

这组命令实现了可嵌套的条件块。条件块必须以\if 开始，并以\endif 结束。在两者之间可以有任意数量的\elif 子句，后面可以选择性地跟着一个\else 子句。在形成条件块的命令之间通常会出现普通查询和其他类型的反斜线命令。

\if 和\elif 命令读取其参数，并将其作为布尔表达式求值。如果表达式的值为 true，则正常继续处理；否则，跳过后续行，直到遇到匹配的\elif、\else 或\endif。一旦\if 或\elif 测试成功，同一块中后续\elif 命令的参数就不再求值，而是被视为假。只有前面所有匹配的\if 和\elif 测试都未成功时，才会处理\else 后面的行。

与其他反斜线命令的参数一样，\if 或\elif 命令的 expression 参数会经过变量插值和反引号扩展。随后，按开/关选项变量值的规则对结果求值。因此，有效值是以下值的不区分大小写且无歧义的匹配：true、false、1、0、on、off、yes、no。例如，t、T 和 tR 都会被视为 true。

不能正确求值为真或假的表达式会产生警告，并被视为假。

被跳过的行会被正常解析以识别查询和反斜线命令，但查询不会发送到服务器，而且除了条件命令（\if、\elif、\else、\endif）之外的反斜线命令会被忽略。仅检查跳过行中条件命令的有效嵌套。跳过行中的变量引用不会被展开，也不会执行反引号扩展。

同一个条件块的所有反斜线命令必须出现在同一个源文件中。如果主输入文件或通过\include 引入的文件到达 EOF 时，仍有本地\if 块未关闭，psql 就会报错。

下面是一个示例：

-- 检查数据库中是否存在两条不同的记录，并将
-- 结果分别存入不同的 psql 变量
SELECT
    EXISTS(SELECT 1 FROM customer WHERE customer_id = 123) as is_customer,
    EXISTS(SELECT 1 FROM employee WHERE employee_id = 456) as is_employee
\gset
\if :is_customer
    SELECT * FROM customer WHERE customer_id = 123;
\elif :is_employee
    \echo 'is not a customer but is an employee'
    SELECT * FROM employee WHERE employee_id = 456;
\else
    \if yes
        \echo 'not a customer or employee'
    \else
        \echo 'this will never print'
    \endif
\endif