Re: VARDATA_COMPRESSED_GET_COMPRESS_METHOD comment?
Christoph Berg <myon@debian.org>
From: Christoph Berg <myon@debian.org>
To: Robert Haas <robertmhaas@gmail.com>
Cc: PostgreSQL Hackers <pgsql-hackers@postgresql.org>
Date: 2021-09-08T15:33:22Z
Lists: pgsql-hackers
Re: Robert Haas
> But I agree with you that referring to the argument to
> VARDATA_COMPRESSED_GET_EXTSIZE or
> VARDATA_COMPRESSED_GET_COMPRESS_METHOD as an "external compressed
> Datum" doesn't seem quite right. It is compressed, but it is not
> external, at least in the sense that I understand that term.
How about "compressed-in-line Datum" like on the comment 5 lines above?
/* caution: this will not work on an external or compressed-in-line Datum */
/* caution: this will return a possibly unaligned pointer */
#define VARDATA_ANY(PTR) \
(VARATT_IS_1B(PTR) ? VARDATA_1B(PTR) : VARDATA_4B(PTR))
/* Decompressed size and compression method of an external compressed Datum */
#define VARDATA_COMPRESSED_GET_EXTSIZE(PTR) \
(((varattrib_4b *) (PTR))->va_compressed.va_tcinfo & VARLENA_EXTSIZE_MASK)
#define VARDATA_COMPRESSED_GET_COMPRESS_METHOD(PTR) \
(((varattrib_4b *) (PTR))->va_compressed.va_tcinfo >> VARLENA_EXTSIZE_BITS)
This "external" there cost me about one hour of extra poking around
until I realized this is actually the macro I wanted.
-> /* Decompressed size and compression method of a compressed-in-line Datum */
Christoph
Commits
-
Fix misleading comments about TOAST access macros.
- 67948a433e18 14.0 landed
- 490798451a3a 15.0 landed