{"Entry":{"collection":"func","key":"string-to-array","name":"string_to_array","aliases":[],"metadata":{"changed_in":["9.1"],"changes":[{"descriptions_changed":false,"doc_overhaul":false,"from":"7.3","group_changed":null,"signatures":{"added":[],"removed":[]},"status":"added","to":"7.4"},{"descriptions_changed":true,"doc_overhaul":false,"from":"7.4","group_changed":null,"signatures":{"added":[],"removed":[]},"status":"changed","to":"8.0"},{"descriptions_changed":true,"doc_overhaul":false,"from":"8.3","group_changed":null,"signatures":{"added":[],"removed":[]},"status":"changed","to":"8.4"},{"descriptions_changed":true,"doc_overhaul":false,"from":"9.0","group_changed":null,"signatures":{"added":["string_to_array ( text, text [, text] ) → text[]"],"removed":["string_to_array ( text, text ) → text[]"]},"status":"changed","to":"9.1"},{"descriptions_changed":false,"doc_overhaul":true,"from":"12","group_changed":null,"signatures":{"added":[],"removed":[]},"status":"changed","to":"13"},{"descriptions_changed":true,"doc_overhaul":false,"from":"13","group_changed":{"from":"array","to":"string"},"signatures":{"added":[],"removed":[]},"status":"changed","to":"14"},{"descriptions_changed":true,"doc_overhaul":false,"from":"14","group_changed":null,"signatures":{"added":[],"removed":[]},"status":"changed","to":"15"}],"content_hash":"8670d027d048a4618a2c3a352f635acce1a7de31af96357eb6f0a12810d5e848","first_version":"7.4","group":"string","group_label":"String Functions And Operators","groups":["string","array"],"imported_at":"2026-09-27T17:57:28.425668+08:00","last_version":"20","name":"string_to_array","name_key":"string_to_array","position":3044,"present_in":["7.4","8.0","8.1","8.2","8.3","8.4","9.0","9.1","9.2","9.3","9.4","9.5","9.6","10","11","12","13","14","15","16","17","18","19","20"],"signature":"string_to_array ( string text, delimiter text [, null_string text ] ) → text[]","signature_count":1,"slug":"string-to-array","source_rev":"b7bd9cda","summary":"Splits the string at occurrences of delimiter and forms the resulting fields into a text array.","summary_zh":""}},"Definition":{"Collection":"func","Key":"string-to-array","SourceDatabase":"center","Version":"18","SourceTable":"func","SourceKey":"string-to-array","SourceRevision":"b7bd9cda","Facts":{"description":"Splits the string at occurrences of delimiter and forms the resulting fields into a text array. If delimiter is NULL, each character in the string will become a separate element in the array. 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. See also array_to_string.","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 forms the resulting fields into a \u003ccode class=\"type\"\u003etext\u003c/code\u003e array. 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 element in the array. 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. See also \u003ca href=\"/docs/18/functions-array.html#FUNCTION-ARRAY-TO-STRING\"\u003e\u003ccode class=\"function\"\u003earray_to_string\u003c/code\u003e\u003c/a\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 forms the resulting fields into a text array. If delimiter is NULL, each character in the string will become a separate element in the array. 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. See also array_to_string.","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 forms the resulting fields into a \u003ccode class=\"type\"\u003etext\u003c/code\u003e array. 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 element in the array. 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. See also \u003ca href=\"/docs/18/functions-array.html#FUNCTION-ARRAY-TO-STRING\"\u003e\u003ccode class=\"function\"\u003earray_to_string\u003c/code\u003e\u003c/a\u003e.","description_zh":"","description_zh_html":"","examples":[{"expr":"string_to_array('xx~~yy~~zz', '~~', 'yy')","result":"{xx,NULL,zz}"}],"html":"\u003ccode class=\"function\"\u003estring_to_array\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\"\u003etext[]\u003c/code\u003e","returns":"text[]","text":"string_to_array ( string text, delimiter text [, null_string text ] ) → text[]","zh_from":""}],"zh_from":""},"ManualEvidence":{"doc":{"anchor":"FUNCTIONS-STRING-OTHER","file":"functions-string.html","slug":"18"}},"MeasuredEvidence":{}},"Text":{"Collection":"func","Key":"string-to-array","SourceDatabase":"pgweb","Version":"18","Locale":"zh-Hans","Title":"string_to_array","Summary":"将string按delimiter分割，并将结果字段形成text数组。如果delimiter是NULL，则string中的每个字符将成为数组中的一个单独元素。如果delimiter是空字符串，则string被视为单个字段。如果提供了null_string且不是NULL，则匹配该字符串的字段将被NULL替换。另请参见array_to_string。","BodyHTML":"将\u003cem\u003e\u003ccode\u003estring\u003c/code\u003e\u003c/em\u003e按\u003cem\u003e\u003ccode\u003edelimiter\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替换。另请参见\u003ca href=\"/docs/18/functions-array.html#FUNCTION-ARRAY-TO-STRING\" rel=\"nofollow\"\u003e\u003ccode\u003earray_to_string\u003c/code\u003e\u003c/a\u003e。\u003cpre\u003estring_to_array ( string text, delimiter text [, null_string text ] ) → text[]\u003c/pre\u003e将\u003cem\u003e\u003ccode\u003estring\u003c/code\u003e\u003c/em\u003e按\u003cem\u003e\u003ccode\u003edelimiter\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替换。另请参见\u003ca href=\"/docs/18/functions-array.html#FUNCTION-ARRAY-TO-STRING\" rel=\"nofollow\"\u003e\u003ccode\u003earray_to_string\u003c/code\u003e\u003c/a\u003e。","SourceRevision":"1b5ca64c","ContentHash":"f877362a7405f7b59416461590e8b98e0dc08df2be13c94d266763fdd0602abc","Payload":{"description_zh":"将string按delimiter分割，并将结果字段形成text数组。如果delimiter是NULL，则string中的每个字符将成为数组中的一个单独元素。如果delimiter是空字符串，则string被视为单个字段。如果提供了null_string且不是NULL，则匹配该字符串的字段将被NULL替换。另请参见array_to_string。","description_zh_html":"将\u003cem class=\"parameter\"\u003e\u003ccode\u003estring\u003c/code\u003e\u003c/em\u003e按\u003cem class=\"parameter\"\u003e\u003ccode\u003edelimiter\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替换。另请参见\u003ca href=\"/docs/18/functions-array.html#FUNCTION-ARRAY-TO-STRING\"\u003e\u003ccode class=\"function\"\u003earray_to_string\u003c/code\u003e\u003c/a\u003e。","signatures":[{"description_zh":"将string按delimiter分割，并将结果字段形成text数组。如果delimiter是NULL，则string中的每个字符将成为数组中的一个单独元素。如果delimiter是空字符串，则string被视为单个字段。如果提供了null_string且不是NULL，则匹配该字符串的字段将被NULL替换。另请参见array_to_string。","description_zh_html":"将\u003cem class=\"parameter\"\u003e\u003ccode\u003estring\u003c/code\u003e\u003c/em\u003e按\u003cem class=\"parameter\"\u003e\u003ccode\u003edelimiter\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替换。另请参见\u003ca href=\"/docs/18/functions-array.html#FUNCTION-ARRAY-TO-STRING\"\u003e\u003ccode class=\"function\"\u003earray_to_string\u003c/code\u003e\u003c/a\u003e。","returns":"text[]","text":"string_to_array ( string text, delimiter text [, null_string text ] ) → text[]","zh_from":"doc"}],"zh_from":"doc"}},"RequestedLocale":"zh-Hans","Fallback":false,"Versions":["10","11","12","13","14","15","16","17","18","19","20","7.4","8.0","8.1","8.2","8.3","8.4","9.0","9.1","9.2","9.3","9.4","9.5","9.6"],"Locales":["en","zh-Hans"],"Signatures":[{"Version":"18","Ordinal":0,"Hash":"29c6693e6076a0c903a0e028a571e61f0dcb88f7d4abe7ee3f56713ef5d1a1b1","Text":"string_to_array ( string text, delimiter text [, null_string text ] ) → text[]","Returns":"text[]","Payload":{"description":"Splits the string at occurrences of delimiter and forms the resulting fields into a text array. If delimiter is NULL, each character in the string will become a separate element in the array. 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. See also array_to_string.","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 forms the resulting fields into a \u003ccode class=\"type\"\u003etext\u003c/code\u003e array. 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 element in the array. 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. See also \u003ca href=\"/docs/18/functions-array.html#FUNCTION-ARRAY-TO-STRING\"\u003e\u003ccode class=\"function\"\u003earray_to_string\u003c/code\u003e\u003c/a\u003e.","description_zh":"","description_zh_html":"","examples":[{"expr":"string_to_array('xx~~yy~~zz', '~~', 'yy')","result":"{xx,NULL,zz}"}],"html":"\u003ccode class=\"function\"\u003estring_to_array\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\"\u003etext[]\u003c/code\u003e","returns":"text[]","text":"string_to_array ( string text, delimiter text [, null_string text ] ) → text[]","zh_from":""}}],"Spellings":null,"SQLState":null,"Evidence":null}