{"Entry":{"collection":"func","key":"quote-nullable","name":"quote_nullable","aliases":[],"metadata":{"changed_in":[],"changes":[{"descriptions_changed":false,"doc_overhaul":false,"from":"8.3","group_changed":null,"signatures":{"added":[],"removed":[]},"status":"added","to":"8.4"},{"descriptions_changed":true,"doc_overhaul":false,"from":"8.4","group_changed":null,"signatures":{"added":[],"removed":[]},"status":"changed","to":"9.0"},{"descriptions_changed":true,"doc_overhaul":false,"from":"9.2","group_changed":null,"signatures":{"added":[],"removed":[]},"status":"changed","to":"9.3"},{"descriptions_changed":true,"doc_overhaul":false,"from":"9.5","group_changed":null,"signatures":{"added":[],"removed":[]},"status":"changed","to":"9.6"},{"descriptions_changed":true,"doc_overhaul":false,"from":"9.6","group_changed":null,"signatures":{"added":[],"removed":[]},"status":"changed","to":"10"},{"descriptions_changed":true,"doc_overhaul":false,"from":"10","group_changed":null,"signatures":{"added":[],"removed":[]},"status":"changed","to":"11"},{"descriptions_changed":true,"doc_overhaul":false,"from":"11","group_changed":null,"signatures":{"added":[],"removed":[]},"status":"changed","to":"12"},{"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":null,"signatures":{"added":[],"removed":[]},"status":"changed","to":"14"},{"descriptions_changed":true,"doc_overhaul":false,"from":"16","group_changed":null,"signatures":{"added":[],"removed":[]},"status":"changed","to":"17"}],"content_hash":"81ca8b93935da2ab4fc8b11f37a72eaa4d5c15eaf6eded0642d32d083f4864e8","derived_content_hash":"4cc246071e367095235776b1b5fe9edf7a8d97b6fda82182f2518c0dac2a7b74","documentation_refresh":{"batch":"20261113","original_source_rev":"wiki-repair-20261023:dc13bd7800d6ec00a6365dedb114bab1273fcc9f4487a783968084ef04c4ac39","versions":{"14":"14.25","15":"15.20","16":"16.16","17":"17.12","18":"18.7","19":"19rc2"}},"first_version":"8.4","group":"string","group_label":"String Functions And Operators","groups":["string"],"imported_at":"2026-09-27T17:57:28.387523+08:00","last_version":"20","name":"quote_nullable","name_key":"quote_nullable","position":3026,"present_in":["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"],"repair_provenance":{"original_source_revision":"wiki-repair-20261023:67e2784c6123026169591032cdf0fb30668cf76c0aab665074901067b3fec172","receipt_sha256":"b225000ea03744e6327cf21761f7f84b2aee524976ab9f9f53904551535a4856","repair":"wiki-repair-20261023"},"signature":"quote_nullable ( text ) → text","signature_count":2,"slug":"quote-nullable","source_rev":"wiki-repair-20261023:dc13bd7800d6ec00a6365dedb114bab1273fcc9f4487a783968084ef04c4ac39","summary":"Returns the given string suitably quoted to be used as a string literal in an SQL statement string; or, if the argument is null, returns NULL.","summary_zh":""}},"Definition":{"Collection":"func","Key":"quote-nullable","SourceDatabase":"center","Version":"18","SourceTable":"func","SourceKey":"quote-nullable","SourceRevision":"wiki-repair-20261023:dc13bd7800d6ec00a6365dedb114bab1273fcc9f4487a783968084ef04c4ac39","Facts":{"description":"Returns the given string suitably quoted to be used as a string literal in an SQL statement string; or, if the argument is null, returns NULL. Embedded single-quotes and backslashes are properly doubled. See also Example 41.1.","description_html":"Returns the given string suitably quoted to be used as a string literal in an SQL statement string; or, if the argument is null, returns \u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e. Embedded single-quotes and backslashes are properly doubled. See also \u003ca href=\"/docs/18/plpgsql-statements.html#PLPGSQL-QUOTE-LITERAL-EXAMPLE\" title=\"Example 41.1. Quoting Values in Dynamic Queries\"\u003eExample 41.1\u003c/a\u003e.","description_zh":"为给定字符串添加适当的引号并返回，使其可用作 SQL 语句字符串中的字符串字面量；如果参数为 null，则返回 NULL。内嵌的单引号和反斜杠会被适当地双写。另见例 41.1。","description_zh_html":"为给定字符串添加适当的引号并返回，使其可用作 SQL 语句字符串中的字符串字面量；如果参数为 null，则返回 \u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e。内嵌的单引号和反斜杠会被适当地双写。另见\u003ca href=\"/docs/18/plpgsql-statements.html#PLPGSQL-QUOTE-LITERAL-EXAMPLE\" title=\"例 41.1. 在动态查询中为值加引号\"\u003e例 41.1\u003c/a\u003e。","doc":{"anchor":"FUNCTIONS-STRING-OTHER","file":"functions-string.html","sha256":"dbe9f91e55c35969d99a8d2697b6f7bd5388a24ccc2b89706a666f176025f1e2","slug":"18"},"documentation_revision":{"inputs":[{"file":"functions-string.html","kind":"same-version-reviewed-manual","locale":"en","sha256":"dbe9f91e55c35969d99a8d2697b6f7bd5388a24ccc2b89706a666f176025f1e2","version":"18.7"},{"file":"functions-string.html","kind":"same-version-reviewed-manual","locale":"zh-Hans","sha256":"7eecd3bb343149124be0476a539f3c682476eab2a15489a0e0ad06fbb769ea9e","version":"18.7"}],"release":"18.7","runtime_remeasured":false,"source_revision":"pgdoc:b9f0e7232f60f380d642ac9b99226606c254b552"},"group":"string","group_label":"字符串函数和操作符","lang":"en","layout":"table-new","pages":["functions-string.html"],"prose_only":false,"signatures":[{"description":"Returns the given string suitably quoted to be used as a string literal in an SQL statement string; or, if the argument is null, returns NULL. Embedded single-quotes and backslashes are properly doubled. See also Example 41.1.","description_html":"Returns the given string suitably quoted to be used as a string literal in an SQL statement string; or, if the argument is null, returns \u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e. Embedded single-quotes and backslashes are properly doubled. See also \u003ca href=\"/docs/18/plpgsql-statements.html#PLPGSQL-QUOTE-LITERAL-EXAMPLE\" title=\"Example 41.1. Quoting Values in Dynamic Queries\"\u003eExample 41.1\u003c/a\u003e.","description_zh":"为给定字符串添加适当的引号并返回，使其可用作 SQL 语句字符串中的字符串字面量；如果参数为 null，则返回 NULL。内嵌的单引号和反斜杠会被适当地双写。另见例 41.1。","description_zh_html":"为给定字符串添加适当的引号并返回，使其可用作 SQL 语句字符串中的字符串字面量；如果参数为 null，则返回 \u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e。内嵌的单引号和反斜杠会被适当地双写。另见\u003ca href=\"/docs/18/plpgsql-statements.html#PLPGSQL-QUOTE-LITERAL-EXAMPLE\" title=\"例 41.1. 在动态查询中为值加引号\"\u003e例 41.1\u003c/a\u003e。","examples":[{"expr":"quote_nullable(NULL)","result":"NULL"}],"html":"\u003ccode class=\"function\"\u003equote_nullable\u003c/code\u003e ( \u003ccode class=\"type\"\u003etext\u003c/code\u003e ) → \u003ccode class=\"returnvalue\"\u003etext\u003c/code\u003e","returns":"text","text":"quote_nullable ( text ) → text","zh_from":"same-version-manual"},{"description":"Converts the given value to text and then quotes it as a literal; or, if the argument is null, returns NULL. Embedded single-quotes and backslashes are properly doubled.","description_html":"Converts the given value to text and then quotes it as a literal; or, if the argument is null, returns \u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e. Embedded single-quotes and backslashes are properly doubled.","description_zh":"将给定值转换为文本，然后作为字面量加引号；如果参数为 null，则返回 NULL。内嵌的单引号和反斜杠会被适当地双写。","description_zh_html":"将给定值转换为文本，然后作为字面量加引号；如果参数为 null，则返回 \u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e。内嵌的单引号和反斜杠会被适当地双写。","examples":[{"expr":"quote_nullable(42.5)","result":"'42.5'"}],"html":"\u003ccode class=\"function\"\u003equote_nullable\u003c/code\u003e ( \u003ccode class=\"type\"\u003eanyelement\u003c/code\u003e ) → \u003ccode class=\"returnvalue\"\u003etext\u003c/code\u003e","returns":"text","text":"quote_nullable ( anyelement ) → text","zh_from":"same-version-manual"}],"translation_provenance":{"inputs":[{"kind":"current-pgdoc-translation","path":"/Users/vonng/pgsty/pgdoc/zh/18/html/functions-string.html","sha256":"0446377e0eccc9299099dc4b4b293204c337e3abefcdc396e9698bc54dd1080b"}],"kind":"same-version-pgdoc","locale":"zh-Hans","source_revision":"b1b500221dbe5437cfca004d6b04d3f6e422765d","version":"18"},"zh_from":"same-version-manual"},"ManualEvidence":{"doc":{"anchor":"FUNCTIONS-STRING-OTHER","file":"functions-string.html","sha256":"dbe9f91e55c35969d99a8d2697b6f7bd5388a24ccc2b89706a666f176025f1e2","slug":"18"}},"MeasuredEvidence":{}},"Text":{"Collection":"func","Key":"quote-nullable","SourceDatabase":"center","Version":"18","Locale":"en","Title":"quote_nullable","Summary":"Returns the given string suitably quoted to be used as a string literal in an SQL statement string; or, if the argument is null, returns NULL. Embedded single-quotes and backslashes are properly doubled. See also Example 41.1.","BodyHTML":"Returns the given string suitably quoted to be used as a string literal in an SQL statement string; or, if the argument is null, returns \u003ccode\u003eNULL\u003c/code\u003e. Embedded single-quotes and backslashes are properly doubled. See also \u003ca href=\"/docs/18/plpgsql-statements.html#PLPGSQL-QUOTE-LITERAL-EXAMPLE\" rel=\"nofollow\"\u003eExample 41.1\u003c/a\u003e.","SourceRevision":"wiki-repair-20261023:dc13bd7800d6ec00a6365dedb114bab1273fcc9f4487a783968084ef04c4ac39","ContentHash":"f8b035b132e70083725662d92a939492e066272569e3001f5cf711d4ac868e38","Payload":{"description":"Returns the given string suitably quoted to be used as a string literal in an SQL statement string; or, if the argument is null, returns NULL. Embedded single-quotes and backslashes are properly doubled. See also Example 41.1.","description_html":"Returns the given string suitably quoted to be used as a string literal in an SQL statement string; or, if the argument is null, returns \u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e. Embedded single-quotes and backslashes are properly doubled. See also \u003ca href=\"/docs/18/plpgsql-statements.html#PLPGSQL-QUOTE-LITERAL-EXAMPLE\" title=\"Example 41.1. Quoting Values in Dynamic Queries\"\u003eExample 41.1\u003c/a\u003e.","signatures":[{"description":"Returns the given string suitably quoted to be used as a string literal in an SQL statement string; or, if the argument is null, returns NULL. Embedded single-quotes and backslashes are properly doubled. See also Example 41.1.","description_html":"Returns the given string suitably quoted to be used as a string literal in an SQL statement string; or, if the argument is null, returns \u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e. Embedded single-quotes and backslashes are properly doubled. See also \u003ca href=\"/docs/18/plpgsql-statements.html#PLPGSQL-QUOTE-LITERAL-EXAMPLE\" title=\"Example 41.1. Quoting Values in Dynamic Queries\"\u003eExample 41.1\u003c/a\u003e.","description_zh":"为给定字符串添加适当的引号并返回，使其可用作 SQL 语句字符串中的字符串字面量；如果参数为 null，则返回 NULL。内嵌的单引号和反斜杠会被适当地双写。另见例 41.1。","description_zh_html":"为给定字符串添加适当的引号并返回，使其可用作 SQL 语句字符串中的字符串字面量；如果参数为 null，则返回 \u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e。内嵌的单引号和反斜杠会被适当地双写。另见\u003ca href=\"/docs/18/plpgsql-statements.html#PLPGSQL-QUOTE-LITERAL-EXAMPLE\" title=\"例 41.1. 在动态查询中为值加引号\"\u003e例 41.1\u003c/a\u003e。","examples":[{"expr":"quote_nullable(NULL)","result":"NULL"}],"html":"\u003ccode class=\"function\"\u003equote_nullable\u003c/code\u003e ( \u003ccode class=\"type\"\u003etext\u003c/code\u003e ) → \u003ccode class=\"returnvalue\"\u003etext\u003c/code\u003e","returns":"text","text":"quote_nullable ( text ) → text","zh_from":"same-version-manual"},{"description":"Converts the given value to text and then quotes it as a literal; or, if the argument is null, returns NULL. Embedded single-quotes and backslashes are properly doubled.","description_html":"Converts the given value to text and then quotes it as a literal; or, if the argument is null, returns \u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e. Embedded single-quotes and backslashes are properly doubled.","description_zh":"将给定值转换为文本，然后作为字面量加引号；如果参数为 null，则返回 NULL。内嵌的单引号和反斜杠会被适当地双写。","description_zh_html":"将给定值转换为文本，然后作为字面量加引号；如果参数为 null，则返回 \u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e。内嵌的单引号和反斜杠会被适当地双写。","examples":[{"expr":"quote_nullable(42.5)","result":"'42.5'"}],"html":"\u003ccode class=\"function\"\u003equote_nullable\u003c/code\u003e ( \u003ccode class=\"type\"\u003eanyelement\u003c/code\u003e ) → \u003ccode class=\"returnvalue\"\u003etext\u003c/code\u003e","returns":"text","text":"quote_nullable ( anyelement ) → text","zh_from":"same-version-manual"}]}},"RequestedLocale":"en","Fallback":false,"Versions":["10","11","12","13","14","15","16","17","18","19","20","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":"958a00c0ea448ac267846bdd2a6a0c9698a8b71ba7c152482dd53e8db12b4b4a","Text":"quote_nullable ( text ) → text","Returns":"text","Payload":{"description":"Returns the given string suitably quoted to be used as a string literal in an SQL statement string; or, if the argument is null, returns NULL. Embedded single-quotes and backslashes are properly doubled. See also Example 41.1.","description_html":"Returns the given string suitably quoted to be used as a string literal in an SQL statement string; or, if the argument is null, returns \u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e. Embedded single-quotes and backslashes are properly doubled. See also \u003ca href=\"/docs/18/plpgsql-statements.html#PLPGSQL-QUOTE-LITERAL-EXAMPLE\" title=\"Example 41.1. Quoting Values in Dynamic Queries\"\u003eExample 41.1\u003c/a\u003e.","description_zh":"为给定字符串添加适当的引号并返回，使其可用作 SQL 语句字符串中的字符串字面量；如果参数为 null，则返回 NULL。内嵌的单引号和反斜杠会被适当地双写。另见例 41.1。","description_zh_html":"为给定字符串添加适当的引号并返回，使其可用作 SQL 语句字符串中的字符串字面量；如果参数为 null，则返回 \u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e。内嵌的单引号和反斜杠会被适当地双写。另见\u003ca href=\"/docs/18/plpgsql-statements.html#PLPGSQL-QUOTE-LITERAL-EXAMPLE\" title=\"例 41.1. 在动态查询中为值加引号\"\u003e例 41.1\u003c/a\u003e。","examples":[{"expr":"quote_nullable(NULL)","result":"NULL"}],"html":"\u003ccode class=\"function\"\u003equote_nullable\u003c/code\u003e ( \u003ccode class=\"type\"\u003etext\u003c/code\u003e ) → \u003ccode class=\"returnvalue\"\u003etext\u003c/code\u003e","returns":"text","text":"quote_nullable ( text ) → text","zh_from":"same-version-manual"}},{"Version":"18","Ordinal":1,"Hash":"f30fdabc25168aaf8dbe782c1172f942c3a4d723f24de3560f6d7d5e73b3b78a","Text":"quote_nullable ( anyelement ) → text","Returns":"text","Payload":{"description":"Converts the given value to text and then quotes it as a literal; or, if the argument is null, returns NULL. Embedded single-quotes and backslashes are properly doubled.","description_html":"Converts the given value to text and then quotes it as a literal; or, if the argument is null, returns \u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e. Embedded single-quotes and backslashes are properly doubled.","description_zh":"将给定值转换为文本，然后作为字面量加引号；如果参数为 null，则返回 NULL。内嵌的单引号和反斜杠会被适当地双写。","description_zh_html":"将给定值转换为文本，然后作为字面量加引号；如果参数为 null，则返回 \u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e。内嵌的单引号和反斜杠会被适当地双写。","examples":[{"expr":"quote_nullable(42.5)","result":"'42.5'"}],"html":"\u003ccode class=\"function\"\u003equote_nullable\u003c/code\u003e ( \u003ccode class=\"type\"\u003eanyelement\u003c/code\u003e ) → \u003ccode class=\"returnvalue\"\u003etext\u003c/code\u003e","returns":"text","text":"quote_nullable ( anyelement ) → text","zh_from":"same-version-manual"}}],"Spellings":null,"SQLState":null,"Evidence":null}