gruggers 0.5.3

rust implementation of the grug language
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
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67

#![allow(improper_ctypes_definitions)]
use crate::state::{EventFnEntry, FileInfo, GrugEntityHandle, GrugInitSettings, GrugState};
use crate::ntstring::NTStrPtr;
use crate::types::{GrugFileId, GrugOnFnId, GrugEntity, GrugValue, GameFnPtrState};

#[unsafe(no_mangle)]
pub extern "C" fn grug_init(settings: GrugInitSettings) -> Option<Box<GrugState>> {
	Some(Box::new(settings.build_state().ok()?))
}

#[unsafe(no_mangle)]
pub extern "C" fn grug_deinit(_: Option<Box<GrugState>>) {}

#[unsafe(no_mangle)]
pub unsafe extern "C" fn grug_register_game_fn(state: &mut GrugState, game_fn_name: NTStrPtr<'static>, func: GameFnPtrState<GrugState>) -> bool {
	// SAFETY: This function is exposed to C and is inherently unsafe
	unsafe{state.register_game_fn(game_fn_name.to_str(), func).is_ok()}
}

const INVALID_GRUG_SCRIPT_ID: GrugFileId = GrugFileId::new(u64::MAX);

#[unsafe(no_mangle)]
pub extern "C" fn grug_compile_all_files(state: &GrugState) -> &[FileInfo] {
	state.compile_all_files().leak()
}

#[unsafe(no_mangle)]
pub extern "C" fn grug_update(state: &GrugState) -> &[FileInfo] {
	state.update_files().leak()
}

#[unsafe(no_mangle)]
pub extern "C" fn grug_compile_file(state: &GrugState, file_path: NTStrPtr<'_>) -> GrugFileId {
	state.compile_grug_file(file_path.to_str()).unwrap_or_else(|err| {println!("{}", err); INVALID_GRUG_SCRIPT_ID})
}

#[unsafe(no_mangle)]
pub extern "C" fn grug_create_entity(state: &GrugState, file_id: GrugFileId) -> Option<GrugEntityHandle<'_>> {
	state.create_entity(file_id)
}

#[unsafe(no_mangle)]
pub extern "C" fn grug_deinit_entity(state: &GrugState, handle: GrugEntityHandle<'_>) {
	state.destroy_entity(handle)
}

const INVALID_GRUG_ON_FN_ID: GrugOnFnId = u64::MAX;

#[unsafe(no_mangle)]
pub extern "C" fn grug_get_on_fn_ids(state: &GrugState) -> &[EventFnEntry<'_>] {
	state.get_on_functions()
}

#[unsafe(no_mangle)]
pub extern "C" fn grug_get_on_fn_id(state: &GrugState, entity_type: NTStrPtr<'_>, on_fn_name: NTStrPtr<'_>) -> GrugOnFnId {
	state.get_on_fn_id(entity_type.to_str(), on_fn_name.to_str()).unwrap_or(INVALID_GRUG_ON_FN_ID)
}

#[unsafe(no_mangle)]
pub extern "C" fn grug_call_on_function(state: &GrugState, entity: &GrugEntity, on_fn_id: GrugOnFnId, values: *const GrugValue, values_len: usize) -> bool {
	unsafe{state.call_on_function(entity, on_fn_id, std::slice::from_raw_parts(values, values_len))}
}

#[unsafe(no_mangle)]
pub fn grug_all_game_fns_registered(state: &GrugState) -> bool {
	state.all_game_fns_registered().is_ok()
}