9.4. 字符串函数和操作符

n $ 格式的字符串，这里的 n 是要打印的参数的索引。索引为1表示在 formatstr 之后的第一个参数。如果省略了 formatstr ， 默认使用序列中的下一个参数。

附加选项，控制如何格式化格式说明符的输出。当前只支持负号( - )， 负号导致格式说明符的输出是左对齐的。这是没有影响的，除非指定了 width 字段。

声明字符数的 minimum 值用来显示格式说明符的输出。需要补充宽度时， 空白添加到输出的左侧或右侧（取决于 - 标志）。一个比较小的宽度不会导致输出的截断， 只是简单的忽略了。宽度可以用下列方法指定：一个正整数；一个星号( * ) 表示使用下一个函数参数作为宽度；或一个格式为 * n $ 的字符串表示使用第 n 个函数参数作为宽度。

如果宽度来自函数参数，那么这个参数在作为格式说明符的数值之前消耗掉。 如果宽度参数是负的，那么结果是左对齐的（就像声明了 - 标志一样）， 并且字段长度为 abs ( width )。

格式转换的类型用来产生格式说明符的输出。支持下列的类型：

• s 格式参数值为简单的字符串。空值作为空字符串对待。

• I 将参数值作为SQL标识符对待，如果需要，双写它。值为空是错误的。

• L 引用参数值作为SQL文字。空值用字符串 NULL 显示，没有引用。

除了上述的格式说明符，特殊的序列 %% 可以用作输出 % 字符。

这里有一些基本的格式转换的例子：

SELECT format('Hello %s', 'World');
Result: Hello World
SELECT format('Testing %s, %s, %s, %%', 'one', 'two', 'three');
Result: Testing one, two, three, %
SELECT format('INSERT INTO %I VALUES(%L)', 'Foo bar', E'O\'Reilly');
Result: INSERT INTO "Foo bar" VALUES('O''Reilly')
SELECT format('INSERT INTO %I VALUES(%L)', 'locations', E'C:\\Program Files');
Result: INSERT INTO locations VALUES(E'C:\\Program Files')

这里是使用 width 字段和 - 标志的例子：

SELECT format('|%10s|', 'foo');
Result: |       foo|
SELECT format('|%-10s|', 'foo');
Result: |foo       |
SELECT format('|%*s|', 10, 'foo');
Result: |       foo|
SELECT format('|%*s|', -10, 'foo');
Result: |foo       |
SELECT format('|%-*s|', 10, 'foo');
Result: |foo       |
SELECT format('|%-*s|', -10, 'foo');
Result: |foo       |

下面是使用 position 字段的例子：

SELECT format('Testing %3$s, %2$s, %1$s', 'one', 'two', 'three');
Result: Testing three, two, one
SELECT format('|%*2$s|', 'foo', 10, 'bar');
Result: |       bar|
SELECT format('|%1$*2$s|', 'foo', 10, 'bar');
Result: |       foo|

和C函数 sprintf 不同， PostgreSQL 的 format 函数允许带有或不带有 position 字段的格式说明符在相同的格式字符串中混合使用。 没有 position 字段的格式说明符总是使用最后消耗参数的下一个参数。 另外， format 函数不要求在格式字符串中使用所有函数参数。例如：

SELECT format('Testing %3$s, %2$s, %s', 'one', 'two', 'three');
Result: Testing three, two, three

%I 和 %L 格式说明符对于安全构造动态SQL语句尤其有用。