mimir 0.3.5

Rust bindings over the Oracle Database Programming Interface for Drivers and Applications
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69

// Copyright (c) 2017 mimir developers
//
// Licensed under the Apache License, Version 2.0
// <LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0> or the MIT
// license <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
// option. All files in the project carrying such notice may not be copied,
// modified, or distributed except according to those terms.

//! This structure is used to represent the unique identifier of a row in the database and is
//! available by handle to a calling application or driver. Rowids cannot be created or set directly
//! but are created implicitly when a variable of type `DPI_ORACLE_TYPE_ROWID` is created. They are
//! destroyed when the last reference is released by a call to the function `Rowid::release()`. All
//! of the attributes of the structure `ODPIBaseType` are included in this structure in addition to
//! the ones specific to this structure described below.
use error::{ErrorKind, Result};
use odpi::externs;
use odpi::opaque::ODPIRowid;
use std::ptr;
use util::ODPIStr;

/// This structure is used to represent the unique identifier of a row in the database and is
/// available by handle to a calling application or driver.
pub struct Rowid {
    /// The ODPI-C rowid
    inner: *mut ODPIRowid,
}

impl Rowid {
    /// Get the `inner` value.
    #[doc(hidden)]
    pub fn inner(&self) -> *mut ODPIRowid {
        self.inner
    }

    /// Returns the string (base64) representation of the rowid.
    pub fn get_string_value(&self) -> Result<String> {
        let mut value = ptr::null();
        let mut value_length = 0;

        try_dpi!(
            externs::dpiRowid_getStringValue(self.inner, &mut value, &mut value_length),
            {
                if value.is_null() {
                    Ok("".to_string())
                } else {
                    let res = ODPIStr::new(value, value_length);
                    Ok(res.into())
                }
            },
            ErrorKind::Rowid("dpiRowid_getStringValue".to_string())
        )
    }
}

impl From<*mut ODPIRowid> for Rowid {
    fn from(inner: *mut ODPIRowid) -> Self {
        Self { inner }
    }
}

impl Drop for Rowid {
    fn drop(&mut self) {
        if !self.inner.is_null() {
            unsafe {
                externs::dpiRowid_release(self.inner);
            }
        }
    }
}