Fix write/read of empty string fields in Nodes.
authorPeter Eisentraut <peter@eisentraut.org>
Mon, 26 Sep 2022 13:25:59 +0000 (15:25 +0200)
committerPeter Eisentraut <peter@eisentraut.org>
Mon, 26 Sep 2022 13:25:59 +0000 (15:25 +0200)
Historically, outToken has represented both NULL and empty-string
strings as "<>", which readfuncs.c then read as NULL, thus failing
to preserve empty-string fields accurately.  Remarkably, this has
not caused any serious problems yet, but let's fix it.

We'll keep the "<>" notation for NULL, and use """" for empty string,
because that matches other notational choices already in use.
An actual input string of """" is converted to "\""" (this was true
already, apparently as a hangover from an ancient time when string
quoting was handled directly by pg_strtok).

CHAR fields also use "<>", but for '\0'.

Author: Tom Lane <tgl@sss.pgh.pa.us>
Discussion: https://www.postgresql.org/message-id/flat/4159834.1657405226@sss.pgh.pa.us

src/backend/nodes/outfuncs.c
src/backend/nodes/readfuncs.c

index 24ea0487e7fc4e542a0468a5389274211c22a2de..63dda75ae52e72a35c228c2bef6207bb2c01a6b8 100644 (file)
@@ -135,16 +135,23 @@ static void outChar(StringInfo str, char c);
  *       Convert an ordinary string (eg, an identifier) into a form that
  *       will be decoded back to a plain token by read.c's functions.
  *
- *       If a null or empty string is given, it is encoded as "<>".
+ *       If a null string pointer is given, it is encoded as '<>'.
+ *       An empty string is encoded as '""'.  To avoid ambiguity, input
+ *       strings beginning with '<' or '"' receive a leading backslash.
  */
 void
 outToken(StringInfo str, const char *s)
 {
-       if (s == NULL || *s == '\0')
+       if (s == NULL)
        {
                appendStringInfoString(str, "<>");
                return;
        }
+       if (*s == '\0')
+       {
+               appendStringInfoString(str, "\"\"");
+               return;
+       }
 
        /*
         * Look for characters or patterns that are treated specially by read.c
@@ -178,6 +185,13 @@ outChar(StringInfo str, char c)
 {
        char            in[2];
 
+       /* Traditionally, we've represented \0 as <>, so keep doing that */
+       if (c == '\0')
+       {
+               appendStringInfoString(str, "<>");
+               return;
+       }
+
        in[0] = c;
        in[1] = '\0';
 
@@ -636,7 +650,8 @@ _outString(StringInfo str, const String *node)
 {
        /*
         * We use outToken to provide escaping of the string's content, but we
-        * don't want it to do anything with an empty string.
+        * don't want it to convert an empty string to '""', because we're putting
+        * double quotes around the string already.
         */
        appendStringInfoChar(str, '"');
        if (node->sval[0] != '\0')
index 89a9a50f7cbdab744e312474bba1264d27e630c5..b4ff855f7c624e6a13821d9c5992e28203f32bf3 100644 (file)
 
 #define strtobool(x)  ((*(x) == 't') ? true : false)
 
-#define nullable_string(token,length)  \
-       ((length) == 0 ? NULL : debackslash(token, length))
+static char *
+nullable_string(const char *token, int length)
+{
+       /* outToken emits <> for NULL, and pg_strtok makes that an empty string */
+       if (length == 0)
+               return NULL;
+       /* outToken emits "" for empty string */
+       if (length == 2 && token[0] == '"' && token[1] == '"')
+               return pstrdup("");
+       /* otherwise, we must remove protective backslashes added by outToken */
+       return debackslash(token, length);
+}
 
 
 /*