Struct odbc_api::Quirks

#[non_exhaustive]
pub struct Quirks {
    pub indicators_returned_from_bulk_fetch_are_memory_garbage: bool,
}

A (non exhaustive) description of the non ODBC API conformant behavior of ODBC drivers. Workarounds which are intended to help application developers seperate between the descision of how to deal with non conformity from the knowledge which driver behaves weird in exactly which way.

For example it wants to avoid an if statement specifying “if the database is DB2 please use terminating zeroes instead of indiactors to determine string lengths” and seperate this into “IBM DB2 returns memory garbage for indicators” and another part of the application decides, this is how I deal with memory garbage indicicators.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

indicators_returned_from_bulk_fetch_are_memory_garbage: bool

IBM DB2 has been observered that the length indicators returned from memory are garbage for strings. It seems to be preferable to rely on the terminating zero exclusively to determine string length. This behavior seems to so far only manifest with variadic string fields. See: https://github.com/pacman82/arrow-odbc-py/issues/68 and also https://github.com/pacman82/odbc-api/issues/398

Implementations

impl Quirks

pub fn new() -> Self

A new instance describing an ODBC driver without quirks

pub fn from_dbms_name(name: &str) -> Self

Fill quircks based on database name

use odbc_api::{Environment, ConnectionOptions, Quirks};

let env = Environment::new()?;

let mut conn = env.connect(
    "YourDatabase", "SA", "My@Test@Password1",
    ConnectionOptions::default()
)?;
let dbms_name = conn.database_management_system_name()?;
let quirks = Quirks::from_dbms_name(&dbms_name);
 
/// Application logic can now implement workarounds based on known quirks.
/// ...

Trait Implementations

impl Clone for Quirks

fn clone(&self) -> Quirks

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Quirks

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

Formats the value using the given formatter.

impl Default for Quirks

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for Quirks

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

This method tests for self and other values to be equal, and is used by ==.

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

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

impl Eq for Quirks

impl StructuralEq for Quirks

impl StructuralPartialEq for Quirks