Thread: bytea documentation error

bytea documentation error

From
PG Doc comments form
Date:
The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/15/datatype-binary.html
Description:

I believe there is a documentation error in the example for "8.4.1 bytea Hex
Format"
(https://www.postgresql.org/docs/current/datatype-binary.html#id-1.5.7.12.9).
The example is
`SELECT '\xDEADBEEF';`
However, when I try that on my system [psql (13.9 (Ubuntu
13.9-1.pgdg20.04+1), server 13.10 (Ubuntu 13.10-1.pgdg20.04+1))], it works
*but* the result is type `text` per `pg_typeof()`.  I believe the example
needs to be corrected with an explicit cast to `bytea`.

Re: bytea documentation error

From
Tom Lane
Date:
PG Doc comments form <noreply@postgresql.org> writes:
> I believe there is a documentation error in the example for "8.4.1 bytea Hex
> Format"
> (https://www.postgresql.org/docs/current/datatype-binary.html#id-1.5.7.12.9).
> The example is
> `SELECT '\xDEADBEEF';`
> However, when I try that on my system [psql (13.9 (Ubuntu
> 13.9-1.pgdg20.04+1), server 13.10 (Ubuntu 13.10-1.pgdg20.04+1))], it works
> *but* the result is type `text` per `pg_typeof()`.  I believe the example
> needs to be corrected with an explicit cast to `bytea`.

Yeah, that's not really right.  Also, this example is pretty shoddy
compared to the one for escape format a little further down.
Will fix, thanks for the report!

            regards, tom lane