uika-runtime 0.1.0

Safe Rust runtime for uika (object refs, lifecycle, dynamic calls)
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

// Global API table storage. Initialized once during DLL load, then read-only.

use std::sync::OnceLock;

use uika_ffi::UikaApiTable;

/// Wrapper so a raw pointer can live inside OnceLock (which requires Send+Sync).
/// SAFETY: The API table is created by C++ before uika_init and lives for the
/// entire DLL lifetime. Access is read-only after init.
struct ApiRef(*const UikaApiTable);
unsafe impl Send for ApiRef {}
unsafe impl Sync for ApiRef {}

static API: OnceLock<ApiRef> = OnceLock::new();

/// Store the API table pointer. Called once by `uika_init`.
/// Panics if called more than once.
pub fn init_api(table: *const UikaApiTable) {
    assert!(!table.is_null(), "init_api called with null pointer");
    if API.set(ApiRef(table)).is_err() {
        panic!("init_api called more than once");
    }
}

/// Access the global API table. Panics if called before `init_api`.
#[inline(always)]
pub fn api() -> &'static UikaApiTable {
    // SAFETY: The pointer was validated non-null in init_api, and the C++ side
    // guarantees the table outlives the DLL.
    unsafe { &*API.get().expect("uika API not initialized").0 }
}

/// Returns true if the API table has been initialized.
#[inline]
pub fn is_api_initialized() -> bool {
    API.get().is_some()
}