Struct TableRef 

pub struct TableRef<'a> { /* private fields */ }

A metadata-only view of a TABLE and its optional related TABLE DATA entry.

This handle borrows metadata parsed and indexed by crate::Archive::open. Creating or querying it does not seek to or decompress table data. Schema, table, and column identities are byte-oriented.

Row representation and column-layout queries deliberately distinguish unavailable metadata, malformed COPY metadata, and unsupported table-data representations. Raw selected-entry access remains separate and may still be possible for a representation the row parser does not support.

Implementations

impl<'a> TableRef<'a>

pub fn schema(&self) -> Option<&[u8]>

Returns table namespace bytes, or None when the TABLE namespace was NULL.

pub fn name(&self) -> &[u8]

Returns exact table-name bytes.

pub const fn table_entry_id(&self) -> DumpId

Returns the dump ID of the TABLE TOC entry.

pub fn data_entry_id(&self) -> Option<DumpId>

Returns the dump ID of the related TABLE DATA entry, when present.

None means the metadata index found no related table-data entry.

pub fn data_representation( &self, ) -> Result<TableDataRepresentation, PgDumpError>

Returns the table-data representation derived from stored TOC metadata.

CopyText, Insert, Binary, and other recognized states are values. If the representation cannot be derived because metadata is absent or malformed, this returns the corresponding typed metadata error instead.

pub fn columns(&self) -> Result<&[Column], PgDumpError>

Returns COPY columns in the exact positional order used by parsed rows.

Missing table-data/COPY metadata, malformed COPY statements, and unsupported table-data representations are reported distinctly. This metadata-only call does not decompress data. Raw entry access remains available through crate::Archive::entry_reader when the selected entry itself is readable.

pub fn column_index(&self, name: &[u8]) -> Result<Option<usize>, PgDumpError>

Resolves an exact byte-oriented COPY column name to its zero-based field index.

Ok(Some(index)) means valid metadata contained the name. Ok(None) means metadata was valid but the name was absent. Metadata unavailable/malformed and unsupported representations are returned as distinct typed errors.

Trait Implementations

impl<'a> Clone for TableRef<'a>

fn clone(&self) -> TableRef<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for TableRef<'a>

impl<'a> Debug for TableRef<'a>

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

Formats the value using the given formatter.