tarantool 11.0.0

#[doc(hidden)]
pub mod helper;
#[doc(hidden)]
pub use ::tlua::ffi as lua;
#[doc(hidden)]
pub mod datetime;
#[doc(hidden)]
pub mod decimal;
#[doc(hidden)]
pub mod sql;
#[doc(hidden)]
pub mod tarantool;
#[doc(hidden)]
pub mod uuid;

/// Check whether the current tarantool executable supports decimal api.
/// If this function returns `false` using any of the functions in
/// [`tarantool::decimal`] will result in a **panic**.
///
/// [`tarantool::decimal`]: mod@crate::decimal
pub fn has_decimal() -> bool {
    if cfg!(feature = "standalone_decimal") {
        return true;
    }

    unsafe {
        let name = crate::c_str!("decimal_zero");
        helper::tnt_internal_symbol::<*const ()>(name).is_some() || helper::has_dyn_symbol(name)
    }
}

/// Check whether the current tarantool executable supports fiber::channel api.
/// If this function returns `false` using any of the functions in
/// [`tarantool::fiber::channel`] will result in a **panic**.
///
/// [`tarantool::fiber::channel`]: crate::fiber::channel
pub fn has_fiber_channel() -> bool {
    unsafe {
        let name = crate::c_str!("fiber_channel_new");
        helper::tnt_internal_symbol::<*const ()>(name).is_some() || helper::has_dyn_symbol(name)
    }
}

/// Check whether the current tarantool executable supports getting tuple fields
/// by json pattern.
/// If this function returns `false` then
/// - passing a string to [`Tuple::try_get`] will always result in an `Error`,
/// - passing a string to [`Tuple::get`] will always result in a **panic**.
///
/// [`Tuple::try_get`]: crate::tuple::Tuple::try_get
/// [`Tuple::get`]: crate::tuple::Tuple::get
pub fn has_tuple_field_by_path() -> bool {
    let c_str = std::ffi::CStr::from_bytes_with_nul_unchecked;
    unsafe {
        helper::has_dyn_symbol(c_str(tarantool::TUPLE_FIELD_BY_PATH_NEW_API.as_bytes()))
            | helper::has_dyn_symbol(c_str(tarantool::TUPLE_FIELD_BY_PATH_OLD_API.as_bytes()))
    }
}

/// Check whether the current tarantool executable supports datetime api.
/// If this function returns `false` using functions in
/// [`tarantool::datetime`] may result in a **panic**.
///
/// [`tarantool::datetime`]: mod@crate::datetime
pub fn has_datetime() -> bool {
    if cfg!(feature = "static_linking") {
        return true;
    }

    unsafe { helper::has_dyn_symbol(crate::c_str!("tnt_mp_encode_datetime")) }
}

/// Check whether the current tarantool executable supports fiber_set_ctx api.
/// If this function returns `false` using functions in
/// [`fiber_set_ctx`] & [`fiber_get_ctx`] may result in a **panic**.
///
/// # Safety
/// This function is only safe to be called from the tx thread.
///
/// [`fiber_set_ctx`]: crate::ffi::tarantool::fiber_set_ctx
/// [`fiber_get_ctx`]: crate::ffi::tarantool::fiber_get_ctx
#[inline]
pub unsafe fn has_fiber_set_ctx() -> bool {
    if cfg!(feature = "static_linking") {
        return true;
    }

    static mut RESULT: Option<bool> = None;
    if (*std::ptr::addr_of!(RESULT)).is_none() {
        RESULT = Some(helper::has_dyn_symbol(crate::c_str!("fiber_set_ctx")));
    }
    RESULT.unwrap()
}

/// Check whether the current tarantool executable supports the api for
/// fully temporary spaces.
///
/// If this function returns `false` creating spaces with
/// [`SpaceType::Temporary`] will not work.
///
/// [`SpaceType::Temporary`]: crate::space::SpaceType::Temporary
#[inline(always)]
pub fn has_fully_temporary_spaces() -> bool {
    if cfg!(feature = "static_linking") {
        return true;
    }

    crate::space::space_id_temporary_min().is_some()
}

/// Check whether the current tarantool executable supports the [`fiber_find`],
/// [`fiber_set_name_n`], [`fiber_id`], [`fiber_csw`], [`fiber_name`] ffi apis.
///
/// If this function returns `false` then the corrsponding apis (e.g. setting
/// fiber name) will use the less efficient implementation based on the lua
/// interface.
///
/// # Safety
/// This function is only safe to be called from the tx thread.
///
/// [`fiber_find`]: crate::ffi::tarantool::fiber_find
/// [`fiber_set_name_n`]: crate::ffi::tarantool::fiber_set_name_n
/// [`fiber_id`]: crate::ffi::tarantool::fiber_id
/// [`fiber_name`]: crate::ffi::tarantool::fiber_name
/// [`fiber_csw`]: crate::ffi::tarantool::fiber_csw
#[inline]
pub unsafe fn has_fiber_id() -> bool {
    if cfg!(feature = "static_linking") {
        return true;
    }

    static mut RESULT: Option<bool> = None;
    if (*std::ptr::addr_of!(RESULT)).is_none() {
        RESULT = Some(helper::has_dyn_symbol(crate::c_str!("fiber_id")));
    }
    RESULT.unwrap()
}

/// Check whether the current tarantool executable supports the [`luaL_iserror`],
/// ffi apis.
///
/// If this function returns `false` then [`tlua::LuaRead`] implementation of
/// [`BoxError`] will always fail.
///
/// # Safety
/// This function is only safe to be called from the tx thread.
///
/// [`BoxError`]: crate::error::BoxError
/// [`luaL_iserror`]: tarantool::luaL_iserror
#[inline]
pub unsafe fn has_box_error_from_lua() -> bool {
    if cfg!(feature = "static_linking") {
        return true;
    }

    static mut RESULT: Option<bool> = None;
    if (*std::ptr::addr_of!(RESULT)).is_none() {
        RESULT = Some(helper::has_dyn_symbol(crate::c_str!("luaL_iserror")));
    }
    RESULT.unwrap()
}