文字

4.3. 调用函数

PostgreSQL允许通过positional或named符号来调用带有已命名参数的函数。对于带有大量参数的函数来说，命名符号是非常有用的，因为它使参数和实际参数之间的关联更加明确和可靠。对位置符号，函数调用时，它的参数值的顺序与在函数声明时的顺序相同。对命名符号，参数名与函数的参数名相匹配，并且可以以任意顺序书写。

对任意一个符号，函数声明时带有缺省值的参数，在调用时完全不需要写上。对命名符号，因为参数的任意组合可以省略，所以刚才的方法会非常有用，而位置符号只能从右到左省略。

PostgreSQL同样支持位置与命名符号结合的mixed符号. 在这种情况下，先写位置符号，再写命名符号。

下例说明了这三种符号的使用，首先如下定义函数：

CREATE FUNCTION concat_lower_or_upper(a text, b text, uppercase boolean DEFAULT false)
RETURNS text
AS
$$
 SELECT CASE
        WHEN $3 THEN UPPER($1 || ' ' || $2)
        ELSE LOWER($1 || ' ' || $2)
        END;
$$
LANGUAGE SQL IMMUTABLE STRICT;

concat_lower_or_upper函数有两个强制参数，a和b，以及一个可选参数uppercase（缺省false）。a和b在输入时会被串联，然后根据uppercase参数来决定使用大写或小写。相比之下，剩下的函数定义就不重要了。可参阅Chapter 35获得更多资料。

4.3.1. 使用positional符号

在PostgreSQL中，位置符号是传统的，将参数传递给函数的机制。如下例：

SELECT concat_lower_or_upper('Hello', 'World', true);
 concat_lower_or_upper 
-----------------------
 HELLO WORLD
(1 row)

所有的参数顺序声明。由于uppercase参数声明为true，所以输出结果为大写。另一个示例：

SELECT concat_lower_or_upper('Hello', 'World');
 concat_lower_or_upper 
-----------------------
 hello world
(1 row)

此例中，uppercase参数被忽略，因此使用缺省值false，这样，输出结果就为小写。在位置符号中，只要参数带有缺省值，那么可以从右到左忽略。

4.3.2. 使用named符号

对命名符号，每个参数的名子用:=进行声明，以与参数表达式分开。如：

SELECT concat_lower_or_upper(a := 'Hello', b := 'World');
 concat_lower_or_upper 
-----------------------
 hello world
(1 row)

同样，uppercase参数被忽略，从而使用缺省值。使用命名参数的一个好处是，参数可以以任意顺序声明，如：

SELECT concat_lower_or_upper(a := 'Hello', b := 'World', uppercase := true);
 concat_lower_or_upper 
-----------------------
 HELLO WORLD
(1 row)

SELECT concat_lower_or_upper(a := 'Hello', uppercase := true, b := 'World');
 concat_lower_or_upper 
-----------------------
 HELLO WORLD
(1 row)

4.3.3. 使用mixed符号

该符号是位置和命名符号的组合，然而，正如已提到的，命名符号不能在位置符号之前，如：

SELECT concat_lower_or_upper('Hello', 'World', uppercase := true);
 concat_lower_or_upper 
-----------------------
 HELLO WORLD
(1 row)

在上面所有的查询中，a和b参数被声明为positional型，而uppercase被声明为name型。那些带有默认值，名或混合符号的复杂的具有许多参数的函数可以极大的节省写进程，并且降低错误几率。