{"Entry":{"collection":"func","key":"string-to-table","name":"string_to_table","aliases":[],"metadata":{"changed_in":[],"changes":[{"descriptions_changed":false,"doc_overhaul":false,"from":"13","group_changed":null,"signatures":{"added":[],"removed":[]},"status":"added","to":"14"}],"content_hash":"ed7dab23cc9dc57c74e2136ababf978e694f4931304ceb55598591d525ec4824","first_version":"14","group":"string","group_label":"String Functions And Operators","groups":["string"],"imported_at":"2026-09-14T21:49:48.672032+08:00","last_version":"20","name":"string_to_table","name_key":"string_to_table","position":3045,"present_in":["14","15","16","17","18","19","20"],"signature":"string_to_table ( string text, delimiter text [, null_string text ] ) → setof text","signature_count":1,"slug":"string-to-table","source_rev":"2026-09-14T13:14:25.684213+00:00@99e6866c","summary":"Splits the string at occurrences of delimiter and returns the resulting fields as a set of text rows.","summary_zh":""}},"Definition":{"Collection":"func","Key":"string-to-table","SourceDatabase":"center","Version":"18","SourceTable":"func","SourceKey":"string-to-table","SourceRevision":"2026-09-14T13:14:25.684213+00:00@99e6866c","Facts":{"description":"Splits the string at occurrences of delimiter and returns the resulting fields as a set of text rows. If delimiter is NULL, each character in the string will become a separate row of the result. If delimiter is an empty string, then the string is treated as a single field. If null_string is supplied and is not NULL, fields matching that string are replaced by NULL.","description_html":"Splits the \u003cem class=\"parameter\"\u003e\u003ccode\u003estring\u003c/code\u003e\u003c/em\u003e at occurrences of \u003cem class=\"parameter\"\u003e\u003ccode\u003edelimiter\u003c/code\u003e\u003c/em\u003e and returns the resulting fields as a set of \u003ccode class=\"type\"\u003etext\u003c/code\u003e rows. If \u003cem class=\"parameter\"\u003e\u003ccode\u003edelimiter\u003c/code\u003e\u003c/em\u003e is \u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e, each character in the \u003cem class=\"parameter\"\u003e\u003ccode\u003estring\u003c/code\u003e\u003c/em\u003e will become a separate row of the result. If \u003cem class=\"parameter\"\u003e\u003ccode\u003edelimiter\u003c/code\u003e\u003c/em\u003e is an empty string, then the \u003cem class=\"parameter\"\u003e\u003ccode\u003estring\u003c/code\u003e\u003c/em\u003e is treated as a single field. If \u003cem class=\"parameter\"\u003e\u003ccode\u003enull_string\u003c/code\u003e\u003c/em\u003e is supplied and is not \u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e, fields matching that string are replaced by \u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e.","description_zh":"","description_zh_html":"","doc":{"anchor":"FUNCTIONS-STRING-OTHER","file":"functions-string.html","slug":"18"},"group":"string","group_label":"String Functions And Operators","lang":"en","layout":"table-new","pages":["functions-string.html"],"prose_only":false,"signatures":[{"description":"Splits the string at occurrences of delimiter and returns the resulting fields as a set of text rows. If delimiter is NULL, each character in the string will become a separate row of the result. If delimiter is an empty string, then the string is treated as a single field. If null_string is supplied and is not NULL, fields matching that string are replaced by NULL.","description_html":"Splits the \u003cem class=\"parameter\"\u003e\u003ccode\u003estring\u003c/code\u003e\u003c/em\u003e at occurrences of \u003cem class=\"parameter\"\u003e\u003ccode\u003edelimiter\u003c/code\u003e\u003c/em\u003e and returns the resulting fields as a set of \u003ccode class=\"type\"\u003etext\u003c/code\u003e rows. If \u003cem class=\"parameter\"\u003e\u003ccode\u003edelimiter\u003c/code\u003e\u003c/em\u003e is \u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e, each character in the \u003cem class=\"parameter\"\u003e\u003ccode\u003estring\u003c/code\u003e\u003c/em\u003e will become a separate row of the result. If \u003cem class=\"parameter\"\u003e\u003ccode\u003edelimiter\u003c/code\u003e\u003c/em\u003e is an empty string, then the \u003cem class=\"parameter\"\u003e\u003ccode\u003estring\u003c/code\u003e\u003c/em\u003e is treated as a single field. If \u003cem class=\"parameter\"\u003e\u003ccode\u003enull_string\u003c/code\u003e\u003c/em\u003e is supplied and is not \u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e, fields matching that string are replaced by \u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e.","description_zh":"","description_zh_html":"","examples":[{"expr":"string_to_table('xx~^~yy~^~zz', '~^~', 'yy')","result":"xx\nNULL\nzz"}],"html":"\u003ccode class=\"function\"\u003estring_to_table\u003c/code\u003e ( \u003cem class=\"parameter\"\u003e\u003ccode\u003estring\u003c/code\u003e\u003c/em\u003e \u003ccode class=\"type\"\u003etext\u003c/code\u003e, \u003cem class=\"parameter\"\u003e\u003ccode\u003edelimiter\u003c/code\u003e\u003c/em\u003e \u003ccode class=\"type\"\u003etext\u003c/code\u003e [\u003cspan class=\"optional\"\u003e, \u003cem class=\"parameter\"\u003e\u003ccode\u003enull_string\u003c/code\u003e\u003c/em\u003e \u003ccode class=\"type\"\u003etext\u003c/code\u003e\u003c/span\u003e ] ) → \u003ccode class=\"returnvalue\"\u003esetof text\u003c/code\u003e","returns":"setof text","text":"string_to_table ( string text, delimiter text [, null_string text ] ) → setof text","zh_from":""}],"zh_from":""},"ManualEvidence":{"doc":{"anchor":"FUNCTIONS-STRING-OTHER","file":"functions-string.html","slug":"18"}},"MeasuredEvidence":{}},"Text":{"Collection":"func","Key":"string-to-table","SourceDatabase":"pgweb","Version":"18","Locale":"zh-Hans","Title":"string_to_table","Summary":"在出现delimiter 时拆分string，并将结果字段作为text行的集合返回。如果delimiter为NULL，则string中的每个字符将成为结果的单独一行。如果delimiter为空字符串，则将string视为单个字段。如果提供了null_string，并且不是NULL，则匹配该字符串的字段将被NULL替换。","BodyHTML":"在出现\u003cem\u003e\u003ccode\u003edelimiter\u003c/code\u003e\u003c/em\u003e 时拆分\u003cem\u003e\u003ccode\u003estring\u003c/code\u003e\u003c/em\u003e，并将结果字段作为\u003ccode\u003etext\u003c/code\u003e行的集合返回。如果\u003cem\u003e\u003ccode\u003edelimiter\u003c/code\u003e\u003c/em\u003e为\u003ccode\u003eNULL\u003c/code\u003e，则\u003cem\u003e\u003ccode\u003estring\u003c/code\u003e\u003c/em\u003e中的每个字符将成为结果的单独一行。如果\u003cem\u003e\u003ccode\u003edelimiter\u003c/code\u003e\u003c/em\u003e为空字符串，则将\u003cem\u003e\u003ccode\u003estring\u003c/code\u003e\u003c/em\u003e视为单个字段。如果提供了\u003cem\u003e\u003ccode\u003enull_string\u003c/code\u003e\u003c/em\u003e，并且不是\u003ccode\u003eNULL\u003c/code\u003e，则匹配该字符串的字段将被\u003ccode\u003eNULL\u003c/code\u003e替换。\u003cpre\u003estring_to_table ( string text, delimiter text [, null_string text ] ) → setof text\u003c/pre\u003e在出现\u003cem\u003e\u003ccode\u003edelimiter\u003c/code\u003e\u003c/em\u003e 时拆分\u003cem\u003e\u003ccode\u003estring\u003c/code\u003e\u003c/em\u003e，并将结果字段作为\u003ccode\u003etext\u003c/code\u003e行的集合返回。如果\u003cem\u003e\u003ccode\u003edelimiter\u003c/code\u003e\u003c/em\u003e为\u003ccode\u003eNULL\u003c/code\u003e，则\u003cem\u003e\u003ccode\u003estring\u003c/code\u003e\u003c/em\u003e中的每个字符将成为结果的单独一行。如果\u003cem\u003e\u003ccode\u003edelimiter\u003c/code\u003e\u003c/em\u003e为空字符串，则将\u003cem\u003e\u003ccode\u003estring\u003c/code\u003e\u003c/em\u003e视为单个字段。如果提供了\u003cem\u003e\u003ccode\u003enull_string\u003c/code\u003e\u003c/em\u003e，并且不是\u003ccode\u003eNULL\u003c/code\u003e，则匹配该字符串的字段将被\u003ccode\u003eNULL\u003c/code\u003e替换。","SourceRevision":"1b5ca64c","ContentHash":"a0df1dc2cd83a5c70dedaf53231b00b7a60e5c10b726ffbc823581532e699731","Payload":{"description_zh":"在出现delimiter 时拆分string，并将结果字段作为text行的集合返回。如果delimiter为NULL，则string中的每个字符将成为结果的单独一行。如果delimiter为空字符串，则将string视为单个字段。如果提供了null_string，并且不是NULL，则匹配该字符串的字段将被NULL替换。","description_zh_html":"在出现\u003cem class=\"parameter\"\u003e\u003ccode\u003edelimiter\u003c/code\u003e\u003c/em\u003e 时拆分\u003cem class=\"parameter\"\u003e\u003ccode\u003estring\u003c/code\u003e\u003c/em\u003e，并将结果字段作为\u003ccode class=\"type\"\u003etext\u003c/code\u003e行的集合返回。如果\u003cem class=\"parameter\"\u003e\u003ccode\u003edelimiter\u003c/code\u003e\u003c/em\u003e为\u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e，则\u003cem class=\"parameter\"\u003e\u003ccode\u003estring\u003c/code\u003e\u003c/em\u003e中的每个字符将成为结果的单独一行。如果\u003cem class=\"parameter\"\u003e\u003ccode\u003edelimiter\u003c/code\u003e\u003c/em\u003e为空字符串，则将\u003cem class=\"parameter\"\u003e\u003ccode\u003estring\u003c/code\u003e\u003c/em\u003e视为单个字段。如果提供了\u003cem class=\"parameter\"\u003e\u003ccode\u003enull_string\u003c/code\u003e\u003c/em\u003e，并且不是\u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e，则匹配该字符串的字段将被\u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e替换。","signatures":[{"description_zh":"在出现delimiter 时拆分string，并将结果字段作为text行的集合返回。如果delimiter为NULL，则string中的每个字符将成为结果的单独一行。如果delimiter为空字符串，则将string视为单个字段。如果提供了null_string，并且不是NULL，则匹配该字符串的字段将被NULL替换。","description_zh_html":"在出现\u003cem class=\"parameter\"\u003e\u003ccode\u003edelimiter\u003c/code\u003e\u003c/em\u003e 时拆分\u003cem class=\"parameter\"\u003e\u003ccode\u003estring\u003c/code\u003e\u003c/em\u003e，并将结果字段作为\u003ccode class=\"type\"\u003etext\u003c/code\u003e行的集合返回。如果\u003cem class=\"parameter\"\u003e\u003ccode\u003edelimiter\u003c/code\u003e\u003c/em\u003e为\u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e，则\u003cem class=\"parameter\"\u003e\u003ccode\u003estring\u003c/code\u003e\u003c/em\u003e中的每个字符将成为结果的单独一行。如果\u003cem class=\"parameter\"\u003e\u003ccode\u003edelimiter\u003c/code\u003e\u003c/em\u003e为空字符串，则将\u003cem class=\"parameter\"\u003e\u003ccode\u003estring\u003c/code\u003e\u003c/em\u003e视为单个字段。如果提供了\u003cem class=\"parameter\"\u003e\u003ccode\u003enull_string\u003c/code\u003e\u003c/em\u003e，并且不是\u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e，则匹配该字符串的字段将被\u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e替换。","returns":"setof text","text":"string_to_table ( string text, delimiter text [, null_string text ] ) → setof text","zh_from":"doc"}],"zh_from":"doc"}},"RequestedLocale":"zh-Hans","Fallback":false,"Versions":["14","15","16","17","18","19","20"],"Locales":["en","zh-Hans"],"Signatures":[{"Version":"18","Ordinal":0,"Hash":"3ff0e93301e4cf7e2565f855e295de8c11f1ad8aba1903a2e7f7954f8b6f19dc","Text":"string_to_table ( string text, delimiter text [, null_string text ] ) → setof text","Returns":"setof text","Payload":{"description":"Splits the string at occurrences of delimiter and returns the resulting fields as a set of text rows. If delimiter is NULL, each character in the string will become a separate row of the result. If delimiter is an empty string, then the string is treated as a single field. If null_string is supplied and is not NULL, fields matching that string are replaced by NULL.","description_html":"Splits the \u003cem class=\"parameter\"\u003e\u003ccode\u003estring\u003c/code\u003e\u003c/em\u003e at occurrences of \u003cem class=\"parameter\"\u003e\u003ccode\u003edelimiter\u003c/code\u003e\u003c/em\u003e and returns the resulting fields as a set of \u003ccode class=\"type\"\u003etext\u003c/code\u003e rows. If \u003cem class=\"parameter\"\u003e\u003ccode\u003edelimiter\u003c/code\u003e\u003c/em\u003e is \u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e, each character in the \u003cem class=\"parameter\"\u003e\u003ccode\u003estring\u003c/code\u003e\u003c/em\u003e will become a separate row of the result. If \u003cem class=\"parameter\"\u003e\u003ccode\u003edelimiter\u003c/code\u003e\u003c/em\u003e is an empty string, then the \u003cem class=\"parameter\"\u003e\u003ccode\u003estring\u003c/code\u003e\u003c/em\u003e is treated as a single field. If \u003cem class=\"parameter\"\u003e\u003ccode\u003enull_string\u003c/code\u003e\u003c/em\u003e is supplied and is not \u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e, fields matching that string are replaced by \u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e.","description_zh":"","description_zh_html":"","examples":[{"expr":"string_to_table('xx~^~yy~^~zz', '~^~', 'yy')","result":"xx\nNULL\nzz"}],"html":"\u003ccode class=\"function\"\u003estring_to_table\u003c/code\u003e ( \u003cem class=\"parameter\"\u003e\u003ccode\u003estring\u003c/code\u003e\u003c/em\u003e \u003ccode class=\"type\"\u003etext\u003c/code\u003e, \u003cem class=\"parameter\"\u003e\u003ccode\u003edelimiter\u003c/code\u003e\u003c/em\u003e \u003ccode class=\"type\"\u003etext\u003c/code\u003e [\u003cspan class=\"optional\"\u003e, \u003cem class=\"parameter\"\u003e\u003ccode\u003enull_string\u003c/code\u003e\u003c/em\u003e \u003ccode class=\"type\"\u003etext\u003c/code\u003e\u003c/span\u003e ] ) → \u003ccode class=\"returnvalue\"\u003esetof text\u003c/code\u003e","returns":"setof text","text":"string_to_table ( string text, delimiter text [, null_string text ] ) → setof text","zh_from":""}}],"Spellings":null,"SQLState":null,"Evidence":null}