yad_core 1.0.0

YAD is a lightweight binary file format designed for efficient data storage.
Documentation 
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

use crate::core::Value;

/// Creates a heap-allocated `Value` from a Rust boolean.
///
/// # Parameters
/// - `val`: Rust `bool` to convert into a `Value`.
///
/// # Returns
/// - Pointer to a heap-allocated `Value` representing the boolean.
/// - Returns `null` if conversion fails.
///
/// # Safety
/// - The returned pointer must eventually be freed with `value_free` to avoid memory leaks.
#[unsafe(no_mangle)]
pub extern "C" fn value_from_bool(val: bool) -> *mut Value {
    match Value::from_bool(val) {
        Ok(v) => Box::into_raw(Box::new(v)),
        Err(_) => std::ptr::null_mut(),
    }
}

/// Extracts a Rust boolean from a `Value`.
///
/// # Parameters
/// - `value`: Pointer to a `Value` to read from.
/// - `out`: Pointer to a `bool` where the result will be written.
///
/// # Returns
/// - `true` if the conversion succeeded.
/// - `false` if the pointer is null or the `Value` is not a boolean.
///
/// # Safety
/// - `value` and `out` must be valid pointers.
/// - Writing to `out` assumes the caller provides valid memory.
#[unsafe(no_mangle)]
pub extern "C" fn bool_from_value(value: *mut Value, out: *mut bool) -> bool {
    if value.is_null() {
        return false;
    }
    unsafe {
        if let Ok(bool) = (&*value).as_bool() {
            *out = bool
        } else {
            return false;
        }
    }
    true
}