libui 0.4.0

A native, cross-platform and lightweight UI toolkit.
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

//! Utilities to manage the state of the interface to the libUI bindings.
use std::sync::atomic::{AtomicBool, Ordering};

static INITIALIZED: AtomicBool = AtomicBool::new(false);

/// Set the global flag stating that libUI is initialized.
///
/// # Unsafety
/// If this is called when the library is not, in fact, initialized,
/// the program will be placed in an undefined state.
///
/// # Panics
/// Panics if called when libUI is already marked as initialized.
pub unsafe fn set_initialized() {
    assert!(!INITIALIZED.swap(true, Ordering::SeqCst),
        "Tried to initialize libUI when it was already initialized. Aborting because this is an unsafe situation.");
}

/// Set the global flag stating that libUI is no longer initialized.
///
/// # Unsafety
/// If this is called when the library is actually still initialized,
/// the program could try to create a new instance, violating the library's
/// invariants and likely causing a segfault.
pub unsafe fn unset_initialized() {
    INITIALIZED.store(false, Ordering::SeqCst);
}

/// Retrieve the global flag indicating whether libUI is initialized.
pub fn is_initialized() -> bool {
    INITIALIZED.load(Ordering::SeqCst)
}