//! Misc low level stuff use cmp::{Eq, Ord}; export TypeDesc; export Closure; export get_type_desc; export size_of; export min_align_of; export pref_align_of; export refcount; export log_str; export shape_eq, shape_lt, shape_le; // Corresponds to runtime type_desc type enum TypeDesc = { size: uint, align: uint // Remaining fields not listed }; /// The representation of a Rust closure struct Closure { code: *(); env: *(); } #[abi = "cdecl"] extern mod rustrt { pure fn shape_log_str(t: *sys::TypeDesc, data: *()) -> ~str; } #[abi = "rust-intrinsic"] extern mod rusti { fn get_tydesc() -> *(); fn size_of() -> uint; fn pref_align_of() -> uint; fn min_align_of() -> uint; } /// Compares contents of two pointers using the default method. /// Equivalent to `*x1 == *x2`. Useful for hashtables. pure fn shape_eq(x1: &T, x2: &T) -> bool { *x1 == *x2 } pure fn shape_lt(x1: &T, x2: &T) -> bool { *x1 < *x2 } pure fn shape_le(x1: &T, x2: &T) -> bool { *x1 <= *x2 } /** * Returns a pointer to a type descriptor. * * Useful for calling certain function in the Rust runtime or otherwise * performing dark magick. */ pure fn get_type_desc() -> *TypeDesc { unchecked { rusti::get_tydesc::() as *TypeDesc } } /// Returns the size of a type #[inline(always)] pure fn size_of() -> uint { unchecked { rusti::size_of::() } } /** * Returns the ABI-required minimum alignment of a type * * This is the alignment used for struct fields. It may be smaller * than the preferred alignment. */ #[inline(always)] pure fn min_align_of() -> uint { unchecked { rusti::min_align_of::() } } /// Returns the preferred alignment of a type #[inline(always)] pure fn pref_align_of() -> uint { unchecked { rusti::pref_align_of::() } } /// Returns the refcount of a shared box (as just before calling this) pure fn refcount(+t: @T) -> uint { unsafe { let ref_ptr: *uint = unsafe::reinterpret_cast(t); *ref_ptr - 1 } } pure fn log_str(t: T) -> ~str { unsafe { let data_ptr: *() = unsafe::reinterpret_cast(ptr::addr_of(t)); rustrt::shape_log_str(get_type_desc::(), data_ptr) } } #[cfg(test)] mod tests { #[test] fn size_of_basic() { assert size_of::() == 1u; assert size_of::() == 2u; assert size_of::() == 4u; assert size_of::() == 8u; } #[test] #[cfg(target_arch = "x86")] #[cfg(target_arch = "arm")] fn size_of_32() { assert size_of::() == 4u; assert size_of::<*uint>() == 4u; } #[test] #[cfg(target_arch = "x86_64")] fn size_of_64() { assert size_of::() == 8u; assert size_of::<*uint>() == 8u; } #[test] fn align_of_basic() { assert pref_align_of::() == 1u; assert pref_align_of::() == 2u; assert pref_align_of::() == 4u; } #[test] #[cfg(target_arch = "x86")] #[cfg(target_arch = "arm")] fn align_of_32() { assert pref_align_of::() == 4u; assert pref_align_of::<*uint>() == 4u; } #[test] #[cfg(target_arch = "x86_64")] fn align_of_64() { assert pref_align_of::() == 8u; assert pref_align_of::<*uint>() == 8u; } #[test] fn synthesize_closure() unsafe { let x = 10; let f: fn(int) -> int = |y| x + y; assert f(20) == 30; let original_closure: Closure = unsafe::transmute(f); let actual_function_pointer = original_closure.code; let environment = original_closure.env; let new_closure = Closure { code: actual_function_pointer, env: environment }; let new_f: fn(int) -> int = unsafe::transmute(new_closure); assert new_f(20) == 30; } } // Local Variables: // mode: rust; // fill-column: 78; // indent-tabs-mode: nil // c-basic-offset: 4 // buffer-file-coding-system: utf-8-unix // End: