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型。

那些带有默认值，名或混合符号的复杂的具有许多参数的函数可以极大的节省写进程，并且降低错误几率。