Trait odbc_api::parameter::VarKind

pub unsafe trait VarKind {
    type Element: Copy + Eq;

    const ZERO: Self::Element;
    const TERMINATING_ZEROES: usize;
    const C_DATA_TYPE: CDataType;

    // Required method
    fn relational_type(buffer_length: usize) -> DataType;
}

A tag used to differentiate between different types of variadic buffers.

Safety

• Self::TERMINATING_ZEROES is used to calculate buffer offsets. The number of terminating zeroes is expressed in BufferElements.
• Self::C_DATA_TYPE is used to bind parameters. Providing wrong values like e.g. a fixed length types, would cause even a correctly implemented odbc driver to access invalid memory.

Required Associated Types

type Element: Copy + Eq

Either u8 for binary and narrow text or u16 for wide text. Wide text could also be represented as u8, after all everything is bytes. This makes it difficult though to create owned VarCell types from u16 buffers.

Required Associated Constants

const ZERO: Self::Element

Zero for buffer element.

const TERMINATING_ZEROES: usize

Number of terminating zeroes required for this kind of variadic buffer.

const C_DATA_TYPE: CDataType

Required Methods

fn relational_type(buffer_length: usize) -> DataType

Relational type used to bind the parameter. buffer_length is specified in elements rather than bytes, if the two differ.

Implementors

impl VarKind for Binary

type Element = u8

const ZERO: u8 = 0u8

const TERMINATING_ZEROES: usize = 0usize

const C_DATA_TYPE: CDataType = CDataType::Binary

impl VarKind for Text

type Element = u8

const ZERO: u8 = 0u8

const TERMINATING_ZEROES: usize = 1usize

const C_DATA_TYPE: CDataType = CDataType::Char