9.4. 字符串函数和运算符

• 9.4.1. format

本节介绍了用于检查和操作字符串值的函数和运算符。在这种情况下，字符串包括character，character varying和text类型的值。除非另有说明，否则下面列出的所有功能均可在所有这些类型上使用，但请注意使用character类型时自动填充空格的潜在影响。对于位串类型，本机还存在一些功能。

SQL 定义了一些使用关键字而不是逗号分隔参数的字符串函数。详细信息在Table 9.8中。 PostgreSQL 还提供了使用常规函数调用语法的这些函数的版本(请参见Table 9.9)。

表 9.8. SQL 字符串函数和运算符

其他字符串操作功能可用，并在Table 9.9中列出。其中一些用于内部以实现Table 9.8中列出的 SQL 标准字符串函数。

表 9.9. 其他字符串函数

concat，concat_ws和format函数是可变参数，因此可以将要串联或格式化的值传递为标有VARIADIC关键字的数组(请参见Section 37.4.5)。将数组的元素视为函数的单独普通参数。如果可变参数数组参数为 NULL，则concat和concat_ws返回 NULL，但是format将 NULL 视为零元素数组。

另请参见Section 9.20中的聚合函数string_agg。

表 9.10. 内置转换

9.4.1. format

函数format以类似于 C 函数sprintf的样式生成根据格式字符串格式化的输出。

format(formatstr text [, formatarg "any" [, ...] ])

• formatstr 是用于指定结果格式的格式字符串。格式字符串中的文本会直接复制到结果中，除非使用 format specifiers 。格式说明符充当字符串中的占位符，定义应如何格式化后续函数参数并将其插入结果中。每个 formatarg *参数根据其数据类型的常规输出规则转换为文本，然后根据格式说明符进行格式化并插入到结果字符串中。

格式说明符由%字符引入，格式为

%[position][flags][width]type

组件字段为：

• • position *(可选)
  • 格式为n$的字符串，其中* n 是要打印的参数的索引。索引 1 表示 formatstr 之后的第一个参数。如果省略 position *，则默认为按 Sequences 使用下一个参数。
• • flags *(可选)
  • 其他选项，用于控制格式说明符输出的格式。当前唯一受支持的标志是减号(-)，这将导致格式说明符的输出向左对齐。除非也指定了* width *字段，否则这无效。
• • width *(可选)
  • 指定用于显示格式说明符输出的最少个字符。在输出的左侧或右侧(取决于-标志)填充空格，以填充宽度。太小的宽度不会导致输出被截断，而是会被忽略。可以使用以下任意一种方式指定宽度：正整数；星号(*)，用于将下一个函数参数用作宽度；或格式为*n$的字符串，以将* n *函数参数用作宽度。

如果宽度来自函数参数，则该参数将在用于格式说明符值的参数之前使用。如果 width 参数为负，则结果在长度为abs(* width *)的字段中保持对齐(就像已指定-标志)。

• • type *(必填)
  • 用于产生格式说明符输出的格式转换类型。支持以下类型：

• s将参数值格式化为简单字符串。空值将被视为空字符串。

• I将参数值视为 SQL 标识符，必要时将其双引号引起来。该值为 null(等于quote_ident)是错误的。

• L引用参数值作为 SQLLiterals。空值显示为字符串NULL，不带引号(等效于quote_nullable)。

除上述格式说明符外，特殊序列%%可用于输出 Literals%字符。

以下是一些基本格式转换的示例：

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', 'C:\Program Files');
Result: INSERT INTO locations VALUES('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 字段的格式说明符混合在同一格式字符串中。没有 position *字段的格式说明符始终使用最后一个参数之后的下一个参数。另外，format函数不需要在格式字符串中使用所有函数参数。例如：

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

%I和%L格式说明符对于安全构造动态 SQL 语句特别有用。参见Example 42.1。