tupdesc.h File Reference

#include "access/attnum.h"
#include "catalog/pg_attribute.h"
#include "nodes/pg_list.h"

Include dependency graph for tupdesc.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	AttrDefault
struct	ConstrCheck
struct	TupleConstr
struct	CompactAttribute
struct	TupleDescData

Macros
#define	ATTNULLABLE_UNRESTRICTED   'f' /* No constraint exists */
#define	ATTNULLABLE_UNKNOWN   'u' /* constraint exists, validity unknown */
#define	ATTNULLABLE_VALID   'v' /* valid constraint exists */
#define	ATTNULLABLE_INVALID   'i' /* constraint exists, marked invalid */
#define	TupleDescAttrAddress(desc)
#define	TupleDescSize(src)
#define	PinTupleDesc(tupdesc)
#define	ReleaseTupleDesc(tupdesc)

Typedefs
typedef struct AttrDefault	AttrDefault
typedef struct ConstrCheck	ConstrCheck
typedef struct TupleConstr	TupleConstr
typedef struct CompactAttribute	CompactAttribute
typedef struct TupleDescData	TupleDescData
typedef struct TupleDescData *	TupleDesc

Functions
void	populate_compact_attribute (TupleDesc tupdesc, int attnum)
static FormData_pg_attribute *	TupleDescAttr (TupleDesc tupdesc, int i)
void	verify_compact_attribute (TupleDesc, int attnum)
static CompactAttribute *	TupleDescCompactAttr (TupleDesc tupdesc, int i)
TupleDesc	CreateTemplateTupleDesc (int natts)
TupleDesc	CreateTupleDesc (int natts, Form_pg_attribute *attrs)
TupleDesc	CreateTupleDescCopy (TupleDesc tupdesc)
TupleDesc	CreateTupleDescTruncatedCopy (TupleDesc tupdesc, int natts)
TupleDesc	CreateTupleDescCopyConstr (TupleDesc tupdesc)
void	TupleDescCopy (TupleDesc dst, TupleDesc src)
void	TupleDescCopyEntry (TupleDesc dst, AttrNumber dstAttno, TupleDesc src, AttrNumber srcAttno)
void	TupleDescFinalize (TupleDesc tupdesc)
void	FreeTupleDesc (TupleDesc tupdesc)
void	IncrTupleDescRefCount (TupleDesc tupdesc)
void	DecrTupleDescRefCount (TupleDesc tupdesc)
bool	equalTupleDescs (TupleDesc tupdesc1, TupleDesc tupdesc2)
bool	equalRowTypes (TupleDesc tupdesc1, TupleDesc tupdesc2)
uint32	hashRowType (TupleDesc desc)
void	TupleDescInitEntry (TupleDesc desc, AttrNumber attributeNumber, const char *attributeName, Oid oidtypeid, int32 typmod, int attdim)
void	TupleDescInitBuiltinEntry (TupleDesc desc, AttrNumber attributeNumber, const char *attributeName, Oid oidtypeid, int32 typmod, int attdim)
void	TupleDescInitEntryCollation (TupleDesc desc, AttrNumber attributeNumber, Oid collationid)
TupleDesc	BuildDescFromLists (const List *names, const List *types, const List *typmods, const List *collations)
Node *	TupleDescGetDefault (TupleDesc tupdesc, AttrNumber attnum)

Macro Definition Documentation

ATTNULLABLE_INVALID

#define ATTNULLABLE_INVALID   'i' /* constraint exists, marked invalid */

Definition at line 87 of file tupdesc.h.

ATTNULLABLE_UNKNOWN

#define ATTNULLABLE_UNKNOWN   'u' /* constraint exists, validity unknown */

Definition at line 85 of file tupdesc.h.

ATTNULLABLE_UNRESTRICTED

#define ATTNULLABLE_UNRESTRICTED   'f' /* No constraint exists */

Definition at line 84 of file tupdesc.h.

ATTNULLABLE_VALID

#define ATTNULLABLE_VALID   'v' /* valid constraint exists */

Definition at line 86 of file tupdesc.h.

PinTupleDesc

#define PinTupleDesc

(

tupdesc

)

Value:

    do { \
		if ((tupdesc)->tdrefcount >= 0) \
			IncrTupleDescRefCount(tupdesc); \
    } while (0)

Definition at line 234 of file tupdesc.h.

       { \
		if ((tupdesc)->tdrefcount >= 0) \
			IncrTupleDescRefCount(tupdesc); \
    } while (0)

ReleaseTupleDesc

#define ReleaseTupleDesc

(

tupdesc

)

Value:

    do { \
		if ((tupdesc)->tdrefcount >= 0) \
			DecrTupleDescRefCount(tupdesc); \
    } while (0)

Definition at line 240 of file tupdesc.h.

       { \
		if ((tupdesc)->tdrefcount >= 0) \
			DecrTupleDescRefCount(tupdesc); \
    } while (0)

TupleDescAttrAddress

#define TupleDescAttrAddress

(

desc

)

Value:

    (Form_pg_attribute) ((char *) (desc) + \
     (offsetof(struct TupleDescData, compact_attrs) + \
     (desc)->natts * sizeof(CompactAttribute)))

Definition at line 171 of file tupdesc.h.

TupleDescSize

#define TupleDescSize

(

src

)

Value:

    (offsetof(struct TupleDescData, compact_attrs) + \
     (src)->natts * sizeof(CompactAttribute) + \
     (src)->natts * sizeof(FormData_pg_attribute))

Definition at line 218 of file tupdesc.h.

Typedef Documentation

AttrDefault

typedef struct AttrDefault AttrDefault

CompactAttribute

typedef struct CompactAttribute CompactAttribute

ConstrCheck

typedef struct ConstrCheck ConstrCheck

TupleConstr

typedef struct TupleConstr TupleConstr

TupleDesc

typedef struct TupleDescData* TupleDesc

Definition at line 163 of file tupdesc.h.

TupleDescData

typedef struct TupleDescData TupleDescData

Function Documentation

BuildDescFromLists()

TupleDesc BuildDescFromLists ( const List *  names, const List *  types, const List *  typmods, const List *  collations  )

extern

Definition at line 1118 of file tupdesc.c.

{
    int         natts;
    AttrNumber  attnum;
    ListCell   *l1;
    ListCell   *l2;
    ListCell   *l3;
    ListCell   *l4;
    TupleDesc   desc;
 
    natts = list_length(names);
    Assert(natts == list_length(types));
    Assert(natts == list_length(typmods));
    Assert(natts == list_length(collations));
 
    /*
     * allocate a new tuple descriptor
     */
    desc = CreateTemplateTupleDesc(natts);
 
    attnum = 0;
    forfour(l1, names, l2, types, l3, typmods, l4, collations)
    {
        char       *attname = strVal(lfirst(l1));
        Oid         atttypid = lfirst_oid(l2);
        int32       atttypmod = lfirst_int(l3);
        Oid         attcollation = lfirst_oid(l4);
 
        attnum++;
 
        TupleDescInitEntry(desc, attnum, attname, atttypid, atttypmod, 0);
        TupleDescInitEntryCollation(desc, attnum, attcollation);
    }
 
    TupleDescFinalize(desc);
 
    return desc;
}

References Assert, attname, attnum, CreateTemplateTupleDesc(), fb(), forfour, lfirst, lfirst_int, lfirst_oid, list_length(), strVal, TupleDescFinalize(), TupleDescInitEntry(), TupleDescInitEntryCollation(), and types.

Referenced by ExecInitFunctionScan(), ExecInitTableFuncScan(), and inline_sql_function_in_from().

CreateTemplateTupleDesc()

TupleDesc CreateTemplateTupleDesc ( int  natts )

extern

Definition at line 165 of file tupdesc.c.

{
    TupleDesc   desc;
 
    /*
     * sanity checks
     */
    Assert(natts >= 0);
 
    /*
     * Allocate enough memory for the tuple descriptor, the CompactAttribute
     * array and also an array of FormData_pg_attribute.
     *
     * Note: the FormData_pg_attribute array stride is
     * sizeof(FormData_pg_attribute), since we declare the array elements as
     * FormData_pg_attribute for notational convenience.  However, we only
     * guarantee that the first ATTRIBUTE_FIXED_PART_SIZE bytes of each entry
     * are valid; most code that copies tupdesc entries around copies just
     * that much.  In principle that could be less due to trailing padding,
     * although with the current definition of pg_attribute there probably
     * isn't any padding.
     */
    desc = (TupleDesc) palloc(offsetof(struct TupleDescData, compact_attrs) +
                              natts * sizeof(CompactAttribute) +
                              natts * sizeof(FormData_pg_attribute));
 
    /*
     * Initialize other fields of the tupdesc.
     */
    desc->natts = natts;
    desc->constr = NULL;
    desc->tdtypeid = RECORDOID;
    desc->tdtypmod = -1;
    desc->tdrefcount = -1;      /* assume not reference-counted */
 
    /* This will be set to the correct value by TupleDescFinalize() */
    desc->firstNonCachedOffsetAttr = -1;
    desc->firstNonGuaranteedAttr = -1;
 
    return desc;
}

References Assert, TupleDescData::constr, fb(), TupleDescData::firstNonCachedOffsetAttr, TupleDescData::firstNonGuaranteedAttr, FormData_pg_attribute, TupleDescData::natts, palloc(), TupleDescData::tdrefcount, TupleDescData::tdtypeid, and TupleDescData::tdtypmod.

Referenced by aclexplode(), addRangeTableEntryForFunction(), AllocateRelationDesc(), BeginCopyTo(), brtuple_disk_tupdesc(), build_buffercache_pages_tupledesc(), build_function_result_tupdesc_d(), build_row_from_vars(), BuildDescForRelation(), BuildDescFromLists(), BuildHardcodedDescriptor(), ConstructTupleDescriptor(), create_toast_table(), CreateReplicationSlot(), CreateTupleDesc(), CreateTupleDescCopy(), CreateTupleDescCopyConstr(), CreateTupleDescTruncatedCopy(), dblink_get_pkey(), ExecInitFunctionScan(), ExecMakeTableFunctionResult(), ExecTypeFromExprList(), ExecTypeFromTLInternal(), expandRecordVariable(), ExplainResultDesc(), formrdesc(), get_expr_result_type(), GetPGVariableResultDesc(), gistrescan(), IdentifySystem(), init_sexpr(), initGinState(), libpqrcv_processTuples(), load_relcache_init_file(), materializeQueryResult(), materializeResult(), ordered_set_startup(), pg_buffercache_os_pages_internal(), pg_get_publication_tables(), pg_get_sequence_data(), pg_lock_status(), pg_prepared_xact(), pg_stat_file(), pg_stat_get_archiver(), pg_stat_get_backend_subxact(), pg_stat_get_replication_slot(), pg_stat_get_subscription_stats(), pg_stat_wal_build_tuple(), pg_visibility_tupdesc(), pg_walfile_name_offset(), ReadReplicationSlot(), SendTablespaceList(), SendTimeLineHistory(), SendXlogRecPtrResult(), show_all_settings(), ShowAllGUCConfig(), ShowGUCConfigOption(), StartReplication(), test_custom_stats_fixed_report(), test_predtest(), tsvector_unnest(), TypeGetTupleDesc(), and WaitStmtResultDesc().

CreateTupleDesc()

TupleDesc CreateTupleDesc ( int  natts, Form_pg_attribute *  attrs  )

extern

Definition at line 216 of file tupdesc.c.

{
    TupleDesc   desc;
    int         i;
 
    desc = CreateTemplateTupleDesc(natts);
 
    for (i = 0; i < natts; ++i)
    {
        memcpy(TupleDescAttr(desc, i), attrs[i], ATTRIBUTE_FIXED_PART_SIZE);
        populate_compact_attribute(desc, i);
    }
 
    TupleDescFinalize(desc);
 
    return desc;
}

References ATTRIBUTE_FIXED_PART_SIZE, CreateTemplateTupleDesc(), fb(), i, memcpy(), populate_compact_attribute(), TupleDescAttr(), and TupleDescFinalize().

Referenced by AddNewAttributeTuples(), and InsertOneTuple().

CreateTupleDescCopy()

TupleDesc CreateTupleDescCopy ( TupleDesc  tupdesc )

extern

Definition at line 242 of file tupdesc.c.

{
    TupleDesc   desc;
    int         i;
 
    desc = CreateTemplateTupleDesc(tupdesc->natts);
 
    /* Flat-copy the attribute array (unless there are no attributes) */
    if (desc->natts > 0)
        memcpy(TupleDescAttr(desc, 0),
               TupleDescAttr(tupdesc, 0),
               desc->natts * sizeof(FormData_pg_attribute));
 
    /*
     * Since we're not copying constraints and defaults, clear fields
     * associated with them.
     */
    for (i = 0; i < desc->natts; i++)
    {
        Form_pg_attribute att = TupleDescAttr(desc, i);
 
        att->attnotnull = false;
        att->atthasdef = false;
        att->atthasmissing = false;
        att->attidentity = '\0';
        att->attgenerated = '\0';
 
        populate_compact_attribute(desc, i);
    }
 
    /* We can copy the tuple type identification, too */
    desc->tdtypeid = tupdesc->tdtypeid;
    desc->tdtypmod = tupdesc->tdtypmod;
 
    TupleDescFinalize(desc);
 
    return desc;
}

References CreateTemplateTupleDesc(), FormData_pg_attribute, i, memcpy(), TupleDescData::natts, populate_compact_attribute(), TupleDescData::tdtypeid, TupleDescData::tdtypmod, TupleDescAttr(), and TupleDescFinalize().

Referenced by assign_record_type_typmod(), BuildTupleHashTable(), cfunc_hashtable_insert(), CompleteCachedPlan(), connectby_text(), connectby_text_serial(), CopyCachedPlan(), crosstab(), crosstab_hash(), database_to_xmlschema_internal(), do_autovacuum(), ExecEvalWholeRowVar(), ExecInitForeignScan(), ExecInitFunctionScan(), ExecInsert(), ExecPrepareTuplestoreResult(), FetchPreparedStatementResultDesc(), fmgr_sql(), get_record_type_from_query(), get_tupdesc_for_join_scan_tuples(), GetAfterTriggersStoreSlot(), getSpGistTupleDesc(), init_sexpr(), InitMaterializedSRF(), make_expanded_record_from_exprecord(), make_expanded_record_from_tupdesc(), materializeResult(), PersistHoldablePortal(), plperl_return_next_internal(), plpgsql_exec_function(), pltcl_func_handler(), PLy_spi_execute_fetch_result(), populate_recordset_worker(), RelationBuildLocalRelation(), RelationNameGetTupleDesc(), RevalidateCachedQuery(), schema_to_xmlschema_internal(), spi_dest_startup(), sql_compile_callback(), storeRow(), update_cached_tupdesc(), and UtilityTupleDescriptor().

CreateTupleDescCopyConstr()

TupleDesc CreateTupleDescCopyConstr ( TupleDesc  tupdesc )

extern

Definition at line 336 of file tupdesc.c.

{
    TupleDesc   desc;
    TupleConstr *constr = tupdesc->constr;
    int         i;
 
    desc = CreateTemplateTupleDesc(tupdesc->natts);
 
    /* Flat-copy the attribute array (unless there are no attributes) */
    if (desc->natts > 0)
        memcpy(TupleDescAttr(desc, 0),
               TupleDescAttr(tupdesc, 0),
               desc->natts * sizeof(FormData_pg_attribute));
 
    for (i = 0; i < desc->natts; i++)
    {
        populate_compact_attribute(desc, i);
 
        TupleDescCompactAttr(desc, i)->attnullability =
            TupleDescCompactAttr(tupdesc, i)->attnullability;
    }
 
    /* Copy the TupleConstr data structure, if any */
    if (constr)
    {
        TupleConstr *cpy = palloc0_object(TupleConstr);
 
        cpy->has_not_null = constr->has_not_null;
        cpy->has_generated_stored = constr->has_generated_stored;
        cpy->has_generated_virtual = constr->has_generated_virtual;
 
        if ((cpy->num_defval = constr->num_defval) > 0)
        {
            cpy->defval = (AttrDefault *) palloc(cpy->num_defval * sizeof(AttrDefault));
            memcpy(cpy->defval, constr->defval, cpy->num_defval * sizeof(AttrDefault));
            for (i = cpy->num_defval - 1; i >= 0; i--)
                cpy->defval[i].adbin = pstrdup(constr->defval[i].adbin);
        }
 
        if (constr->missing)
        {
            cpy->missing = (AttrMissing *) palloc(tupdesc->natts * sizeof(AttrMissing));
            memcpy(cpy->missing, constr->missing, tupdesc->natts * sizeof(AttrMissing));
            for (i = tupdesc->natts - 1; i >= 0; i--)
            {
                if (constr->missing[i].am_present)
                {
                    CompactAttribute *attr = TupleDescCompactAttr(tupdesc, i);
 
                    cpy->missing[i].am_value = datumCopy(constr->missing[i].am_value,
                                                         attr->attbyval,
                                                         attr->attlen);
                }
            }
        }
 
        if ((cpy->num_check = constr->num_check) > 0)
        {
            cpy->check = (ConstrCheck *) palloc(cpy->num_check * sizeof(ConstrCheck));
            memcpy(cpy->check, constr->check, cpy->num_check * sizeof(ConstrCheck));
            for (i = cpy->num_check - 1; i >= 0; i--)
            {
                cpy->check[i].ccname = pstrdup(constr->check[i].ccname);
                cpy->check[i].ccbin = pstrdup(constr->check[i].ccbin);
                cpy->check[i].ccenforced = constr->check[i].ccenforced;
                cpy->check[i].ccvalid = constr->check[i].ccvalid;
                cpy->check[i].ccnoinherit = constr->check[i].ccnoinherit;
            }
        }
 
        desc->constr = cpy;
    }
 
    /* We can copy the tuple type identification, too */
    desc->tdtypeid = tupdesc->tdtypeid;
    desc->tdtypmod = tupdesc->tdtypmod;
 
    TupleDescFinalize(desc);
 
    return desc;
}

References AttrDefault::adbin, AttrMissing::am_present, AttrMissing::am_value, CompactAttribute::attbyval, CompactAttribute::attlen, CompactAttribute::attnullability, ConstrCheck::ccbin, ConstrCheck::ccenforced, ConstrCheck::ccname, ConstrCheck::ccnoinherit, ConstrCheck::ccvalid, TupleConstr::check, TupleDescData::constr, CreateTemplateTupleDesc(), datumCopy(), TupleConstr::defval, fb(), FormData_pg_attribute, TupleConstr::has_generated_stored, TupleConstr::has_generated_virtual, TupleConstr::has_not_null, i, memcpy(), TupleConstr::missing, TupleDescData::natts, TupleConstr::num_check, TupleConstr::num_defval, palloc(), palloc0_object, populate_compact_attribute(), pstrdup(), TupleDescData::tdtypeid, TupleDescData::tdtypmod, TupleDescAttr(), TupleDescCompactAttr(), and TupleDescFinalize().

Referenced by ATGetQueueEntry(), CatalogCacheInitializeCache(), init_tuple_slot(), and lookup_rowtype_tupdesc_copy().

CreateTupleDescTruncatedCopy()

TupleDesc CreateTupleDescTruncatedCopy ( TupleDesc  tupdesc, int  natts  )

extern

Definition at line 289 of file tupdesc.c.

{
    TupleDesc   desc;
    int         i;
 
    Assert(natts <= tupdesc->natts);
 
    desc = CreateTemplateTupleDesc(natts);
 
    /* Flat-copy the attribute array (unless there are no attributes) */
    if (desc->natts > 0)
        memcpy(TupleDescAttr(desc, 0),
               TupleDescAttr(tupdesc, 0),
               desc->natts * sizeof(FormData_pg_attribute));
 
    /*
     * Since we're not copying constraints and defaults, clear fields
     * associated with them.
     */
    for (i = 0; i < desc->natts; i++)
    {
        Form_pg_attribute att = TupleDescAttr(desc, i);
 
        att->attnotnull = false;
        att->atthasdef = false;
        att->atthasmissing = false;
        att->attidentity = '\0';
        att->attgenerated = '\0';
 
        populate_compact_attribute(desc, i);
    }
 
    /* We can copy the tuple type identification, too */
    desc->tdtypeid = tupdesc->tdtypeid;
    desc->tdtypmod = tupdesc->tdtypmod;
 
    TupleDescFinalize(desc);
 
    return desc;
}

References Assert, CreateTemplateTupleDesc(), fb(), FormData_pg_attribute, i, memcpy(), TupleDescData::natts, populate_compact_attribute(), TupleDescData::tdtypeid, TupleDescData::tdtypmod, TupleDescAttr(), and TupleDescFinalize().

Referenced by gist_page_items(), index_truncate_tuple(), and initGISTstate().

DecrTupleDescRefCount()

void DecrTupleDescRefCount ( TupleDesc  tupdesc )

extern

Definition at line 644 of file tupdesc.c.

{
    Assert(tupdesc->tdrefcount > 0);
 
    ResourceOwnerForgetTupleDesc(CurrentResourceOwner, tupdesc);
    if (--tupdesc->tdrefcount == 0)
        FreeTupleDesc(tupdesc);
}

References Assert, CurrentResourceOwner, FreeTupleDesc(), ResourceOwnerForgetTupleDesc(), and TupleDescData::tdrefcount.

Referenced by cache_record_field_properties(), and ExecEvalConvertRowtype().

equalRowTypes()

bool equalRowTypes ( TupleDesc  tupdesc1, TupleDesc  tupdesc2  )

extern

Definition at line 844 of file tupdesc.c.

{
    if (tupdesc1->natts != tupdesc2->natts)
        return false;
    if (tupdesc1->tdtypeid != tupdesc2->tdtypeid)
        return false;
 
    for (int i = 0; i < tupdesc1->natts; i++)
    {
        Form_pg_attribute attr1 = TupleDescAttr(tupdesc1, i);
        Form_pg_attribute attr2 = TupleDescAttr(tupdesc2, i);
 
        if (strcmp(NameStr(attr1->attname), NameStr(attr2->attname)) != 0)
            return false;
        if (attr1->atttypid != attr2->atttypid)
            return false;
        if (attr1->atttypmod != attr2->atttypmod)
            return false;
        if (attr1->attcollation != attr2->attcollation)
            return false;
 
        /* Record types derived from tables could have dropped fields. */
        if (attr1->attisdropped != attr2->attisdropped)
            return false;
    }
 
    return true;
}

References fb(), i, NameStr, and TupleDescAttr().

Referenced by acquire_inherited_sample_rows(), cfunc_match(), ProcedureCreate(), record_type_typmod_compare(), RevalidateCachedQuery(), and shared_record_table_compare().

equalTupleDescs()

bool equalTupleDescs ( TupleDesc  tupdesc1, TupleDesc  tupdesc2  )

extern

Definition at line 657 of file tupdesc.c.

{
    int         i,
                n;
 
    if (tupdesc1->natts != tupdesc2->natts)
        return false;
    if (tupdesc1->tdtypeid != tupdesc2->tdtypeid)
        return false;
 
    /* tdtypmod and tdrefcount are not checked */
 
    for (i = 0; i < tupdesc1->natts; i++)
    {
        Form_pg_attribute attr1 = TupleDescAttr(tupdesc1, i);
        Form_pg_attribute attr2 = TupleDescAttr(tupdesc2, i);
 
        /*
         * We do not need to check every single field here: we can disregard
         * attrelid and attnum (which were used to place the row in the attrs
         * array in the first place).  It might look like we could dispense
         * with checking attlen/attbyval/attalign, since these are derived
         * from atttypid; but in the case of dropped columns we must check
         * them (since atttypid will be zero for all dropped columns) and in
         * general it seems safer to check them always.
         *
         * We intentionally ignore atthasmissing, since that's not very
         * relevant in tupdescs, which lack the attmissingval field.
         */
        if (strcmp(NameStr(attr1->attname), NameStr(attr2->attname)) != 0)
            return false;
        if (attr1->atttypid != attr2->atttypid)
            return false;
        if (attr1->attlen != attr2->attlen)
            return false;
        if (attr1->attndims != attr2->attndims)
            return false;
        if (attr1->atttypmod != attr2->atttypmod)
            return false;
        if (attr1->attbyval != attr2->attbyval)
            return false;
        if (attr1->attalign != attr2->attalign)
            return false;
        if (attr1->attstorage != attr2->attstorage)
            return false;
        if (attr1->attcompression != attr2->attcompression)
            return false;
        if (attr1->attnotnull != attr2->attnotnull)
            return false;
 
        /*
         * When the column has a not-null constraint, we also need to consider
         * its validity aspect, which only manifests in CompactAttribute->
         * attnullability, so verify that.
         */
        if (attr1->attnotnull)
        {
            CompactAttribute *cattr1 = TupleDescCompactAttr(tupdesc1, i);
            CompactAttribute *cattr2 = TupleDescCompactAttr(tupdesc2, i);
 
            Assert(cattr1->attnullability != ATTNULLABLE_UNKNOWN);
            Assert((cattr1->attnullability == ATTNULLABLE_UNKNOWN) ==
                   (cattr2->attnullability == ATTNULLABLE_UNKNOWN));
 
            if (cattr1->attnullability != cattr2->attnullability)
                return false;
        }
        if (attr1->atthasdef != attr2->atthasdef)
            return false;
        if (attr1->attidentity != attr2->attidentity)
            return false;
        if (attr1->attgenerated != attr2->attgenerated)
            return false;
        if (attr1->attisdropped != attr2->attisdropped)
            return false;
        if (attr1->attislocal != attr2->attislocal)
            return false;
        if (attr1->attinhcount != attr2->attinhcount)
            return false;
        if (attr1->attcollation != attr2->attcollation)
            return false;
        /* variable-length fields are not even present... */
    }
 
    if (tupdesc1->constr != NULL)
    {
        TupleConstr *constr1 = tupdesc1->constr;
        TupleConstr *constr2 = tupdesc2->constr;
 
        if (constr2 == NULL)
            return false;
        if (constr1->has_not_null != constr2->has_not_null)
            return false;
        if (constr1->has_generated_stored != constr2->has_generated_stored)
            return false;
        if (constr1->has_generated_virtual != constr2->has_generated_virtual)
            return false;
        n = constr1->num_defval;
        if (n != (int) constr2->num_defval)
            return false;
        /* We assume here that both AttrDefault arrays are in adnum order */
        for (i = 0; i < n; i++)
        {
            AttrDefault *defval1 = constr1->defval + i;
            AttrDefault *defval2 = constr2->defval + i;
 
            if (defval1->adnum != defval2->adnum)
                return false;
            if (strcmp(defval1->adbin, defval2->adbin) != 0)
                return false;
        }
        if (constr1->missing)
        {
            if (!constr2->missing)
                return false;
            for (i = 0; i < tupdesc1->natts; i++)
            {
                AttrMissing *missval1 = constr1->missing + i;
                AttrMissing *missval2 = constr2->missing + i;
 
                if (missval1->am_present != missval2->am_present)
                    return false;
                if (missval1->am_present)
                {
                    CompactAttribute *missatt1 = TupleDescCompactAttr(tupdesc1, i);
 
                    if (!datumIsEqual(missval1->am_value, missval2->am_value,
                                      missatt1->attbyval, missatt1->attlen))
                        return false;
                }
            }
        }
        else if (constr2->missing)
            return false;
        n = constr1->num_check;
        if (n != (int) constr2->num_check)
            return false;
 
        /*
         * Similarly, we rely here on the ConstrCheck entries being sorted by
         * name.  If there are duplicate names, the outcome of the comparison
         * is uncertain, but that should not happen.
         */
        for (i = 0; i < n; i++)
        {
            ConstrCheck *check1 = constr1->check + i;
            ConstrCheck *check2 = constr2->check + i;
 
            if (!(strcmp(check1->ccname, check2->ccname) == 0 &&
                  strcmp(check1->ccbin, check2->ccbin) == 0 &&
                  check1->ccenforced == check2->ccenforced &&
                  check1->ccvalid == check2->ccvalid &&
                  check1->ccnoinherit == check2->ccnoinherit))
                return false;
        }
    }
    else if (tupdesc2->constr != NULL)
        return false;
    return true;
}

References Assert, ATTNULLABLE_UNKNOWN, datumIsEqual(), fb(), i, NameStr, TupleConstr::num_defval, TupleDescAttr(), and TupleDescCompactAttr().

Referenced by RelationFindDeletedTupleInfoByIndex(), RelationFindDeletedTupleInfoSeq(), RelationFindReplTupleSeq(), and RelationRebuildRelation().

FreeTupleDesc()

void FreeTupleDesc ( TupleDesc  tupdesc )

extern

Definition at line 569 of file tupdesc.c.

{
    int         i;
 
    /*
     * Possibly this should assert tdrefcount == 0, to disallow explicit
     * freeing of un-refcounted tupdescs?
     */
    Assert(tupdesc->tdrefcount <= 0);
 
    if (tupdesc->constr)
    {
        if (tupdesc->constr->num_defval > 0)
        {
            AttrDefault *attrdef = tupdesc->constr->defval;
 
            for (i = tupdesc->constr->num_defval - 1; i >= 0; i--)
                pfree(attrdef[i].adbin);
            pfree(attrdef);
        }
        if (tupdesc->constr->missing)
        {
            AttrMissing *attrmiss = tupdesc->constr->missing;
 
            for (i = tupdesc->natts - 1; i >= 0; i--)
            {
                if (attrmiss[i].am_present
                    && !TupleDescAttr(tupdesc, i)->attbyval)
                    pfree(DatumGetPointer(attrmiss[i].am_value));
            }
            pfree(attrmiss);
        }
        if (tupdesc->constr->num_check > 0)
        {
            ConstrCheck *check = tupdesc->constr->check;
 
            for (i = tupdesc->constr->num_check - 1; i >= 0; i--)
            {
                pfree(check[i].ccname);
                pfree(check[i].ccbin);
            }
            pfree(check);
        }
        pfree(tupdesc->constr);
    }
 
    pfree(tupdesc);
}

References Assert, TupleConstr::check, TupleDescData::constr, DatumGetPointer(), TupleConstr::defval, fb(), i, TupleConstr::missing, TupleDescData::natts, TupleConstr::num_check, TupleConstr::num_defval, pfree(), TupleDescData::tdrefcount, and TupleDescAttr().

Referenced by AddNewAttributeTuples(), AtEOXact_RelationCache(), cfunc_hashtable_delete(), DecrTupleDescRefCount(), do_autovacuum(), ER_mc_callback(), ExecMakeTableFunctionResult(), ExecPrepareTuplestoreResult(), get_record_type_from_query(), get_rel_sync_entry(), InvalidateCompositeTypeCacheEntry(), ordered_set_startup(), PLy_result_dealloc(), RelationDestroyRelation(), ResOwnerReleaseTupleDesc(), RevalidateCachedQuery(), spgendscan(), update_cached_tupdesc(), and walrcv_clear_result().

hashRowType()

uint32 hashRowType ( TupleDesc  desc )

extern

Definition at line 880 of file tupdesc.c.

{
    uint32      s;
    int         i;
 
    s = hash_combine(0, hash_bytes_uint32(desc->natts));
    s = hash_combine(s, hash_bytes_uint32(desc->tdtypeid));
    for (i = 0; i < desc->natts; ++i)
        s = hash_combine(s, hash_bytes_uint32(TupleDescAttr(desc, i)->atttypid));
 
    return s;
}

References fb(), hash_bytes_uint32(), hash_combine(), i, TupleDescData::natts, TupleDescData::tdtypeid, and TupleDescAttr().

Referenced by cfunc_hash(), record_type_typmod_hash(), and shared_record_table_hash().

IncrTupleDescRefCount()

void IncrTupleDescRefCount ( TupleDesc  tupdesc )

extern

Definition at line 626 of file tupdesc.c.

{
    Assert(tupdesc->tdrefcount >= 0);
 
    ResourceOwnerEnlarge(CurrentResourceOwner);
    tupdesc->tdrefcount++;
    ResourceOwnerRememberTupleDesc(CurrentResourceOwner, tupdesc);
}

References Assert, CurrentResourceOwner, ResourceOwnerEnlarge(), ResourceOwnerRememberTupleDesc(), and TupleDescData::tdrefcount.

Referenced by cache_record_field_properties(), and ExecEvalConvertRowtype().

populate_compact_attribute()

void populate_compact_attribute ( TupleDesc  tupdesc, int  attnum  )

extern

Definition at line 100 of file tupdesc.c.

{
    Form_pg_attribute src = TupleDescAttr(tupdesc, attnum);
    CompactAttribute *dst;
 
    /*
     * Don't use TupleDescCompactAttr to prevent infinite recursion in assert
     * builds.
     */
    dst = &tupdesc->compact_attrs[attnum];
 
    populate_compact_attribute_internal(src, dst);
}

References attnum, TupleDescData::compact_attrs, fb(), populate_compact_attribute_internal(), and TupleDescAttr().

Referenced by BuildDescForRelation(), BuildHardcodedDescriptor(), ConstructTupleDescriptor(), create_toast_table(), CreateTupleDesc(), CreateTupleDescCopy(), CreateTupleDescCopyConstr(), CreateTupleDescTruncatedCopy(), formrdesc(), getSpGistTupleDesc(), load_relcache_init_file(), RelationBuildLocalRelation(), RelationBuildTupleDesc(), TupleDescCopy(), TupleDescCopyEntry(), TupleDescInitBuiltinEntry(), and TupleDescInitEntry().

TupleDescAttr()

static FormData_pg_attribute * TupleDescAttr ( TupleDesc  tupdesc, int  i  )

inlinestatic

Definition at line 178 of file tupdesc.h.

{
    FormData_pg_attribute *attrs = TupleDescAttrAddress(tupdesc);
 
    Assert(i >= 0 && i < tupdesc->natts);
 
    return &attrs[i];
}

References Assert, fb(), FormData_pg_attribute, i, TupleDescData::natts, and TupleDescAttrAddress.

Referenced by AddNewAttributeTuples(), addRangeTableEntryForENR(), AddRelationNewConstraints(), ATAddForeignKeyConstraint(), ATExecAddColumn(), ATExecAddOf(), ATExecAlterColumnType(), ATExecAttachPartition(), ATExecColumnDefault(), ATExecDropNotNull(), ATExecReplicaIdentity(), ATRewriteTable(), attnameAttNum(), attnumAttName(), attnumCollationId(), attnumTypeId(), BeginCopyFrom(), BeginCopyTo(), boot_openrel(), brin_build_desc(), brin_form_tuple(), brin_minmax_add_value(), brin_minmax_multi_add_value(), brin_minmax_multi_union(), brin_minmax_union(), brin_page_items(), bringetbitmap(), bt_normalize_tuple(), build_attrmap_by_name(), build_attrmap_by_position(), build_column_default(), build_generation_expression(), build_index_tlist(), build_physical_tlist(), build_remattrmap(), build_remote_returning(), BuildDescForRelation(), BuildHardcodedDescriptor(), buildNSItemFromTupleDesc(), BuildOnConflictExcludedTargetlist(), buildRelationAliases(), cache_record_field_properties(), CallStmtResultDesc(), CatalogCacheInitializeCache(), CatCacheCopyKeys(), check_exclusion_or_unique_constraint(), check_modified_virtual_generated(), check_selective_binary_conversion(), check_sql_stmt_retval(), CheckAttributeNamesTypes(), CheckAttributeType(), CheckIndexCompatible(), checkInsertTargets(), checkRuleResultList(), CheckVarSlotCompatibility(), checkViewColumns(), CloneFkReferenced(), CloneFkReferencing(), CloneRowTriggersToPartition(), coerce_record_to_complex(), compatConnectbyTupleDescs(), compatCrosstabTupleDescs(), compatible_tupdescs(), composite_to_json(), composite_to_jsonb(), ComputePartitionAttrs(), ConstructTupleDescriptor(), conversion_error_callback(), CopyFromBinaryOneRow(), CopyFromTextLikeOneRow(), CopyGetAttnums(), CopyReadAttributesCSV(), CopyReadAttributesText(), CopyToTextLikeStart(), create_foreign_modify(), create_toast_table(), createTableConstraints(), CreateTriggerFiringOn(), CreateTupleDesc(), CreateTupleDescCopy(), CreateTupleDescCopyConstr(), CreateTupleDescTruncatedCopy(), currtid_for_view(), debugStartup(), debugtup(), DefineIndex(), deparseAnalyzeSql(), DetachPartitionFinalize(), DoCopy(), DoCopyTo(), equalRowTypes(), equalTupleDescs(), errtablecol(), examine_attribute(), exec_eval_expr(), exec_move_row_from_fields(), exec_stmt_return_next(), ExecBuildGroupingEqual(), ExecBuildHash32FromAttrs(), ExecBuildParamSetEqual(), ExecBuildProjectionInfo(), ExecBuildSlotValueDescription(), ExecBuildUpdateProjection(), ExecCheckPlanOutput(), ExecComputeStoredGenerated(), ExecConstraints(), ExecEvalFieldSelect(), ExecEvalWholeRowVar(), ExecInitExprRec(), ExecInitGenerated(), ExecInitIndexOnlyScan(), ExecInitTableFuncScan(), ExecScanSubPlan(), ExecSetParamPlan(), ExecSort(), ExecTypeSetColNames(), expand_insert_targetlist(), expand_single_inheritance_child(), expand_virtual_generated_columns(), expanded_record_lookup_field(), ExpandRowReference(), expandTableLikeClause(), expandTupleDesc(), find_composite_type_dependencies(), formrdesc(), FreeTupleDesc(), generateClonedIndexStmt(), get_file_fdw_attribute_options(), get_generated_columns(), get_name_for_var_field(), get_rel_data_width(), get_relation_constraints(), get_rels_with_domain(), get_simple_values_rte(), get_sql_delete(), get_sql_insert(), get_sql_update(), get_target_list(), get_tupdesc_for_join_scan_tuples(), get_tuple_of_interest(), get_variable(), GetAttributeByName(), getAttributesList(), getSpGistTupleDesc(), GinBufferInit(), gist_page_items(), gistrescan(), hash_record(), hash_record_extended(), hashRowType(), heap_toast_insert_or_update(), heapam_relation_needs_toast_table(), hstore_from_record(), hstore_populate_record(), hypothetical_check_argtypes(), import_spi_query_ok(), inclusion_get_strategy_procinfo(), index_create_copy(), index_form_tuple_context(), initGinState(), initialize_aggregate(), InitializeAttributeOids(), InsertOneNull(), InsertOneValue(), InsertPgAttributeTuples(), intorel_startup(), IsIndexUsableForReplicaIdentityFull(), json_check_mutability(), load_relcache_init_file(), logicalrep_rel_open(), logicalrep_write_attrs(), logicalrep_write_tuple(), make_inh_translation_list(), make_tuple_from_row(), make_tuple_indirect(), map_sql_table_to_xmlschema(), map_sql_typecoll_to_xmlschema_types(), MergeAttributes(), MergeAttributesIntoExisting(), MergeConstraintsIntoExisting(), minmax_get_strategy_procinfo(), minmax_multi_get_strategy_procinfo(), NextCopyFromRawFieldsInternal(), page_header(), ParseComplexProjection(), PartConstraintImpliedByRelConstraint(), pg_get_publication_tables(), pg_prepared_statement(), plperl_build_tuple_result(), plperl_hash_from_tuple(), plperl_modify_tuple(), plpgsql_exec_trigger(), pltcl_build_tuple_argument(), pltcl_build_tuple_result(), pltcl_set_tuple_values(), pltcl_trigger_handler(), PLy_input_setup_tuple(), PLy_modify_tuple(), PLy_output_setup_tuple(), PLy_result_colnames(), PLy_result_coltypes(), PLy_result_coltypmods(), PLyDict_FromTuple(), PLyGenericObject_ToComposite(), PLyMapping_ToComposite(), populate_compact_attribute(), populate_record(), printsimple(), printsimple_startup(), printtup_prepare_info(), pub_collist_validate(), pub_contains_invalid_column(), pub_form_cols_map(), record_cmp(), record_eq(), record_image_cmp(), record_image_eq(), record_in(), record_out(), record_recv(), record_send(), refresh_by_match_merge(), RelationBuildLocalRelation(), RelationBuildPartitionKey(), RelationBuildTupleDesc(), ReportNotNullViolationError(), resolve_polymorphic_tupdesc(), rewriteTargetListIU(), rewriteValuesRTE(), ri_ReportViolation(), rowtype_field_matches(), send_relation_and_attrs(), SendRowDescriptionMessage(), serialize_prepare_info(), set_attnotnull(), set_relation_column_names(), slot_modify_data(), slot_store_data(), spgGetCache(), SPI_fname(), SPI_fnumber(), SPI_gettype(), SPI_gettypeid(), SPI_getvalue(), SysCacheGetAttrNotNull(), test_predtest(), tfuncInitialize(), tfuncLoadRows(), tlist_matches_tupdesc(), toast_tuple_find_biggest_attribute(), toast_tuple_init(), transformAlterTableStmt(), transformAssignedExpr(), transformForPortionOfClause(), transformIndexConstraint(), transformOfType(), transformTableLikeClause(), triggered_change_notification(), tuple_to_stringinfo(), tupledesc_match(), TupleDescCopy(), TupleDescCopyEntry(), TupleDescFinalize(), TupleDescGetAttInMetadata(), TupleDescInitBuiltinEntry(), TupleDescInitEntry(), TupleDescInitEntryCollation(), tuples_equal(), tuplesort_begin_index_gin(), TypeGetTupleDesc(), validateConnectbyTupleDesc(), validateDomainCheckConstraint(), validateDomainNotNullConstraint(), verify_compact_attribute(), verifyPartitionIndexNotNull(), and write_relcache_init_file().

TupleDescCompactAttr()

static CompactAttribute * TupleDescCompactAttr ( TupleDesc  tupdesc, int  i  )

inlinestatic

Definition at line 195 of file tupdesc.h.

{
    CompactAttribute *cattr = &tupdesc->compact_attrs[i];
 
#ifdef USE_ASSERT_CHECKING
 
    /* Check that the CompactAttribute is correctly populated */
    verify_compact_attribute(tupdesc, i);
#endif
 
    return cattr;
}

References TupleDescData::compact_attrs, fb(), i, and verify_compact_attribute().

Referenced by _bt_keep_natts_fast(), _bt_preprocess_array_keys(), adjust_toast_pointers(), apply_handle_update(), ATRewriteTable(), brin_deconstruct_tuple(), brin_inclusion_add_value(), brin_inclusion_union(), btestimateparallelscan(), build_attrmap_by_position(), BuildTupleFromCStrings(), CatCacheFreeKeys(), check_and_init_gencol(), check_attrmap_match(), check_domain_for_new_field(), check_selective_binary_conversion(), check_sql_stmt_retval(), check_tuple_attribute(), collectMatchBitmap(), convert_prep_stmt_params(), CopyGetAttnums(), CreateTupleDescCopyConstr(), deparseInsertSql(), deparseTargetList(), deparseUpdateSql(), equalTupleDescs(), ER_get_flat_size(), ExecBuildUpdateProjection(), ExecComputeStoredGenerated(), ExecEvalRowNullInt(), ExecEvalWholeRowVar(), ExecInitJunkFilterConversion(), expand_tuple(), expanded_record_set_field_internal(), expanded_record_set_fields(), expanded_record_set_tuple(), fastgetattr(), get_dependent_generated_columns(), get_relation_constraints(), get_relation_notnullatts(), get_rte_attribute_is_dropped(), get_rule_expr(), getDatumCopy(), getmissingattr(), ginFlushBuildState(), gistInitBuffering(), heap_attisnull(), heap_attr_equals(), heap_compute_data_size(), heap_deform_tuple(), heap_fill_tuple(), HeapDetermineColumnsInfo(), index_deform_tuple_internal(), index_getattr(), MemoizeHash_equal(), MemoizeHash_hash(), nocache_index_getattr(), nocachegetattr(), PartConstraintImpliedByRelConstraint(), pgoutput_row_filter(), PLySequence_ToComposite(), postgresBeginForeignInsert(), postgresPlanForeignModify(), rebuildInsertSql(), reform_tuple(), RelationBuildLocalRelation(), RelationBuildTupleDesc(), ReorderBufferToastReplace(), repack_store_change(), restore_tuple(), ri_KeysEqual(), set_attnotnull(), slot_compile_deform(), slot_fill_defaults(), spgdoinsert(), toast_build_flattened_tuple(), toast_delete_external(), toast_flatten_tuple(), toast_flatten_tuple_to_datum(), tstoreReceiveSlot_detoast(), tstoreStartupReceiver(), tts_virtual_materialize(), tuple_data_split_internal(), TupleDescFinalize(), validate_pkattnums(), ValuesNext(), and var_is_nonnullable().

TupleDescCopy()

void TupleDescCopy ( TupleDesc  dst, TupleDesc  src  )

extern

Definition at line 427 of file tupdesc.c.

{
    int         i;
 
    /* Flat-copy the header and attribute arrays */
    memcpy(dst, src, TupleDescSize(src));
 
    /*
     * Since we're not copying constraints and defaults, clear fields
     * associated with them.
     */
    for (i = 0; i < dst->natts; i++)
    {
        Form_pg_attribute att = TupleDescAttr(dst, i);
 
        att->attnotnull = false;
        att->atthasdef = false;
        att->atthasmissing = false;
        att->attidentity = '\0';
        att->attgenerated = '\0';
 
        populate_compact_attribute(dst, i);
    }
    dst->constr = NULL;
 
    /*
     * Also, assume the destination is not to be ref-counted.  (Copying the
     * source's refcount would be wrong in any case.)
     */
    dst->tdrefcount = -1;
 
    TupleDescFinalize(dst);
}

References fb(), i, memcpy(), populate_compact_attribute(), TupleDescAttr(), TupleDescFinalize(), and TupleDescSize.

Referenced by share_tupledesc().

TupleDescCopyEntry()

void TupleDescCopyEntry ( TupleDesc  dst, AttrNumber  dstAttno, TupleDesc  src, AttrNumber  srcAttno  )

extern

Definition at line 472 of file tupdesc.c.

{
    Form_pg_attribute dstAtt = TupleDescAttr(dst, dstAttno - 1);
    Form_pg_attribute srcAtt = TupleDescAttr(src, srcAttno - 1);
 
    /*
     * sanity checks
     */
    Assert(src);
    Assert(dst);
    Assert(srcAttno >= 1);
    Assert(srcAttno <= src->natts);
    Assert(dstAttno >= 1);
    Assert(dstAttno <= dst->natts);
 
    memcpy(dstAtt, srcAtt, ATTRIBUTE_FIXED_PART_SIZE);
 
    dstAtt->attnum = dstAttno;
 
    /* since we're not copying constraints or defaults, clear these */
    dstAtt->attnotnull = false;
    dstAtt->atthasdef = false;
    dstAtt->atthasmissing = false;
    dstAtt->attidentity = '\0';
    dstAtt->attgenerated = '\0';
 
    populate_compact_attribute(dst, dstAttno - 1);
}

References Assert, ATTRIBUTE_FIXED_PART_SIZE, fb(), memcpy(), populate_compact_attribute(), and TupleDescAttr().

Referenced by addRangeTableEntryForFunction(), ExecInitFunctionScan(), and ordered_set_startup().

TupleDescFinalize()

void TupleDescFinalize ( TupleDesc  tupdesc )

extern

Definition at line 511 of file tupdesc.c.

{
    int         firstNonCachedOffsetAttr = 0;
    int         firstNonGuaranteedAttr = tupdesc->natts;
    int         off = 0;
 
    for (int i = 0; i < tupdesc->natts; i++)
    {
        CompactAttribute *cattr = TupleDescCompactAttr(tupdesc, i);
        Form_pg_attribute attr = TupleDescAttr(tupdesc, i);
 
        /*
         * Find the highest attnum which is guaranteed to exist in all tuples
         * in the table.  We currently only pay attention to byval attributes
         * to allow additional optimizations during tuple deformation.
         */
        if (firstNonGuaranteedAttr == tupdesc->natts &&
            (cattr->attnullability != ATTNULLABLE_VALID || !cattr->attbyval ||
             cattr->atthasmissing || cattr->attisdropped ||
             cattr->attlen <= 0 ||
             attr->attgenerated == ATTRIBUTE_GENERATED_VIRTUAL))
            firstNonGuaranteedAttr = i;
 
        /*
         * Don't cache offsets beyond fixed-width attributes.  Virtual
         * generated attributes are stored as NULLs in the tuple, so we don't
         * cache offsets beyond these.
         */
        if (cattr->attlen <= 0 ||
            attr->attgenerated == ATTRIBUTE_GENERATED_VIRTUAL)
            break;
 
        off = att_nominal_alignby(off, cattr->attalignby);
 
        /*
         * attcacheoff is an int16, so don't try to cache any offsets larger
         * than will fit in that type.  Any attributes which are offset more
         * than 2^15 are likely due to variable-length attributes.  Since we
         * don't cache offsets for or beyond variable-length attributes, using
         * an int16 rather than an int32 here is unlikely to cost us anything.
         */
        if (off > PG_INT16_MAX)
            break;
 
        cattr->attcacheoff = (int16) off;
 
        off += cattr->attlen;
        firstNonCachedOffsetAttr = i + 1;
    }
 
    tupdesc->firstNonCachedOffsetAttr = firstNonCachedOffsetAttr;
    tupdesc->firstNonGuaranteedAttr = firstNonGuaranteedAttr;
}

References att_nominal_alignby, ATTNULLABLE_VALID, fb(), TupleDescData::firstNonCachedOffsetAttr, TupleDescData::firstNonGuaranteedAttr, i, TupleDescData::natts, PG_INT16_MAX, TupleDescAttr(), and TupleDescCompactAttr().

Referenced by aclexplode(), addRangeTableEntryForFunction(), BeginCopyTo(), brtuple_disk_tupdesc(), build_buffercache_pages_tupledesc(), build_function_result_tupdesc_d(), build_row_from_vars(), BuildDescForRelation(), BuildDescFromLists(), BuildHardcodedDescriptor(), CallStmtResultDesc(), ConstructTupleDescriptor(), create_toast_table(), CreateReplicationSlot(), CreateTupleDesc(), CreateTupleDescCopy(), CreateTupleDescCopyConstr(), CreateTupleDescTruncatedCopy(), dblink_get_pkey(), DefineRelation(), ExecInitFunctionScan(), ExecMakeTableFunctionResult(), ExecTypeFromExprList(), ExecTypeFromTLInternal(), expandRecordVariable(), ExplainResultDesc(), formrdesc(), get_expr_result_type(), GetPGVariableResultDesc(), getSpGistTupleDesc(), gistrescan(), IdentifySystem(), init_sexpr(), initGinState(), libpqrcv_processTuples(), load_relcache_init_file(), materializeQueryResult(), materializeResult(), ordered_set_startup(), pg_buffercache_os_pages_internal(), pg_get_publication_tables(), pg_get_sequence_data(), pg_lock_status(), pg_prepared_xact(), pg_stat_file(), pg_stat_get_archiver(), pg_stat_get_backend_subxact(), pg_stat_get_replication_slot(), pg_stat_get_subscription_stats(), pg_stat_wal_build_tuple(), pg_visibility_tupdesc(), pg_walfile_name_offset(), ReadReplicationSlot(), RelationBuildLocalRelation(), RelationBuildTupleDesc(), resolve_polymorphic_tupdesc(), SendTablespaceList(), SendTimeLineHistory(), SendXlogRecPtrResult(), show_all_settings(), ShowAllGUCConfig(), ShowGUCConfigOption(), StartReplication(), test_custom_stats_fixed_report(), test_predtest(), tsvector_unnest(), TupleDescCopy(), TypeGetTupleDesc(), and WaitStmtResultDesc().

TupleDescGetDefault()

Node * TupleDescGetDefault ( TupleDesc  tupdesc, AttrNumber  attnum  )

extern

Definition at line 1161 of file tupdesc.c.

{
    Node       *result = NULL;
 
    if (tupdesc->constr)
    {
        AttrDefault *attrdef = tupdesc->constr->defval;
 
        for (int i = 0; i < tupdesc->constr->num_defval; i++)
        {
            if (attrdef[i].adnum == attnum)
            {
                result = stringToNode(attrdef[i].adbin);
                break;
            }
        }
    }
 
    return result;
}

References attnum, TupleDescData::constr, TupleConstr::defval, fb(), i, TupleConstr::num_defval, result, and stringToNode().

Referenced by build_column_default(), createTableConstraints(), expandTableLikeClause(), and MergeAttributes().

TupleDescInitBuiltinEntry()

void TupleDescInitBuiltinEntry ( TupleDesc  desc, AttrNumber  attributeNumber, const char *  attributeName, Oid  oidtypeid, int32  typmod, int  attdim  )

extern

Definition at line 985 of file tupdesc.c.

{
    Form_pg_attribute att;
 
    /* sanity checks */
    Assert(desc);
    Assert(attributeNumber >= 1);
    Assert(attributeNumber <= desc->natts);
    Assert(attdim >= 0);
    Assert(attdim <= PG_INT16_MAX);
 
    /* initialize the attribute fields */
    att = TupleDescAttr(desc, attributeNumber - 1);
    att->attrelid = 0;          /* dummy value */
 
    /* unlike TupleDescInitEntry, we require an attribute name */
    Assert(attributeName != NULL);
    namestrcpy(&(att->attname), attributeName);
 
    att->atttypmod = typmod;
 
    att->attnum = attributeNumber;
    att->attndims = attdim;
 
    att->attnotnull = false;
    att->atthasdef = false;
    att->atthasmissing = false;
    att->attidentity = '\0';
    att->attgenerated = '\0';
    att->attisdropped = false;
    att->attislocal = true;
    att->attinhcount = 0;
    /* variable-length fields are not present in tupledescs */
 
    att->atttypid = oidtypeid;
 
    /*
     * Our goal here is to support just enough types to let basic builtin
     * commands work without catalog access - e.g. so that we can do certain
     * things even in processes that are not connected to a database.
     */
    switch (oidtypeid)
    {
        case TEXTOID:
        case TEXTARRAYOID:
            att->attlen = -1;
            att->attbyval = false;
            att->attalign = TYPALIGN_INT;
            att->attstorage = TYPSTORAGE_EXTENDED;
            att->attcompression = InvalidCompressionMethod;
            att->attcollation = DEFAULT_COLLATION_OID;
            break;
 
        case BOOLOID:
            att->attlen = 1;
            att->attbyval = true;
            att->attalign = TYPALIGN_CHAR;
            att->attstorage = TYPSTORAGE_PLAIN;
            att->attcompression = InvalidCompressionMethod;
            att->attcollation = InvalidOid;
            break;
 
        case INT4OID:
            att->attlen = 4;
            att->attbyval = true;
            att->attalign = TYPALIGN_INT;
            att->attstorage = TYPSTORAGE_PLAIN;
            att->attcompression = InvalidCompressionMethod;
            att->attcollation = InvalidOid;
            break;
 
        case INT8OID:
            att->attlen = 8;
            att->attbyval = true;
            att->attalign = TYPALIGN_DOUBLE;
            att->attstorage = TYPSTORAGE_PLAIN;
            att->attcompression = InvalidCompressionMethod;
            att->attcollation = InvalidOid;
            break;
 
        case OIDOID:
            att->attlen = 4;
            att->attbyval = true;
            att->attalign = TYPALIGN_INT;
            att->attstorage = TYPSTORAGE_PLAIN;
            att->attcompression = InvalidCompressionMethod;
            att->attcollation = InvalidOid;
            break;
 
        default:
            elog(ERROR, "unsupported type %u", oidtypeid);
    }
 
    populate_compact_attribute(desc, attributeNumber - 1);
}

References Assert, elog, ERROR, fb(), InvalidCompressionMethod, InvalidOid, namestrcpy(), PG_INT16_MAX, populate_compact_attribute(), and TupleDescAttr().

Referenced by CreateReplicationSlot(), IdentifySystem(), ReadReplicationSlot(), SendTablespaceList(), SendTimeLineHistory(), SendXlogRecPtrResult(), ShowAllGUCConfig(), ShowGUCConfigOption(), StartReplication(), and WaitStmtResultDesc().

TupleDescInitEntry()

void TupleDescInitEntry ( TupleDesc  desc, AttrNumber  attributeNumber, const char *  attributeName, Oid  oidtypeid, int32  typmod, int  attdim  )

extern

Definition at line 909 of file tupdesc.c.

{
    HeapTuple   tuple;
    Form_pg_type typeForm;
    Form_pg_attribute att;
 
    /*
     * sanity checks
     */
    Assert(desc);
    Assert(attributeNumber >= 1);
    Assert(attributeNumber <= desc->natts);
    Assert(attdim >= 0);
    Assert(attdim <= PG_INT16_MAX);
 
    /*
     * initialize the attribute fields
     */
    att = TupleDescAttr(desc, attributeNumber - 1);
 
    att->attrelid = 0;          /* dummy value */
 
    /*
     * Note: attributeName can be NULL, because the planner doesn't always
     * fill in valid resname values in targetlists, particularly for resjunk
     * attributes. Also, do nothing if caller wants to re-use the old attname.
     */
    if (attributeName == NULL)
        MemSet(NameStr(att->attname), 0, NAMEDATALEN);
    else if (attributeName != NameStr(att->attname))
        namestrcpy(&(att->attname), attributeName);
 
    att->atttypmod = typmod;
 
    att->attnum = attributeNumber;
    att->attndims = attdim;
 
    att->attnotnull = false;
    att->atthasdef = false;
    att->atthasmissing = false;
    att->attidentity = '\0';
    att->attgenerated = '\0';
    att->attisdropped = false;
    att->attislocal = true;
    att->attinhcount = 0;
    /* variable-length fields are not present in tupledescs */
 
    tuple = SearchSysCache1(TYPEOID, ObjectIdGetDatum(oidtypeid));
    if (!HeapTupleIsValid(tuple))
        elog(ERROR, "cache lookup failed for type %u", oidtypeid);
    typeForm = (Form_pg_type) GETSTRUCT(tuple);
 
    att->atttypid = oidtypeid;
    att->attlen = typeForm->typlen;
    att->attbyval = typeForm->typbyval;
    att->attalign = typeForm->typalign;
    att->attstorage = typeForm->typstorage;
    att->attcompression = InvalidCompressionMethod;
    att->attcollation = typeForm->typcollation;
 
    populate_compact_attribute(desc, attributeNumber - 1);
 
    ReleaseSysCache(tuple);
}

References Assert, elog, ERROR, fb(), Form_pg_type, GETSTRUCT(), HeapTupleIsValid, InvalidCompressionMethod, MemSet, NAMEDATALEN, NameStr, namestrcpy(), ObjectIdGetDatum(), PG_INT16_MAX, populate_compact_attribute(), ReleaseSysCache(), SearchSysCache1(), and TupleDescAttr().

Referenced by aclexplode(), addRangeTableEntryForFunction(), BeginCopyTo(), brtuple_disk_tupdesc(), build_buffercache_pages_tupledesc(), build_function_result_tupdesc_d(), build_row_from_vars(), BuildDescForRelation(), BuildDescFromLists(), CallStmtResultDesc(), create_toast_table(), dblink_get_pkey(), ExecInitFunctionScan(), ExecMakeTableFunctionResult(), ExecTypeFromExprList(), ExecTypeFromTLInternal(), expandRecordVariable(), ExplainResultDesc(), get_expr_result_type(), GetPGVariableResultDesc(), gistrescan(), init_sexpr(), initGinState(), libpqrcv_processTuples(), materializeQueryResult(), materializeResult(), ordered_set_startup(), pg_buffercache_os_pages_internal(), pg_get_publication_tables(), pg_get_sequence_data(), pg_lock_status(), pg_prepared_xact(), pg_stat_file(), pg_stat_get_archiver(), pg_stat_get_backend_subxact(), pg_stat_get_replication_slot(), pg_stat_get_subscription_stats(), pg_stat_wal_build_tuple(), pg_visibility_tupdesc(), pg_walfile_name_offset(), resolve_polymorphic_tupdesc(), show_all_settings(), test_custom_stats_fixed_report(), test_predtest(), tsvector_unnest(), and TypeGetTupleDesc().

TupleDescInitEntryCollation()

void TupleDescInitEntryCollation ( TupleDesc  desc, AttrNumber  attributeNumber, Oid  collationid  )

extern

Definition at line 1093 of file tupdesc.c.

{
    /*
     * sanity checks
     */
    Assert(desc);
    Assert(attributeNumber >= 1);
    Assert(attributeNumber <= desc->natts);
 
    TupleDescAttr(desc, attributeNumber - 1)->attcollation = collationid;
}

References Assert, fb(), and TupleDescAttr().

Referenced by addRangeTableEntryForFunction(), build_row_from_vars(), BuildDescForRelation(), BuildDescFromLists(), ExecInitFunctionScan(), ExecTypeFromExprList(), ExecTypeFromTLInternal(), expandRecordVariable(), get_expr_result_type(), initGinState(), and resolve_polymorphic_tupdesc().

verify_compact_attribute()

void verify_compact_attribute ( TupleDesc  tupdesc, int  attnum  )

extern

Definition at line 125 of file tupdesc.c.

{
#ifdef USE_ASSERT_CHECKING
    CompactAttribute cattr;
    Form_pg_attribute attr = TupleDescAttr(tupdesc, attnum);
    CompactAttribute tmp;
 
    /*
     * Make a temp copy of the TupleDesc's CompactAttribute.  This may be a
     * shared TupleDesc and the attcacheoff might get changed by another
     * backend.
     */
    memcpy(&cattr, &tupdesc->compact_attrs[attnum], sizeof(CompactAttribute));
 
    /*
     * Populate the temporary CompactAttribute from the corresponding
     * Form_pg_attribute
     */
    populate_compact_attribute_internal(attr, &tmp);
 
    /*
     * Make the attcacheoff match since it's been reset to -1 by
     * populate_compact_attribute_internal.  Same with attnullability.
     */
    tmp.attcacheoff = cattr.attcacheoff;
    tmp.attnullability = cattr.attnullability;
 
    /* Check the freshly populated CompactAttribute matches the TupleDesc's */
    Assert(memcmp(&tmp, &cattr, sizeof(CompactAttribute)) == 0);
#endif
}

References Assert, CompactAttribute::attcacheoff, CompactAttribute::attnullability, attnum, TupleDescData::compact_attrs, fb(), memcpy(), populate_compact_attribute_internal(), and TupleDescAttr().

Referenced by TupleDescCompactAttr().