FUNCTION字符串函数和操作符

to_bin

将数字转换为等价的二进制补码表示。

Converts the number to its equivalent two's complement binary representation.

字符串函数和操作符引入 17 现存至 20 devel 2 条签名 0 次签名变更

分组: 字符串函数和操作符
签名数: 2 条
引入版本: 17
状态: 现存
签名变更: 未变过
本版来源: 本站译文（沿用）

PostgreSQL 18 手册 · 9.4 字符串函数和操作符官方文档

版本轨迹

相对 PostgreSQL 17 无变化。

签名

PostgreSQL 18 里 to_bin 的 2 条签名，按上游手册顺序排列。参数名用斜体，类型用弱化色，之后是返回类型。说明取自本站手册译文：标「沿用」的借用了另一版的译文，标「EN」的本站暂无译文、按英文原文显示。

to_bin ( integer ) → text

沿用将数字转换为等价的二进制补码表示。
- to_bin(2147483647)1111111111111111111111111111111
- to_bin(-1234)11111111111111111111101100101110
to_bin ( bigint ) → text

沿用将数字转换为等价的二进制补码表示。
- to_bin(2147483647)1111111111111111111111111111111
- to_bin(-1234)11111111111111111111101100101110

演化历史

相邻两个大版本之间的差异，新的在前。版本号链到该版的签名。

PostgreSQL 17 ← 16 新增此函数

PostgreSQL 17 起可用

签名矩阵

每条签名在给出了签名的 4 个版本里的存在情况；方格指向该版的签名。只在正文里提到此函数、没有给出签名的版本不列进来，上面的版本轨迹里仍然有它们。签名文本在 PostgreSQL 13 前后写法不同，跨越那一跳的同一条签名会显示成两行。

存在不存在

签名	17	18	19	20
`to_bin ( integer ) → text`	存在	存在	存在	存在
`to_bin ( bigint ) → text`	存在	存在	存在	存在

同组函数

函数	签名	主签名	最近变更
STRING FUNCTIONS AND OPERATORS 字符串函数和操作符 58 个 ↗
`ascii`基线	1	`ascii ( text ) → integer`	—
返回参数的第一个字符的数字代码。			现存
`bit_length`基线	3	`bit_length ( text ) → integer`	—
返回字符串中的位数(8倍于octet_length)。			现存
`btrim`基线	2	`btrim ( string text [, characters text ] ) → text`	—
从string的开头或结尾删除最长的只包含characters（默认是一个空格）的字符串			现存
`casefold`	1	`casefold ( text ) → text`	—
根据排序规则对输入字符串执行大小写折叠。			现存
`char_length`基线	1	`char_length ( text ) → integer`	—
返回字符串中的字符数。			现存
`character_length`基线	1	`character_length ( text ) → integer`	—
返回字符串中的字符数。			现存
`chr`基线	1	`chr ( integer ) → text`	—
返回给定代码的字符。			现存
`concat`	1	`concat ( val1 "any" [, val2 "any" [, ...] ] ) → text`	—
连接所有参数的文本表示。			现存
`concat_ws`	1	`concat_ws ( sep text, val1 "any" [, val2 "any" [, ...] ] ) → text`	—
用分隔符连接除第一个参数外的所有参数。			现存
`format`	2	`format ( formatstr text [, formatarg "any" [, ...] ] ) → text`	9.31 次
根据格式字符串对参数进行格式化；参见 Section 9.4.1。			现存
`getdatabaseencoding`	1	`getdatabaseencoding ( ) → name`	—
返回当前数据库的编码名称。			现存
`initcap`基线	1	`initcap ( text ) → text`	—
将每个单词的第一个字母转换为大写（如果该字母是双字母，且区域设置为ICU或builtin PG_UNICODE_FAST，则转换为标题大小写），其余字母转换为小写。			现存
`left`	1	`left ( string text, n integer ) → text`	—
以字符串返回第一个 n 字符，或在 n 为负时, 返回最后 \|n\| 个字符之外的全部字符。			现存
`length`基线	6	`length ( text ) → integer`	9.11 次
返回字符串中的字符数。			现存
`lower`基线	3	`lower ( text ) → text`	142 次
根据数据库的语言环境规则，将字符串转换为全部小写。			现存
`lpad`基线	1	`lpad ( string text, length integer [, fill text ] ) → text`	—
将string扩展为长度length，通过前置字符fill（默认空格）。			现存
`ltrim`基线	2	`ltrim ( string text [, characters text ] ) → text`	141 次
从string开始删除包含characters（默认空格）中仅包含字符的最长字符串。			现存
`md5`基线	2	`md5 ( text ) → text`	—
计算参数的 MD5 hash ，结果以十六进制形式写入。			现存
`normalize`	1	`normalize ( text [, form ] ) → text`	—
将字符串转换为指定的Unicode规范化形式。			现存
`octet_length`基线	4	`octet_length ( text ) → integer`	—
返回字符串的字节数。			现存
`overlay`基线	3	`overlay ( string text PLACING newsubstring text FROM start integer [ FOR count integer ] ) → text`	—
替换string从start字符开始的子串，并用newsubstring扩展到count字符。			现存
`parse_ident`	1	`parse_ident ( qualified_identifier text [, strict_mode boolean DEFAULT true ] ) → text[]`	—
将qualified_identifier拆分为一个标识符数组，删除单个标识符的任何引用。			现存
`pg_client_encoding`基线	1	`pg_client_encoding ( ) → name`	—
返回当前客户端编码名称。			现存
`position`基线	3	`position ( substring text IN string text ) → integer`	—
返回string中指定的substring的第一个起始索引，如果不存在则返回零，。			现存
`quote_ident`基线	1	`quote_ident ( text ) → text`	—
返回适合引用的给定字符串，作为SQL语句字符串中的标识符。			现存
`quote_literal`基线	2	`quote_literal ( text ) → text`	—
返回在SQL语句字符串中适当引用的给定字符串，用作字符串文字使用。			现存
`quote_nullable`基线	2	`quote_nullable ( text ) → text`	—
返回在SQL语句字符串中适当引用的给定字符串文字;或者，如果参数为null，则返回NULL。			现存
`regexp_count`	2	`regexp_count ( string text, pattern text [, start integer [, flags text ] ] ) → integer`	191 次
返回 POSIX 正则表达式pattern在string中匹配的次数；参见Section 9.7.3.1.2。			现存
`regexp_instr`	2	`regexp_instr ( string text, pattern text [, start integer [, N integer [, endoption integer [, flags text [, subexpr integer ] ] ] ] ] ) → integer`	191 次
返回string中第N个匹配项的POSIX正则表达式pattern出现的位置，如果没有这样的匹配项，则返回零；参见Section 9.7.3.1.3。			现存
`regexp_like`	2	`regexp_like ( string text, pattern text [, flags text ] ) → boolean`	191 次
检查 POSIX 正则表达式pattern是否在string中出现；参见Section 9.7.3.1.4。			现存
`regexp_match`	2	`regexp_match ( string text, pattern text [, flags text ] ) → text[]`	191 次
返回第一个匹配的POSIX正则表达式pattern在string中的子字符串；参见Section 9.7.3.1.5。			现存
`regexp_matches`基线	2	`regexp_matches ( string text, pattern text [, flags text ] ) → setof text[]`	191 次
返回第一个匹配的 POSIX 正则表达式pattern在string中的子字符串，或者如果使用了g标志，则返回所有匹配的子字符串；参见Section 9.7.3.1.6。			现存
`regexp_replace`基线	4	`regexp_replace ( string text, pattern text, replacement text [, flags text ] ) → text`	193 次
替换第一个与 POSIX 正则表达式pattern匹配的子字符串，如果使用了g标志，则替换所有这样的匹配；参见Section 9.7.3.1.7。			现存
`regexp_split_to_array`基线	2	`regexp_split_to_array ( string text, pattern text [, flags text ] ) → text[]`	191 次
使用POSIX正则表达式作为分隔符拆分string，生成一个结果的数组；参见 Section 9.7.3.1.9。			现存
`regexp_split_to_table`基线	2	`regexp_split_to_table ( string text, pattern text [, flags text ] ) → setof text`	191 次
使用POSIX正则表达式作为分隔符拆分string，生成一组结果；参见 Section 9.7.3.1.8。			现存
`regexp_substr`	2	`regexp_substr ( string text, pattern text [, start integer [, N integer [, flags text [, subexpr integer ] ] ] ] ) → text`	191 次
返回string中与第N个出现的POSIX正则表达式pattern匹配的子字符串，如果没有这样的匹配，则返回NULL;参见Section 9.7.3.1.10。			现存
`repeat`基线	1	`repeat ( string text, number integer ) → text`	—
重复string指定number的次数。			现存
`replace`基线	1	`replace ( string text, from text, to text ) → text`	—
将string 中当前的子串from替换为子串to。			现存
`reverse`	2	`reverse ( text ) → text`	181 次
颠倒字符串中字符的顺序。			现存
`right`	1	`right ( string text, n integer ) → text`	—
返回字符串中的最后n个字符，或者在n>为负时，返回除了前面的\|n\|字符之外的所有字符。			现存
`rpad`基线	1	`rpad ( string text, length integer [, fill text ] ) → text`	—
扩展 string 到长度 length，通过追加fill 字符(默认为空格). 如果string 已经比 length 长，则截断它。			现存
`rtrim`基线	2	`rtrim ( string text [, characters text ] ) → text`	141 次
从string末尾删除包含characters（默认为空格）中仅包含字符的最长字符串。			现存
`split_part`基线	1	`split_part ( string text, delimiter text, n integer ) → text`	—
在delimiter出现时拆分string，并且返回第n个字段(从一计数)，或者当n为负数时，返回\|n\|'th-from-last 字段。			现存
`starts_with`	1	`starts_with ( string text, prefix text ) → boolean`	—
如果 string 以 prefix开始就返回真。			现存
`string_to_array`基线	1	`string_to_array ( string text, delimiter text [, null_string text ] ) → text[]`	9.11 次
将string按delimiter分割，并将结果字段形成text数组。			现存
`string_to_table`	1	`string_to_table ( string text, delimiter text [, null_string text ] ) → setof text`	—
在出现delimiter 时拆分string，并将结果字段作为text行的集合返回。			现存
`strpos`基线	1	`strpos ( string text, substring text ) → integer`	—
返回在string中指定的substring的第一个起始索引,如果不存在则为零。			现存
`substr`基线	2	`substr ( string text, start integer [, count integer ] ) → text`	—
提取string从start字符开始的子字符串，并扩展count字符，如果指定了的话。			现存
`substring`基线	11	`substring ( string text [ FROM start integer ] [ FOR count integer ] ) → text`	193 次
如果已指定，提取string从start字符开始的子串，并且在count字符后停止。			现存
`to_ascii`基线	3	`to_ascii ( string text ) → text`	—
将string从另一个编码中转换为ASCII，该编码可按名称或编号标识。			现存
`to_bin`	2	`to_bin ( integer ) → text`	—
将数字转换为等价的二进制补码表示。			现存
`to_hex`基线	2	`to_hex ( integer ) → text`	—
将数字转换为其相应的十六进制表示形式。			现存
`to_oct`	2	`to_oct ( integer ) → text`	—
将数字转换为等价的八进制补码表示。			现存
`translate`基线	1	`translate ( string text, from text, to text ) → text`	—
将string中与from集合中匹配的每个字符替换为to集合中相应的字符。			现存
`trim`基线	4	`trim ( [ LEADING \| TRAILING \| BOTH ] [ characters text ] FROM string text ) → text`	142 次
从string的开始、末端或两端(默认为BOTH )移除仅包含characters(默认为空格)字符的最长字符串。			现存
`unicode_assigned`	1	`unicode_assigned ( text ) → boolean`	—
如果字符串中的所有字符都已分配 Unicode 代码点，则返回true；否则返回false。			现存
`unistr`	1	`unistr ( text ) → text`	—
计算参数中的转义Unicode字符。			现存
`upper`基线	3	`upper ( text ) → text`	142 次
根据数据库的定位规则，将字符串转换为所有大写。			现存

快速链接

版本轨迹

签名

演化历史

签名矩阵

相关函数

同组函数