lexlib 2.0.1

library with miscellaneous stuff
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

// Copyright 2023 alexevier <alexevier@proton.me>
// licensed under the zlib license <https://www.zlib.net/zlib_license.html>

//! OS abstractions.
//!
//! Linux and Window$ are supported but this should work on all unix like systems.

use crate::c;

/// gets the physical ram size in bytes.
///
/// since it might fail a option is returned.
pub fn ram_size() -> Option<u64> {
	let size = unsafe{c::lexlibRamSize()};
	
	if size == 0 {
		None
	} else {
		Some(size)
	}
}

/// gets a pseudorandom number from the OS that is cryptographically secure.
///
/// since it might fail a option is returned.
pub fn random() -> Option<u32> {
	let mut num = unsafe{c::lexlibRandom()};
	
	if num == 0 { // might have failed, try again.
		num = unsafe{c::lexlibRandom()};
	}
	
	if num == 0 {
		None
	} else {
		Some(num)
	}
}

pub mod thread {
	use super::*;
	
	/// sleeps the thread for the specified number of seconds.
	#[inline(always)]
	pub fn sleep(seconds: u32){
		unsafe{c::lexlibSleep(seconds)}
	}
	
	/// sleeps the thread for the specified number of milliseconds.
	#[inline(always)]
	pub fn sleep_ms(milliseconds: u32){
		unsafe{c::lexlibSleepMs(milliseconds)}
	}
}