int8() — PostgreSQL JSON function

int8(): convert bytea to int8. PostgreSQL json functions — signature, volatility, version applicability and an illustrative example.

The Sev-1 Admin
The Sev-1 Admin  ·  2 min read

Summary

int8 is a PostgreSQL built-in function in the JSON Functions group. PostgreSQL’s system catalog (pg_proc) describes it as: “convert bytea to int8”.

Signature

int8 has 9 documented overloaded forms:

int8(bytea) → bigint
int8(integer) → bigint
int8(double precision) → bigint
int8(real) → bigint
int8(smallint) → bigint
int8(oid) → bigint
int8(numeric) → bigint
int8(jsonb) → bigint
int8(bit) → bigint

Argument and return types are taken from the pg_proc catalog; internal type names are shown using their readable SQL spellings (for example int4 is shown as integer). (Derived from the catalog — see the linked reference for the canonical documentation.)

Classification

  • Category: JSON Functions
  • Kind: Function
  • Volatility: IMMUTABLE — Marked IMMUTABLE — it always returns the same result for the same arguments and can be used in indexes and other contexts that require immutability.
  • Returns: bigint

Example

Illustrative form (replace placeholder values with your own data):

SELECT int8('\\x1234'::bytea);

The example above is illustrative and is meant to show calling syntax only; consult the linked PostgreSQL documentation for exact semantics, edge cases and accepted argument combinations.

Version applicability

int8 is present across the surveyed releases (PostgreSQL 15, 16, 17, 18, 19). On older major versions, behaviour may differ in detail — always check the documentation for the version you run.

Related & references

Reference: PostgreSQL documentation — JSON Functions.