LCOV - code coverage report
Current view: top level - src/backend/nodes - readfuncs.c (source / functions) Coverage Total Hit
Test: PostgreSQL 20devel Lines: 92.2 % 257 237
Test Date: 2026-09-12 14:15:38 Functions: 93.3 % 15 14
Legend: Lines:     hit not hit
Branches: + taken - not taken # not executed
Branches: 54.7 % 307 168

             Branch data     Line data    Source code
       1                 :             : /*-------------------------------------------------------------------------
       2                 :             :  *
       3                 :             :  * readfuncs.c
       4                 :             :  *    Reader functions for Postgres tree nodes.
       5                 :             :  *
       6                 :             :  * Portions Copyright (c) 1996-2026, PostgreSQL Global Development Group
       7                 :             :  * Portions Copyright (c) 1994, Regents of the University of California
       8                 :             :  *
       9                 :             :  *
      10                 :             :  * IDENTIFICATION
      11                 :             :  *    src/backend/nodes/readfuncs.c
      12                 :             :  *
      13                 :             :  * NOTES
      14                 :             :  *    Parse location fields are written out by outfuncs.c, but only for
      15                 :             :  *    debugging use.  When reading a location field, we normally discard
      16                 :             :  *    the stored value and set the location field to -1 (ie, "unknown").
      17                 :             :  *    This is because nodes coming from a stored rule should not be thought
      18                 :             :  *    to have a known location in the current query's text.
      19                 :             :  *
      20                 :             :  *    However, if restore_location_fields is true, we do restore location
      21                 :             :  *    fields from the string.  This is currently intended only for use by the
      22                 :             :  *    debug_write_read_parse_plan_trees test code, which doesn't want to cause
      23                 :             :  *    any change in the node contents.
      24                 :             :  *
      25                 :             :  *-------------------------------------------------------------------------
      26                 :             :  */
      27                 :             : #include "postgres.h"
      28                 :             : 
      29                 :             : #include "miscadmin.h"
      30                 :             : #include "nodes/bitmapset.h"
      31                 :             : #include "nodes/readfuncs.h"
      32                 :             : 
      33                 :             : 
      34                 :             : /*
      35                 :             :  * Macros to simplify reading of different kinds of fields.  Use these
      36                 :             :  * wherever possible to reduce the chance for silly typos.  Note that these
      37                 :             :  * hard-wire conventions about the names of the local variables in a Read
      38                 :             :  * routine.
      39                 :             :  */
      40                 :             : 
      41                 :             : /* Macros for declaring appropriate local variables */
      42                 :             : 
      43                 :             : /* A few guys need only local_node */
      44                 :             : #define READ_LOCALS_NO_FIELDS(nodeTypeName) \
      45                 :             :     nodeTypeName *local_node = makeNode(nodeTypeName)
      46                 :             : 
      47                 :             : /* And a few guys need only the pg_strtok support fields */
      48                 :             : #define READ_TEMP_LOCALS()  \
      49                 :             :     const char *token;      \
      50                 :             :     int         length
      51                 :             : 
      52                 :             : /* ... but most need both */
      53                 :             : #define READ_LOCALS(nodeTypeName)           \
      54                 :             :     READ_LOCALS_NO_FIELDS(nodeTypeName);    \
      55                 :             :     READ_TEMP_LOCALS()
      56                 :             : 
      57                 :             : /* Read an integer field (anything written as ":fldname %d") */
      58                 :             : #define READ_INT_FIELD(fldname) \
      59                 :             :     token = pg_strtok(ctx, &length);        /* skip :fldname */ \
      60                 :             :     token = pg_strtok(ctx, &length);        /* get field value */ \
      61                 :             :     local_node->fldname = atoi(token)
      62                 :             : 
      63                 :             : /* Read an unsigned integer field (anything written as ":fldname %u") */
      64                 :             : #define READ_UINT_FIELD(fldname) \
      65                 :             :     token = pg_strtok(ctx, &length);        /* skip :fldname */ \
      66                 :             :     token = pg_strtok(ctx, &length);        /* get field value */ \
      67                 :             :     local_node->fldname = atoui(token)
      68                 :             : 
      69                 :             : /* Read a signed integer field (anything written using INT64_FORMAT) */
      70                 :             : #define READ_INT64_FIELD(fldname) \
      71                 :             :     token = pg_strtok(ctx, &length); /* skip :fldname */ \
      72                 :             :     token = pg_strtok(ctx, &length); /* get field value */ \
      73                 :             :     local_node->fldname = strtoi64(token, NULL, 10)
      74                 :             : 
      75                 :             : /* Read an unsigned integer field (anything written using UINT64_FORMAT) */
      76                 :             : #define READ_UINT64_FIELD(fldname) \
      77                 :             :     token = pg_strtok(ctx, &length);        /* skip :fldname */ \
      78                 :             :     token = pg_strtok(ctx, &length);        /* get field value */ \
      79                 :             :     local_node->fldname = strtou64(token, NULL, 10)
      80                 :             : 
      81                 :             : /* Read a long integer field (anything written as ":fldname %ld") */
      82                 :             : #define READ_LONG_FIELD(fldname) \
      83                 :             :     token = pg_strtok(ctx, &length);        /* skip :fldname */ \
      84                 :             :     token = pg_strtok(ctx, &length);        /* get field value */ \
      85                 :             :     local_node->fldname = atol(token)
      86                 :             : 
      87                 :             : /* Read an OID field (don't hard-wire assumption that OID is same as uint) */
      88                 :             : #define READ_OID_FIELD(fldname) \
      89                 :             :     token = pg_strtok(ctx, &length);        /* skip :fldname */ \
      90                 :             :     token = pg_strtok(ctx, &length);        /* get field value */ \
      91                 :             :     local_node->fldname = atooid(token)
      92                 :             : 
      93                 :             : /* Read a char field (ie, one ascii character) */
      94                 :             : #define READ_CHAR_FIELD(fldname) \
      95                 :             :     token = pg_strtok(ctx, &length);        /* skip :fldname */ \
      96                 :             :     token = pg_strtok(ctx, &length);        /* get field value */ \
      97                 :             :     /* avoid overhead of calling debackslash() for one char */ \
      98                 :             :     local_node->fldname = (length == 0) ? '\0' : (token[0] == '\\' ? token[1] : token[0])
      99                 :             : 
     100                 :             : /* Read an enumerated-type field that was written as an integer code */
     101                 :             : #define READ_ENUM_FIELD(fldname, enumtype) \
     102                 :             :     token = pg_strtok(ctx, &length);        /* skip :fldname */ \
     103                 :             :     token = pg_strtok(ctx, &length);        /* get field value */ \
     104                 :             :     local_node->fldname = (enumtype) atoi(token)
     105                 :             : 
     106                 :             : /* Read a float field */
     107                 :             : #define READ_FLOAT_FIELD(fldname) \
     108                 :             :     token = pg_strtok(ctx, &length);        /* skip :fldname */ \
     109                 :             :     token = pg_strtok(ctx, &length);        /* get field value */ \
     110                 :             :     local_node->fldname = atof(token)
     111                 :             : 
     112                 :             : /* Read a boolean field */
     113                 :             : #define READ_BOOL_FIELD(fldname) \
     114                 :             :     token = pg_strtok(ctx, &length);        /* skip :fldname */ \
     115                 :             :     token = pg_strtok(ctx, &length);        /* get field value */ \
     116                 :             :     local_node->fldname = strtobool(token)
     117                 :             : 
     118                 :             : /* Read a character-string field */
     119                 :             : #define READ_STRING_FIELD(fldname) \
     120                 :             :     token = pg_strtok(ctx, &length);        /* skip :fldname */ \
     121                 :             :     token = pg_strtok(ctx, &length);        /* get field value */ \
     122                 :             :     local_node->fldname = nullable_string(token, length)
     123                 :             : 
     124                 :             : /* Read a parse location field (and possibly throw away the value) */
     125                 :             : #ifdef DEBUG_NODE_TESTS_ENABLED
     126                 :             : #define READ_LOCATION_FIELD(fldname) \
     127                 :             :     token = pg_strtok(ctx, &length);        /* skip :fldname */ \
     128                 :             :     token = pg_strtok(ctx, &length);        /* get field value */ \
     129                 :             :     local_node->fldname = ctx->restore_location_fields ? atoi(token) : -1
     130                 :             : #else
     131                 :             : #define READ_LOCATION_FIELD(fldname) \
     132                 :             :     token = pg_strtok(ctx, &length);        /* skip :fldname */ \
     133                 :             :     token = pg_strtok(ctx, &length);        /* get field value */ \
     134                 :             :     (void) token;               /* in case not used elsewhere */ \
     135                 :             :     local_node->fldname = -1 /* set field to "unknown" */
     136                 :             : #endif
     137                 :             : 
     138                 :             : /* Read a Node field */
     139                 :             : #define READ_NODE_FIELD(fldname) \
     140                 :             :     token = pg_strtok(ctx, &length);        /* skip :fldname */ \
     141                 :             :     (void) token;               /* in case not used elsewhere */ \
     142                 :             :     local_node->fldname = nodeRead(ctx, NULL, 0)
     143                 :             : 
     144                 :             : /* Read a bitmapset field */
     145                 :             : #define READ_BITMAPSET_FIELD(fldname) \
     146                 :             :     token = pg_strtok(ctx, &length);        /* skip :fldname */ \
     147                 :             :     (void) token;               /* in case not used elsewhere */ \
     148                 :             :     local_node->fldname = _readBitmapset(ctx)
     149                 :             : 
     150                 :             : /* Read an attribute number array */
     151                 :             : #define READ_ATTRNUMBER_ARRAY(fldname, len) \
     152                 :             :     token = pg_strtok(ctx, &length);        /* skip :fldname */ \
     153                 :             :     local_node->fldname = readAttrNumberCols(ctx, len)
     154                 :             : 
     155                 :             : /* Read an oid array */
     156                 :             : #define READ_OID_ARRAY(fldname, len) \
     157                 :             :     token = pg_strtok(ctx, &length);        /* skip :fldname */ \
     158                 :             :     local_node->fldname = readOidCols(ctx, len)
     159                 :             : 
     160                 :             : /* Read an int array */
     161                 :             : #define READ_INT_ARRAY(fldname, len) \
     162                 :             :     token = pg_strtok(ctx, &length);        /* skip :fldname */ \
     163                 :             :     local_node->fldname = readIntCols(ctx, len)
     164                 :             : 
     165                 :             : /* Read a bool array */
     166                 :             : #define READ_BOOL_ARRAY(fldname, len) \
     167                 :             :     token = pg_strtok(ctx, &length);        /* skip :fldname */ \
     168                 :             :     local_node->fldname = readBoolCols(ctx, len)
     169                 :             : 
     170                 :             : /* Routine exit */
     171                 :             : #define READ_DONE() \
     172                 :             :     return local_node
     173                 :             : 
     174                 :             : 
     175                 :             : /*
     176                 :             :  * NOTE: use atoi() to read values written with %d, or atoui() to read
     177                 :             :  * values written with %u in outfuncs.c.  An exception is OID values,
     178                 :             :  * for which use atooid().  (As of 7.1, outfuncs.c writes OIDs as %u,
     179                 :             :  * but this will probably change in the future.)
     180                 :             :  */
     181                 :             : #define atoui(x)  ((unsigned int) strtoul((x), NULL, 10))
     182                 :             : 
     183                 :             : #define strtobool(x)  ((*(x) == 't') ? true : false)
     184                 :             : 
     185                 :             : static char *
     186                 :    12807223 : nullable_string(const char *token, int length)
     187                 :             : {
     188                 :             :     /* outToken emits <> for NULL, and pg_strtok makes that an empty string */
     189         [ +  + ]:    12807223 :     if (length == 0)
     190                 :     6654275 :         return NULL;
     191                 :             :     /* outToken emits "" for empty string */
     192   [ +  +  +  +  :     6152948 :     if (length == 2 && token[0] == '"' && token[1] == '"')
                   +  - ]
     193                 :         136 :         return pstrdup("");
     194                 :             :     /* otherwise, we must remove protective backslashes added by outToken */
     195                 :     6152812 :     return debackslash(token, length);
     196                 :             : }
     197                 :             : 
     198                 :             : 
     199                 :             : /*
     200                 :             :  * _readBitmapset
     201                 :             :  *
     202                 :             :  * Note: this code is used in contexts where we know that a Bitmapset
     203                 :             :  * is expected.  There is equivalent code in nodeRead() that can read a
     204                 :             :  * Bitmapset when we come across one in other contexts.
     205                 :             :  */
     206                 :             : static Bitmapset *
     207                 :    14173381 : _readBitmapset(ReadNodeContext *ctx)
     208                 :             : {
     209                 :    14173381 :     Bitmapset  *result = NULL;
     210                 :             : 
     211                 :             :     READ_TEMP_LOCALS();
     212                 :             : 
     213                 :    14173381 :     token = pg_strtok(ctx, &length);
     214         [ -  + ]:    14173381 :     if (token == NULL)
     215         [ #  # ]:           0 :         elog(ERROR, "incomplete Bitmapset structure");
     216   [ +  -  -  + ]:    14173381 :     if (length != 1 || token[0] != '(')
     217         [ #  # ]:           0 :         elog(ERROR, "unrecognized token: \"%.*s\"", length, token);
     218                 :             : 
     219                 :    14173381 :     token = pg_strtok(ctx, &length);
     220         [ -  + ]:    14173381 :     if (token == NULL)
     221         [ #  # ]:           0 :         elog(ERROR, "incomplete Bitmapset structure");
     222   [ +  -  -  + ]:    14173381 :     if (length != 1 || token[0] != 'b')
     223         [ #  # ]:           0 :         elog(ERROR, "unrecognized token: \"%.*s\"", length, token);
     224                 :             : 
     225                 :             :     for (;;)
     226                 :     3961494 :     {
     227                 :             :         int         val;
     228                 :             :         char       *endptr;
     229                 :             : 
     230                 :    18134875 :         token = pg_strtok(ctx, &length);
     231         [ -  + ]:    18134875 :         if (token == NULL)
     232         [ #  # ]:           0 :             elog(ERROR, "unterminated Bitmapset structure");
     233   [ +  +  +  + ]:    18134875 :         if (length == 1 && token[0] == ')')
     234                 :    14173381 :             break;
     235                 :     3961494 :         val = (int) strtol(token, &endptr, 10);
     236         [ -  + ]:     3961494 :         if (endptr != token + length)
     237         [ #  # ]:           0 :             elog(ERROR, "unrecognized integer: \"%.*s\"", length, token);
     238                 :     3961494 :         result = bms_add_member(result, val);
     239                 :             :     }
     240                 :             : 
     241                 :    14173381 :     return result;
     242                 :             : }
     243                 :             : 
     244                 :             : /*
     245                 :             :  * We export this function for use by extensions that define extensible nodes.
     246                 :             :  * That's somewhat historical, though, because calling nodeRead() will work.
     247                 :             :  */
     248                 :             : Bitmapset *
     249                 :           0 : readBitmapset(ReadNodeContext *ctx)
     250                 :             : {
     251                 :           0 :     return _readBitmapset(ctx);
     252                 :             : }
     253                 :             : 
     254                 :             : #include "readfuncs.funcs.c"
     255                 :             : 
     256                 :             : 
     257                 :             : /*
     258                 :             :  * Support functions for nodes with custom_read_write attribute or
     259                 :             :  * special_read_write attribute
     260                 :             :  */
     261                 :             : 
     262                 :             : static Const *
     263                 :     2112157 : _readConst(ReadNodeContext *ctx)
     264                 :             : {
     265                 :     2112157 :     READ_LOCALS(Const);
     266                 :             : 
     267                 :     2112157 :     READ_OID_FIELD(consttype);
     268                 :     2112157 :     READ_INT_FIELD(consttypmod);
     269                 :     2112157 :     READ_OID_FIELD(constcollid);
     270                 :     2112157 :     READ_INT_FIELD(constlen);
     271                 :     2112157 :     READ_BOOL_FIELD(constbyval);
     272                 :     2112157 :     READ_BOOL_FIELD(constisnull);
     273         [ +  + ]:     2112157 :     READ_LOCATION_FIELD(location);
     274                 :             : 
     275                 :     2112157 :     token = pg_strtok(ctx, &length);    /* skip :constvalue */
     276         [ +  + ]:     2112157 :     if (local_node->constisnull)
     277                 :      192042 :         token = pg_strtok(ctx, &length);    /* skip "<>" */
     278                 :             :     else
     279                 :     1920115 :         local_node->constvalue = readDatum(ctx, local_node->constbyval);
     280                 :             : 
     281                 :     2112157 :     READ_DONE();
     282                 :             : }
     283                 :             : 
     284                 :             : static BoolExpr *
     285                 :      286967 : _readBoolExpr(ReadNodeContext *ctx)
     286                 :             : {
     287                 :      286967 :     READ_LOCALS(BoolExpr);
     288                 :             : 
     289                 :             :     /* do-it-yourself enum representation */
     290                 :      286967 :     token = pg_strtok(ctx, &length);    /* skip :boolop */
     291                 :      286967 :     token = pg_strtok(ctx, &length);    /* get field value */
     292   [ +  +  +  + ]:      286967 :     if (length == 3 && strncmp(token, "and", 3) == 0)
     293                 :      201606 :         local_node->boolop = AND_EXPR;
     294   [ +  +  +  - ]:       85361 :     else if (length == 2 && strncmp(token, "or", 2) == 0)
     295                 :       37489 :         local_node->boolop = OR_EXPR;
     296   [ +  -  +  - ]:       47872 :     else if (length == 3 && strncmp(token, "not", 3) == 0)
     297                 :       47872 :         local_node->boolop = NOT_EXPR;
     298                 :             :     else
     299         [ #  # ]:           0 :         elog(ERROR, "unrecognized boolop \"%.*s\"", length, token);
     300                 :             : 
     301                 :      286967 :     READ_NODE_FIELD(args);
     302         [ +  + ]:      286967 :     READ_LOCATION_FIELD(location);
     303                 :             : 
     304                 :      286967 :     READ_DONE();
     305                 :             : }
     306                 :             : 
     307                 :             : static A_Const *
     308                 :      927221 : _readA_Const(ReadNodeContext *ctx)
     309                 :             : {
     310                 :      927221 :     READ_LOCALS(A_Const);
     311                 :             : 
     312                 :             :     /* We expect either NULL or :val here */
     313                 :      927221 :     token = pg_strtok(ctx, &length);
     314   [ +  -  +  + ]:      927221 :     if (length == 4 && strncmp(token, "NULL", 4) == 0)
     315                 :       53029 :         local_node->isnull = true;
     316                 :             :     else
     317                 :             :     {
     318                 :      874192 :         union ValUnion *tmp = nodeRead(ctx, NULL, 0);
     319                 :             : 
     320                 :             :         /* To forestall valgrind complaints, copy only the valid data */
     321   [ +  +  +  +  :      874192 :         switch (nodeTag(tmp))
                   +  - ]
     322                 :             :         {
     323                 :      292689 :             case T_Integer:
     324                 :      292689 :                 memcpy(&local_node->val, tmp, sizeof(Integer));
     325                 :      292689 :                 break;
     326                 :        8190 :             case T_Float:
     327                 :        8190 :                 memcpy(&local_node->val, tmp, sizeof(Float));
     328                 :        8190 :                 break;
     329                 :       39641 :             case T_Boolean:
     330                 :       39641 :                 memcpy(&local_node->val, tmp, sizeof(Boolean));
     331                 :       39641 :                 break;
     332                 :      530937 :             case T_String:
     333                 :      530937 :                 memcpy(&local_node->val, tmp, sizeof(String));
     334                 :      530937 :                 break;
     335                 :        2735 :             case T_BitString:
     336                 :        2735 :                 memcpy(&local_node->val, tmp, sizeof(BitString));
     337                 :        2735 :                 break;
     338                 :           0 :             default:
     339         [ #  # ]:           0 :                 elog(ERROR, "unrecognized node type: %d",
     340                 :             :                      (int) nodeTag(tmp));
     341                 :             :                 break;
     342                 :             :         }
     343                 :             :     }
     344                 :             : 
     345         [ +  - ]:      927221 :     READ_LOCATION_FIELD(location);
     346                 :             : 
     347                 :      927221 :     READ_DONE();
     348                 :             : }
     349                 :             : 
     350                 :             : static RangeTblEntry *
     351                 :     1202595 : _readRangeTblEntry(ReadNodeContext *ctx)
     352                 :             : {
     353                 :     1202595 :     READ_LOCALS(RangeTblEntry);
     354                 :             : 
     355                 :     1202595 :     READ_NODE_FIELD(alias);
     356                 :     1202595 :     READ_NODE_FIELD(eref);
     357                 :     1202595 :     READ_ENUM_FIELD(rtekind, RTEKind);
     358                 :             : 
     359   [ +  +  +  +  :     1202595 :     switch (local_node->rtekind)
          +  +  +  +  +  
                   +  - ]
     360                 :             :     {
     361                 :      715201 :         case RTE_RELATION:
     362                 :      715201 :             READ_OID_FIELD(relid);
     363                 :      715201 :             READ_BOOL_FIELD(inh);
     364   [ +  -  -  + ]:      715201 :             READ_CHAR_FIELD(relkind);
     365                 :      715201 :             READ_INT_FIELD(rellockmode);
     366                 :      715201 :             READ_UINT_FIELD(perminfoindex);
     367                 :      715201 :             READ_NODE_FIELD(tablesample);
     368                 :      715201 :             break;
     369                 :      113900 :         case RTE_SUBQUERY:
     370                 :      113900 :             READ_NODE_FIELD(subquery);
     371                 :      113900 :             READ_BOOL_FIELD(security_barrier);
     372                 :             :             /* we re-use these RELATION fields, too: */
     373                 :      113900 :             READ_OID_FIELD(relid);
     374                 :      113900 :             READ_BOOL_FIELD(inh);
     375   [ +  +  -  + ]:      113900 :             READ_CHAR_FIELD(relkind);
     376                 :      113900 :             READ_INT_FIELD(rellockmode);
     377                 :      113900 :             READ_UINT_FIELD(perminfoindex);
     378                 :      113900 :             break;
     379                 :      143012 :         case RTE_JOIN:
     380                 :      143012 :             READ_ENUM_FIELD(jointype, JoinType);
     381                 :      143012 :             READ_INT_FIELD(joinmergedcols);
     382                 :      143012 :             READ_NODE_FIELD(joinaliasvars);
     383                 :      143012 :             READ_NODE_FIELD(joinleftcols);
     384                 :      143012 :             READ_NODE_FIELD(joinrightcols);
     385                 :      143012 :             READ_NODE_FIELD(join_using_alias);
     386                 :      143012 :             break;
     387                 :       69416 :         case RTE_FUNCTION:
     388                 :       69416 :             READ_NODE_FIELD(functions);
     389                 :       69416 :             READ_BOOL_FIELD(funcordinality);
     390                 :       69416 :             break;
     391                 :        1154 :         case RTE_TABLEFUNC:
     392                 :        1154 :             READ_NODE_FIELD(tablefunc);
     393                 :             :             /* The RTE must have a copy of the column type info, if any */
     394         [ +  + ]:        1154 :             if (local_node->tablefunc)
     395                 :             :             {
     396                 :         670 :                 TableFunc  *tf = local_node->tablefunc;
     397                 :             : 
     398                 :         670 :                 local_node->coltypes = tf->coltypes;
     399                 :         670 :                 local_node->coltypmods = tf->coltypmods;
     400                 :         670 :                 local_node->colcollations = tf->colcollations;
     401                 :             :             }
     402                 :        1154 :             break;
     403                 :       15407 :         case RTE_VALUES:
     404                 :       15407 :             READ_NODE_FIELD(values_lists);
     405                 :       15407 :             READ_NODE_FIELD(coltypes);
     406                 :       15407 :             READ_NODE_FIELD(coltypmods);
     407                 :       15407 :             READ_NODE_FIELD(colcollations);
     408                 :       15407 :             break;
     409                 :        8091 :         case RTE_CTE:
     410                 :        8091 :             READ_STRING_FIELD(ctename);
     411                 :        8091 :             READ_UINT_FIELD(ctelevelsup);
     412                 :        8091 :             READ_BOOL_FIELD(self_reference);
     413                 :        8091 :             READ_NODE_FIELD(coltypes);
     414                 :        8091 :             READ_NODE_FIELD(coltypmods);
     415                 :        8091 :             READ_NODE_FIELD(colcollations);
     416                 :        8091 :             break;
     417                 :         708 :         case RTE_NAMEDTUPLESTORE:
     418                 :         708 :             READ_STRING_FIELD(enrname);
     419                 :         708 :             READ_FLOAT_FIELD(enrtuples);
     420                 :         708 :             READ_NODE_FIELD(coltypes);
     421                 :         708 :             READ_NODE_FIELD(coltypmods);
     422                 :         708 :             READ_NODE_FIELD(colcollations);
     423                 :             :             /* we re-use these RELATION fields, too: */
     424                 :         708 :             READ_OID_FIELD(relid);
     425                 :         708 :             break;
     426                 :      127430 :         case RTE_RESULT:
     427                 :             :             /* no extra fields */
     428                 :      127430 :             break;
     429                 :        8276 :         case RTE_GROUP:
     430                 :        8276 :             READ_NODE_FIELD(groupexprs);
     431                 :        8276 :             break;
     432                 :           0 :         default:
     433         [ #  # ]:           0 :             elog(ERROR, "unrecognized RTE kind: %d",
     434                 :             :                  (int) local_node->rtekind);
     435                 :             :             break;
     436                 :             :     }
     437                 :             : 
     438                 :     1202595 :     READ_BOOL_FIELD(lateral);
     439                 :     1202595 :     READ_BOOL_FIELD(inFromCl);
     440                 :     1202595 :     READ_NODE_FIELD(securityQuals);
     441                 :             : 
     442                 :     1202595 :     READ_DONE();
     443                 :             : }
     444                 :             : 
     445                 :             : static A_Expr *
     446                 :      420735 : _readA_Expr(ReadNodeContext *ctx)
     447                 :             : {
     448                 :      420735 :     READ_LOCALS(A_Expr);
     449                 :             : 
     450                 :      420735 :     token = pg_strtok(ctx, &length);
     451                 :             : 
     452   [ +  +  +  + ]:      420735 :     if (length == 3 && strncmp(token, "ANY", 3) == 0)
     453                 :             :     {
     454                 :       10885 :         local_node->kind = AEXPR_OP_ANY;
     455                 :       10885 :         READ_NODE_FIELD(name);
     456                 :             :     }
     457   [ +  +  +  - ]:      409850 :     else if (length == 3 && strncmp(token, "ALL", 3) == 0)
     458                 :             :     {
     459                 :          96 :         local_node->kind = AEXPR_OP_ALL;
     460                 :          96 :         READ_NODE_FIELD(name);
     461                 :             :     }
     462   [ +  +  +  - ]:      409754 :     else if (length == 8 && strncmp(token, "DISTINCT", 8) == 0)
     463                 :             :     {
     464                 :         650 :         local_node->kind = AEXPR_DISTINCT;
     465                 :         650 :         READ_NODE_FIELD(name);
     466                 :             :     }
     467   [ +  +  +  - ]:      409104 :     else if (length == 12 && strncmp(token, "NOT_DISTINCT", 12) == 0)
     468                 :             :     {
     469                 :          88 :         local_node->kind = AEXPR_NOT_DISTINCT;
     470                 :          88 :         READ_NODE_FIELD(name);
     471                 :             :     }
     472   [ +  +  +  - ]:      409016 :     else if (length == 6 && strncmp(token, "NULLIF", 6) == 0)
     473                 :             :     {
     474                 :         587 :         local_node->kind = AEXPR_NULLIF;
     475                 :         587 :         READ_NODE_FIELD(name);
     476                 :             :     }
     477   [ +  +  +  - ]:      408429 :     else if (length == 2 && strncmp(token, "IN", 2) == 0)
     478                 :             :     {
     479                 :       15689 :         local_node->kind = AEXPR_IN;
     480                 :       15689 :         READ_NODE_FIELD(name);
     481                 :             :     }
     482   [ +  +  +  - ]:      392740 :     else if (length == 4 && strncmp(token, "LIKE", 4) == 0)
     483                 :             :     {
     484                 :        1603 :         local_node->kind = AEXPR_LIKE;
     485                 :        1603 :         READ_NODE_FIELD(name);
     486                 :             :     }
     487   [ +  +  +  + ]:      391137 :     else if (length == 5 && strncmp(token, "ILIKE", 5) == 0)
     488                 :             :     {
     489                 :         136 :         local_node->kind = AEXPR_ILIKE;
     490                 :         136 :         READ_NODE_FIELD(name);
     491                 :             :     }
     492   [ +  +  +  + ]:      391001 :     else if (length == 7 && strncmp(token, "SIMILAR", 7) == 0)
     493                 :             :     {
     494                 :          82 :         local_node->kind = AEXPR_SIMILAR;
     495                 :          82 :         READ_NODE_FIELD(name);
     496                 :             :     }
     497   [ +  +  +  - ]:      390919 :     else if (length == 7 && strncmp(token, "BETWEEN", 7) == 0)
     498                 :             :     {
     499                 :         374 :         local_node->kind = AEXPR_BETWEEN;
     500                 :         374 :         READ_NODE_FIELD(name);
     501                 :             :     }
     502   [ +  +  +  + ]:      390545 :     else if (length == 11 && strncmp(token, "NOT_BETWEEN", 11) == 0)
     503                 :             :     {
     504                 :           8 :         local_node->kind = AEXPR_NOT_BETWEEN;
     505                 :           8 :         READ_NODE_FIELD(name);
     506                 :             :     }
     507   [ +  +  +  - ]:      390537 :     else if (length == 11 && strncmp(token, "BETWEEN_SYM", 11) == 0)
     508                 :             :     {
     509                 :           8 :         local_node->kind = AEXPR_BETWEEN_SYM;
     510                 :           8 :         READ_NODE_FIELD(name);
     511                 :             :     }
     512   [ +  +  +  - ]:      390529 :     else if (length == 15 && strncmp(token, "NOT_BETWEEN_SYM", 15) == 0)
     513                 :             :     {
     514                 :           8 :         local_node->kind = AEXPR_NOT_BETWEEN_SYM;
     515                 :           8 :         READ_NODE_FIELD(name);
     516                 :             :     }
     517   [ +  -  +  - ]:      390521 :     else if (length == 5 && strncmp(token, ":name", 5) == 0)
     518                 :             :     {
     519                 :      390521 :         local_node->kind = AEXPR_OP;
     520                 :      390521 :         local_node->name = nodeRead(ctx, NULL, 0);
     521                 :             :     }
     522                 :             :     else
     523         [ #  # ]:           0 :         elog(ERROR, "unrecognized A_Expr kind: \"%.*s\"", length, token);
     524                 :             : 
     525                 :      420735 :     READ_NODE_FIELD(lexpr);
     526                 :      420735 :     READ_NODE_FIELD(rexpr);
     527         [ +  - ]:      420735 :     READ_LOCATION_FIELD(rexpr_list_start);
     528         [ +  - ]:      420735 :     READ_LOCATION_FIELD(rexpr_list_end);
     529         [ +  - ]:      420735 :     READ_LOCATION_FIELD(location);
     530                 :             : 
     531                 :      420735 :     READ_DONE();
     532                 :             : }
     533                 :             : 
     534                 :             : static ExtensibleNode *
     535                 :          22 : _readExtensibleNode(ReadNodeContext *ctx)
     536                 :             : {
     537                 :             :     const ExtensibleNodeMethods *methods;
     538                 :             :     ExtensibleNode *local_node;
     539                 :             :     const char *extnodename;
     540                 :             : 
     541                 :             :     READ_TEMP_LOCALS();
     542                 :             : 
     543                 :          22 :     token = pg_strtok(ctx, &length);    /* skip :extnodename */
     544                 :          22 :     token = pg_strtok(ctx, &length);    /* get extnodename */
     545                 :             : 
     546                 :          22 :     extnodename = nullable_string(token, length);
     547         [ -  + ]:          22 :     if (!extnodename)
     548         [ #  # ]:           0 :         elog(ERROR, "extnodename has to be supplied");
     549                 :          22 :     methods = GetExtensibleNodeMethods(extnodename, false);
     550                 :             : 
     551                 :          22 :     local_node = (ExtensibleNode *) newNode(methods->node_size,
     552                 :             :                                             T_ExtensibleNode);
     553                 :          22 :     local_node->extnodename = extnodename;
     554                 :             : 
     555                 :             :     /* deserialize the private fields */
     556                 :          22 :     methods->nodeRead(ctx, local_node);
     557                 :             : 
     558                 :          21 :     READ_DONE();
     559                 :             : }
     560                 :             : 
     561                 :             : 
     562                 :             : /*
     563                 :             :  * parseNodeString
     564                 :             :  *
     565                 :             :  * Given a character string representing a node tree, parseNodeString creates
     566                 :             :  * the internal node structure.
     567                 :             :  */
     568                 :             : Node *
     569                 :    33780570 : parseNodeString(ReadNodeContext *ctx)
     570                 :             : {
     571                 :             :     READ_TEMP_LOCALS();
     572                 :             : 
     573                 :             :     /* Guard against stack overflow due to overly complex expressions */
     574                 :    33780570 :     check_stack_depth();
     575                 :             : 
     576                 :    33780570 :     token = pg_strtok(ctx, &length);
     577                 :             : 
     578                 :             : #define MATCH(tokname, namelen) \
     579                 :             :     (length == namelen && memcmp(token, tokname, namelen) == 0)
     580                 :             : 
     581                 :             : #include "readfuncs.switch.c"
     582                 :             : 
     583         [ #  # ]:           0 :     elog(ERROR, "badly formatted node string \"%.32s\"...", token);
     584                 :             :     return NULL;                /* keep compiler quiet */
     585                 :             : }
     586                 :             : 
     587                 :             : 
     588                 :             : /*
     589                 :             :  * readDatum
     590                 :             :  *
     591                 :             :  * Given a string representation of a constant, recreate the appropriate
     592                 :             :  * Datum.  The string representation embeds length info, but not byValue,
     593                 :             :  * so we must be told that.
     594                 :             :  */
     595                 :             : Datum
     596                 :     1920115 : readDatum(ReadNodeContext *ctx, bool typbyval)
     597                 :             : {
     598                 :             :     Size        length;
     599                 :             :     int         tokenLength;
     600                 :             :     const char *token;
     601                 :             :     Datum       res;
     602                 :             :     char       *s;
     603                 :             : 
     604                 :             :     /*
     605                 :             :      * read the actual length of the value
     606                 :             :      */
     607                 :     1920115 :     token = pg_strtok(ctx, &tokenLength);
     608                 :     1920115 :     length = atoui(token);
     609                 :             : 
     610                 :     1920115 :     token = pg_strtok(ctx, &tokenLength);   /* read the '[' */
     611   [ +  -  -  + ]:     1920115 :     if (token == NULL || token[0] != '[')
     612   [ #  #  #  # ]:           0 :         elog(ERROR, "expected \"[\" to start datum, but got \"%s\"; length = %zu",
     613                 :             :              token ? token : "[NULL]", length);
     614                 :             : 
     615         [ +  + ]:     1920115 :     if (typbyval)
     616                 :             :     {
     617         [ -  + ]:     1280606 :         if (length > (Size) sizeof(Datum))
     618         [ #  # ]:           0 :             elog(ERROR, "byval datum but length = %zu", length);
     619                 :     1280606 :         res = (Datum) 0;
     620                 :     1280606 :         s = (char *) (&res);
     621         [ +  + ]:    11525454 :         for (Size i = 0; i < (Size) sizeof(Datum); i++)
     622                 :             :         {
     623                 :    10244848 :             token = pg_strtok(ctx, &tokenLength);
     624                 :    10244848 :             s[i] = (char) atoi(token);
     625                 :             :         }
     626                 :             :     }
     627         [ -  + ]:      639509 :     else if (length <= 0)
     628                 :           0 :         res = (Datum) 0;
     629                 :             :     else
     630                 :             :     {
     631                 :      639509 :         s = (char *) palloc(length);
     632         [ +  + ]:    79443682 :         for (Size i = 0; i < length; i++)
     633                 :             :         {
     634                 :    78804173 :             token = pg_strtok(ctx, &tokenLength);
     635                 :    78804173 :             s[i] = (char) atoi(token);
     636                 :             :         }
     637                 :      639509 :         res = PointerGetDatum(s);
     638                 :             :     }
     639                 :             : 
     640                 :     1920115 :     token = pg_strtok(ctx, &tokenLength);   /* read the ']' */
     641   [ +  -  -  + ]:     1920115 :     if (token == NULL || token[0] != ']')
     642   [ #  #  #  # ]:           0 :         elog(ERROR, "expected \"]\" to end datum, but got \"%s\"; length = %zu",
     643                 :             :              token ? token : "[NULL]", length);
     644                 :             : 
     645                 :     1920115 :     return res;
     646                 :             : }
     647                 :             : 
     648                 :             : /*
     649                 :             :  * common implementation for scalar-array-reading functions
     650                 :             :  *
     651                 :             :  * The data format is either "<>" for a NULL pointer (in which case numCols
     652                 :             :  * is ignored) or "(item item item)" where the number of items must equal
     653                 :             :  * numCols.  The convfunc must be okay with stopping at whitespace or a
     654                 :             :  * right parenthesis, since pg_strtok won't null-terminate the token.
     655                 :             :  */
     656                 :             : #define READ_SCALAR_ARRAY(fnname, datatype, convfunc) \
     657                 :             : datatype * \
     658                 :             : fnname(ReadNodeContext *ctx, int numCols) \
     659                 :             : { \
     660                 :             :     datatype   *vals; \
     661                 :             :     READ_TEMP_LOCALS(); \
     662                 :             :     token = pg_strtok(ctx, &length); \
     663                 :             :     if (token == NULL) \
     664                 :             :         elog(ERROR, "incomplete scalar array"); \
     665                 :             :     if (length == 0) \
     666                 :             :         return NULL;            /* it was "<>", so return NULL pointer */ \
     667                 :             :     if (length != 1 || token[0] != '(') \
     668                 :             :         elog(ERROR, "unrecognized token: \"%.*s\"", length, token); \
     669                 :             :     vals = palloc_array(datatype, numCols); \
     670                 :             :     for (int i = 0; i < numCols; i++) \
     671                 :             :     { \
     672                 :             :         token = pg_strtok(ctx, &length); \
     673                 :             :         if (token == NULL || token[0] == ')') \
     674                 :             :             elog(ERROR, "incomplete scalar array"); \
     675                 :             :         vals[i] = convfunc(token); \
     676                 :             :     } \
     677                 :             :     token = pg_strtok(ctx, &length); \
     678                 :             :     if (token == NULL || length != 1 || token[0] != ')') \
     679                 :             :         elog(ERROR, "incomplete scalar array"); \
     680                 :             :     return vals; \
     681                 :             : }
     682                 :             : 
     683                 :             : /*
     684                 :             :  * Note: these functions are exported in nodes.h for possible use by
     685                 :             :  * extensions, so don't mess too much with their names or API.
     686                 :             :  */
     687   [ -  +  -  -  :      352017 : READ_SCALAR_ARRAY(readAttrNumberCols, int16, atoi)
          +  +  +  -  -  
          +  -  -  +  -  
          -  +  -  -  +  
          +  +  -  +  -  
             -  +  -  - ]
     688   [ -  +  -  -  :      436323 : READ_SCALAR_ARRAY(readOidCols, Oid, atooid)
          +  +  +  -  -  
          +  -  -  +  -  
          -  +  -  -  +  
          +  +  -  +  -  
             -  +  -  - ]
     689                 :             : /* outfuncs.c has writeIndexCols, but we don't yet need that here */
     690                 :             : /* READ_SCALAR_ARRAY(readIndexCols, Index, atoui) */
     691   [ -  +  -  -  :       10821 : READ_SCALAR_ARRAY(readIntCols, int, atoi)
          -  +  +  -  -  
          +  -  -  +  -  
          -  +  -  -  +  
          +  +  -  +  -  
             -  +  -  - ]
     692   [ -  +  -  -  :      157309 : READ_SCALAR_ARRAY(readBoolCols, bool, strtobool)
          +  +  +  -  -  
          +  -  -  +  -  
          -  +  -  -  +  
          +  +  -  +  -  
             -  +  -  - ]
        

Generated by: LCOV version 2.0-1