heap_fill_tuple()/postgresql-8.1.4 のバックアップ(No.1)

このページを編集する際は、編集に関する方針に従ってください。

概要 †

対象：8.1.4
言語：C
postgresql-8.1.4/src/include/access/heapam.hにて定義
postgresql-8.1.4/src/backend/access/common/heaptuple.cにて定義

（概要を書いてください。）

↑

引数 †

tupleDesc : TupleDesc型
values : Datum型へのポインタ
isnull : bool型へのポインタ
data : char型へのポインタ
infomask : uint16型へのポインタ
bit : bits8型へのポインタ

↑

実装 †

void heap_fill_tuple(TupleDesc tupleDesc,

以下のメンバを持つ構造体。詳細はTupleDesc/postgresql-8.1.4参照。
nattsを、intとして定義。
attrsを、以下のメンバを持つ構造体Form_pg_attributeへのポインタとして定義。
- attrelidを、Oid（unsigned intの別名）として定義。
- attnameを、以下のメンバを持つ構造体NameDataとして定義。
  - dataを、サイズNAMEDATALENのchar配列として定義。
  - alignmentDummyを、intとして定義。
- atttypidを、Oid（unsigned intの別名）として定義。
- attstattargetを、int4（int32(signed int)の別名）として定義。
- attlenを、int2（int16（signed short）の別名）として定義。
- attnumを、int2（int16（signed short）の別名）として定義。
- attndimsを、int4（int32(signed int)の別名）として定義。
- attcacheoffを、int4（int32(signed int)の別名）として定義。
- atttypmodを、int4（int32(signed int)の別名）として定義。
- attbyvalを、bool（charの別名）として定義。
- attstorageを、charとして定義。
- attalignを、charとして定義。
- attnotnullを、bool（charの別名）として定義。
- atthasdefを、bool（charの別名）として定義。
- attisdroppedを、bool（charの別名）として定義。
- attislocalを、bool（charの別名）として定義。
- attinhcountを、int4（int32(signed int)の別名）として定義。
constrを、TupleConstrへのポインタとして定義。
- defvalを、以下のメンバを持つ構造体AttrDefaultへのポインタとして定義。
  - adnumを、AttrNumber（int16（signed shortの別名）の別名））として定義。
  - adbinを、charへのポインタとして定義。
- checkを、以下のメンバを持つ構造体ConstrCheckへのポインタとして定義。
  - ccnameを、charへのポインタとして定義。
  - ccbinを、charへのポインタとして定義。
- num_defvalを、uint16（unsigned shortの別名）として定義。
- num_checkを、uint16（unsigned shortの別名）として定義。
- has_not_nullを、bool（charの別名）として定義。
tdtypeidを、Oid（unsigned intの別名）として定義。
tdtypmodを、int32（signed intの別名）として定義。
tdhasoidを、bool（charの別名）として定義。

				Datum *values,

unsigned longの別名。詳細はDatum/postgresql-8.1.4参照。

				bool *isnull,

charの別名。詳細はbool/postgresql-8.1.4参照。

				char *data, 
				uint16 *infomask,

unsigned shortの別名。詳細はuint16/postgresql-8.1.4参照。

				bits8 *bit)

uint8(unsigned char)の別名。詳細はbits8/postgresql-8.1.4参照。

{

	bits8	   *bitP;

uint8(unsigned char)の別名。詳細はbits8/postgresql-8.1.4参照。

	int			bitmask;
	int			i;
	int			numberOfAttributes = tupleDesc->natts;
	Form_pg_attribute *att = tupleDesc->attrs;

以下のメンバを持つ構造体へのポインタ。詳細はForm_pg_attribute/postgresql-8.1.4参照。
- attrelidを、Oid（unsigned intの別名）として定義。
- attnameを、以下のメンバを持つ構造体NameDataとして定義。
  - dataを、サイズNAMEDATALENのchar配列として定義。
  - alignmentDummyを、intとして定義。
- atttypidを、Oid（unsigned intの別名）として定義。
- attstattargetを、int4（int32(signed int)の別名）として定義。
- attlenを、int2（int16（signed short）の別名）として定義。
- attnumを、int2（int16（signed short）の別名）として定義。
- attndimsを、int4（int32(signed int)の別名）として定義。
- attcacheoffを、int4（int32(signed int)の別名）として定義。
- atttypmodを、int4（int32(signed int)の別名）として定義。
- attbyvalを、bool（charの別名）として定義。
- attstorageを、charとして定義。
- attalignを、charとして定義。
- attnotnullを、bool（charの別名）として定義。
- atthasdefを、bool（charの別名）として定義。
- attisdroppedを、bool（charの別名）として定義。
- attislocalを、bool（charの別名）として定義。
- attinhcountを、int4（int32(signed int)の別名）として定義。

	if (bit != NULL)
	{
		bitP = &bit[-1];
		bitmask = CSIGNBIT;
	}
	else
	{
		/* just to keep compiler quiet */
		bitP = NULL;
		bitmask = 0;
	}

	*infomask &= ~(HEAP_HASNULL | HEAP_HASVARWIDTH | HEAP_HASEXTENDED);

	for (i = 0; i < numberOfAttributes; i++)
	{
		Size		data_length;

		if (bit != NULL)
		{
			if (bitmask != CSIGNBIT)
				bitmask <<= 1;
			else
			{
				bitP += 1;
				*bitP = 0x0;
				bitmask = 1;
			}

			if (isnull[i])
			{
				*infomask |= HEAP_HASNULL;
				continue;
			}

			*bitP |= bitmask;
		}

		/* XXX we are aligning the pointer itself, not the offset */
		data = (char *) att_align((long) data, att[i]->attalign);

		if (att[i]->attbyval)
		{
			/* pass-by-value */
			store_att_byval(data, values[i], att[i]->attlen);
			data_length = att[i]->attlen;
		}
		else if (att[i]->attlen == -1)
		{
			/* varlena */
			*infomask |= HEAP_HASVARWIDTH;
			if (VARATT_IS_EXTERNAL(values[i]))
				*infomask |= HEAP_HASEXTERNAL;
			if (VARATT_IS_COMPRESSED(values[i]))
				*infomask |= HEAP_HASCOMPRESSED;
			data_length = VARATT_SIZE(DatumGetPointer(values[i]));
			memcpy(data, DatumGetPointer(values[i]), data_length);
		}
		else if (att[i]->attlen == -2)
		{
			/* cstring */
			*infomask |= HEAP_HASVARWIDTH;
			data_length = strlen(DatumGetCString(values[i])) + 1;
			memcpy(data, DatumGetPointer(values[i]), data_length);
		}
		else
		{
			/* fixed-length pass-by-reference */
			Assert(att[i]->attlen > 0);
			data_length = att[i]->attlen;
			memcpy(data, DatumGetPointer(values[i]), data_length);
		}

		data += data_length;
	}

}

↑

呼出元 †

（呼出元の関数を書いてください。）

↑

備考 †

* heap_fill_tuple
*		Load data portion of a tuple from values/isnull arrays
*
* We also fill the null bitmap (if any) and set the infomask bits
* that reflect the tuple's data contents.

↑

履歴 †

作者：testnoda
日付：????/??/??
更新日更新者更新内容

↑

PostgreSQL解読室: heap_fill_tuple()/postgresql-8.1.4 のバックアップ(No.1)

概要 †

引数 †

実装 †

呼出元 †

備考 †

履歴 †

コメント †

更新日	更新者	更新内容