pub struct Odbc { /* private fields */ }
Expand description
ODBC environment entry point.
There should be only one object of this type in your program. It is stored as global static and accessed via associated static functions.
Implementations§
source§impl Odbc
impl Odbc
sourcepub fn initialize()
pub fn initialize()
Initialize global static ODBC environment now.
After this was called call to list_drivers()
will panic.
Connecting to a database will also initialize the environment.
This function will panic if there was a problem crating ODBC environment.
sourcepub fn list_drivers() -> Result<Vec<DriverInfo>, OdbcError>
pub fn list_drivers() -> Result<Vec<DriverInfo>, OdbcError>
Provides list of DriverInfo
structures describing available ODBC drivers.
This will panic if ODBC was already initialized by Odbc::connect()
or Odbc::initialize()
.
sourcepub fn connect(connection_string: &str) -> Result<Connection, OdbcError>
pub fn connect(connection_string: &str) -> Result<Connection, OdbcError>
Connect to database using connection string with default configuration options. This implementation will synchronize driver connect calls.
sourcepub unsafe fn connect_concurrent(
connection_string: &str
) -> Result<Connection, OdbcError>
pub unsafe fn connect_concurrent( connection_string: &str ) -> Result<Connection, OdbcError>
Connect to database using connection string with default configuration options. Assume that driver connect call is thread safe.
sourcepub fn connect_with_settings(
connection_string: &str,
settings: Settings
) -> Result<Connection, OdbcError>
pub fn connect_with_settings( connection_string: &str, settings: Settings ) -> Result<Connection, OdbcError>
Connect to database using connection string with configuration options. This implementation will synchronize driver connect calls.
sourcepub unsafe fn connect_with_settings_concurrent(
connection_string: &str,
settings: Settings
) -> Result<Connection, OdbcError>
pub unsafe fn connect_with_settings_concurrent( connection_string: &str, settings: Settings ) -> Result<Connection, OdbcError>
Connect to database using connection string with configuration options. Assume that driver connect call is thread safe.
Trait Implementations§
impl Sync for Odbc
“The ODBC Specification indicates that an external application or process should use a single environment handle that is shared by local threads. The threads share the environment handle by using it as a common resource for allocating individual connection handles.” (http://www.firstsql.com/ithread5.htm) lazy_static will make sure only one environment is initialized.