Enum ColumnFormat 

pub enum ColumnFormat {
    Text,
    Binary,
    HyperBinary,
}

Format code for column data.

This indicates how data values are encoded in the wire protocol. The format affects how values are serialized/deserialized and can significantly impact performance.

Variants

Text

Text format (human-readable ASCII).

Values are sent as UTF-8 strings. Slower but human-readable. Use for debugging or when compatibility with text-based tools is needed.

Binary

Standard PostgreSQL binary format.

Uses PostgreSQL’s standard binary encoding (BigEndian for most types). Compatible with standard PostgreSQL clients.

HyperBinary

Hyper-specific binary format (little-endian, optimized).

Uses Hyper’s optimized binary format where all multi-byte values are little-endian (x86/ARM-LE native byte order), avoiding byte-swapping on modern hardware. This contrasts with standard PostgreSQL binary format which uses big-endian (network byte order).

Additional differences from PostgreSQL binary:

• No per-row field count prefix (rows are implicitly framed)
• NULL is a 1-byte indicator on nullable columns only (vs 4-byte -1 length)
• Fixed-size types have no length prefix (vs 4-byte length in PG binary)

This is the fastest format and is used by default for query_fast(), query_streaming(), and the COPY bulk insertion path.

Implementations

impl ColumnFormat

pub fn from_code(code: i16) -> Self

Creates a ColumnFormat from the wire protocol format code.

Format codes: 0 = Text, 1 = Binary, 2 = HyperBinary

pub fn to_code(self) -> i16

Returns the wire protocol format code.

pub fn is_binary(self) -> bool

Returns true if this is a binary format (Binary or HyperBinary).

Trait Implementations

impl Clone for ColumnFormat

fn clone(&self) -> ColumnFormat

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ColumnFormat

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ColumnFormat

fn default() -> ColumnFormat

Returns the “default value” for a type.

impl PartialEq for ColumnFormat

fn eq(&self, other: &ColumnFormat) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for ColumnFormat

impl Eq for ColumnFormat

impl StructuralPartialEq for ColumnFormat