{"Entry":{"collection":"func","key":"quote-literal","name":"quote_literal","aliases":[],"metadata":{"changed_in":["8.2","8.3"],"changes":[{"descriptions_changed":false,"doc_overhaul":false,"from":"7.2","group_changed":null,"signatures":{"added":[],"removed":[]},"status":"added","to":"7.3"},{"descriptions_changed":true,"doc_overhaul":false,"from":"7.3","group_changed":null,"signatures":{"added":[],"removed":[]},"status":"changed","to":"7.4"},{"descriptions_changed":true,"doc_overhaul":false,"from":"8.1","group_changed":null,"signatures":{"added":["quote_literal ( string ) → text"],"removed":["quote_literal ( string text ) → text"]},"status":"changed","to":"8.2"},{"descriptions_changed":false,"doc_overhaul":false,"from":"8.2","group_changed":null,"signatures":{"added":["quote_literal ( string text ) → text","quote_literal ( value anyelement ) → text"],"removed":["quote_literal ( string ) → text"]},"status":"changed","to":"8.3"},{"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":"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":"56dc29a54c4d906a42792e1de077ecd67b5e8c8bd966b51a8090b2adf7bf22c8","first_version":"7.3","group":"string","group_label":"String Functions And Operators","groups":["string"],"imported_at":"2026-09-27T17:57:28.382982+08:00","last_version":"20","name":"quote_literal","name_key":"quote_literal","position":3025,"present_in":["7.3","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":"quote_literal ( text ) → text","signature_count":2,"slug":"quote-literal","source_rev":"b7bd9cda","summary":"Returns the given string suitably quoted to be used as a string literal in an SQL statement string.","summary_zh":""}},"Definition":{"Collection":"func","Key":"quote-literal","SourceDatabase":"center","Version":"18","SourceTable":"func","SourceKey":"quote-literal","SourceRevision":"b7bd9cda","Facts":{"description":"Returns the given string suitably quoted to be used as a string literal in an SQL statement string. Embedded single-quotes and backslashes are properly doubled. Note that quote_literal returns null on null input; if the argument might be null, quote_nullable is often more suitable. 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. Embedded single-quotes and backslashes are properly doubled. Note that \u003ccode class=\"function\"\u003equote_literal\u003c/code\u003e returns null on null input; if the argument might be null, \u003ccode class=\"function\"\u003equote_nullable\u003c/code\u003e is often more suitable. 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":"","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":"Returns the given string suitably quoted to be used as a string literal in an SQL statement string. Embedded single-quotes and backslashes are properly doubled. Note that quote_literal returns null on null input; if the argument might be null, quote_nullable is often more suitable. 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. Embedded single-quotes and backslashes are properly doubled. Note that \u003ccode class=\"function\"\u003equote_literal\u003c/code\u003e returns null on null input; if the argument might be null, \u003ccode class=\"function\"\u003equote_nullable\u003c/code\u003e is often more suitable. 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":"","description_zh_html":"","examples":[{"expr":"quote_literal(E'O\\'Reilly')","result":"'O''Reilly'"}],"html":"\u003ccode class=\"function\"\u003equote_literal\u003c/code\u003e ( \u003ccode class=\"type\"\u003etext\u003c/code\u003e ) → \u003ccode class=\"returnvalue\"\u003etext\u003c/code\u003e","returns":"text","text":"quote_literal ( text ) → text","zh_from":""},{"description":"Converts the given value to text and then quotes it as a literal. Embedded single-quotes and backslashes are properly doubled.","description_html":"Converts the given value to text and then quotes it as a literal. Embedded single-quotes and backslashes are properly doubled.","description_zh":"","description_zh_html":"","examples":[{"expr":"quote_literal(42.5)","result":"'42.5'"}],"html":"\u003ccode class=\"function\"\u003equote_literal\u003c/code\u003e ( \u003ccode class=\"type\"\u003eanyelement\u003c/code\u003e ) → \u003ccode class=\"returnvalue\"\u003etext\u003c/code\u003e","returns":"text","text":"quote_literal ( anyelement ) → text","zh_from":""}],"zh_from":""},"ManualEvidence":{"doc":{"anchor":"FUNCTIONS-STRING-OTHER","file":"functions-string.html","slug":"18"}},"MeasuredEvidence":{}},"Text":{"Collection":"func","Key":"quote-literal","SourceDatabase":"pgweb","Version":"18","Locale":"zh-Hans","Title":"quote_literal","Summary":"为给定字符串添加适当的引号并返回，使其可用作SQL语句字符串中的字符串字面量。内嵌的单引号和反斜杠会被适当地双写。注意，quote_literal在输入为 null 时返回 null；如果参数可能为 null，quote_nullable通常更合适。另见例 41.1。","BodyHTML":"为给定字符串添加适当的引号并返回，使其可用作SQL语句字符串中的字符串字面量。内嵌的单引号和反斜杠会被适当地双写。注意，\u003ccode\u003equote_literal\u003c/code\u003e在输入为 null 时返回 null；如果参数可能为 null，\u003ccode\u003equote_nullable\u003c/code\u003e通常更合适。另见\u003ca href=\"/docs/18/plpgsql-statements.html#PLPGSQL-QUOTE-LITERAL-EXAMPLE\" rel=\"nofollow\"\u003e例 41.1\u003c/a\u003e。\u003cpre\u003equote_literal ( text ) → text\u003c/pre\u003e为给定字符串添加适当的引号并返回，使其可用作SQL语句字符串中的字符串字面量。内嵌的单引号和反斜杠会被适当地双写。注意，\u003ccode\u003equote_literal\u003c/code\u003e在输入为 null 时返回 null；如果参数可能为 null，\u003ccode\u003equote_nullable\u003c/code\u003e通常更合适。另见\u003ca href=\"/docs/18/plpgsql-statements.html#PLPGSQL-QUOTE-LITERAL-EXAMPLE\" rel=\"nofollow\"\u003e例 41.1\u003c/a\u003e。\u003cpre\u003equote_literal ( anyelement ) → text\u003c/pre\u003e将给定值转换为文本，然后作为字面量加引号。内嵌的单引号和反斜杠会被适当地双写。","SourceRevision":"ca936764","ContentHash":"d9d118e660e7a2b94ea11e2589f247455b4401dcf9503d0b186faf8e0e304e0e","Payload":{"description_zh":"为给定字符串添加适当的引号并返回，使其可用作SQL语句字符串中的字符串字面量。内嵌的单引号和反斜杠会被适当地双写。注意，quote_literal在输入为 null 时返回 null；如果参数可能为 null，quote_nullable通常更合适。另见例 41.1。","description_zh_html":"为给定字符串添加适当的引号并返回，使其可用作SQL语句字符串中的字符串字面量。内嵌的单引号和反斜杠会被适当地双写。注意，\u003ccode class=\"function\"\u003equote_literal\u003c/code\u003e在输入为 null 时返回 null；如果参数可能为 null，\u003ccode class=\"function\"\u003equote_nullable\u003c/code\u003e通常更合适。另见\u003ca href=\"/docs/18/plpgsql-statements.html#PLPGSQL-QUOTE-LITERAL-EXAMPLE\" title=\"例 41.1. 在动态查询中为值加引号\"\u003e例 41.1\u003c/a\u003e。","signatures":[{"description_zh":"为给定字符串添加适当的引号并返回，使其可用作SQL语句字符串中的字符串字面量。内嵌的单引号和反斜杠会被适当地双写。注意，quote_literal在输入为 null 时返回 null；如果参数可能为 null，quote_nullable通常更合适。另见例 41.1。","description_zh_html":"为给定字符串添加适当的引号并返回，使其可用作SQL语句字符串中的字符串字面量。内嵌的单引号和反斜杠会被适当地双写。注意，\u003ccode class=\"function\"\u003equote_literal\u003c/code\u003e在输入为 null 时返回 null；如果参数可能为 null，\u003ccode class=\"function\"\u003equote_nullable\u003c/code\u003e通常更合适。另见\u003ca href=\"/docs/18/plpgsql-statements.html#PLPGSQL-QUOTE-LITERAL-EXAMPLE\" title=\"例 41.1. 在动态查询中为值加引号\"\u003e例 41.1\u003c/a\u003e。","returns":"text","text":"quote_literal ( text ) → text","zh_from":"doc"},{"description_zh":"将给定值转换为文本，然后作为字面量加引号。内嵌的单引号和反斜杠会被适当地双写。","description_zh_html":"将给定值转换为文本，然后作为字面量加引号。内嵌的单引号和反斜杠会被适当地双写。","returns":"text","text":"quote_literal ( anyelement ) → 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.3","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":"95cab551fadada04e85fdf71c6ae8ce165e97ea873cc0e6de35a99116be9ad39","Text":"quote_literal ( text ) → text","Returns":"text","Payload":{"description":"Returns the given string suitably quoted to be used as a string literal in an SQL statement string. Embedded single-quotes and backslashes are properly doubled. Note that quote_literal returns null on null input; if the argument might be null, quote_nullable is often more suitable. 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. Embedded single-quotes and backslashes are properly doubled. Note that \u003ccode class=\"function\"\u003equote_literal\u003c/code\u003e returns null on null input; if the argument might be null, \u003ccode class=\"function\"\u003equote_nullable\u003c/code\u003e is often more suitable. 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":"","description_zh_html":"","examples":[{"expr":"quote_literal(E'O\\'Reilly')","result":"'O''Reilly'"}],"html":"\u003ccode class=\"function\"\u003equote_literal\u003c/code\u003e ( \u003ccode class=\"type\"\u003etext\u003c/code\u003e ) → \u003ccode class=\"returnvalue\"\u003etext\u003c/code\u003e","returns":"text","text":"quote_literal ( text ) → text","zh_from":""}},{"Version":"18","Ordinal":1,"Hash":"8b7ab2afbf1c41a8a735439e1c5936d3e670281b919eb0bf23cce6abbc5c98c3","Text":"quote_literal ( anyelement ) → text","Returns":"text","Payload":{"description":"Converts the given value to text and then quotes it as a literal. Embedded single-quotes and backslashes are properly doubled.","description_html":"Converts the given value to text and then quotes it as a literal. Embedded single-quotes and backslashes are properly doubled.","description_zh":"","description_zh_html":"","examples":[{"expr":"quote_literal(42.5)","result":"'42.5'"}],"html":"\u003ccode class=\"function\"\u003equote_literal\u003c/code\u003e ( \u003ccode class=\"type\"\u003eanyelement\u003c/code\u003e ) → \u003ccode class=\"returnvalue\"\u003etext\u003c/code\u003e","returns":"text","text":"quote_literal ( anyelement ) → text","zh_from":""}}],"Spellings":null,"SQLState":null,"Evidence":null}