rust/src/lib/dbg.rs

/**
 * Unsafe debugging functions for inspecting values.
 *
 * Your RUST_LOG environment variable must contain "stdlib" for any debug
 * logging.
 */

native "c-stack-cdecl" mod rustrt {
    fn debug_tydesc(td: *sys::type_desc);
    fn debug_opaque<T>(td: *sys::type_desc, x: T);
    fn debug_box<T>(td: *sys::type_desc, x: @T);
    fn debug_tag<T>(td: *sys::type_desc, x: T);
    fn debug_obj<T>(td: *sys::type_desc, x: T, nmethods: uint, nbytes: uint);
    fn debug_fn<T>(td: *sys::type_desc, x: T);
    fn debug_ptrcast<T, U>(td: *sys::type_desc, x: @T) -> @U;
}

fn debug_tydesc<T>() {
    rustrt::debug_tydesc(sys::get_type_desc::<T>());
}

fn debug_opaque<T>(x: T) {
    rustrt::debug_opaque::<T>(sys::get_type_desc::<T>(), x);
}

fn debug_box<T>(x: @T) {
    rustrt::debug_box::<T>(sys::get_type_desc::<T>(), x);
}

fn debug_tag<T>(x: T) {
    rustrt::debug_tag::<T>(sys::get_type_desc::<T>(), x);
}


/**
 * `nmethods` is the number of methods we expect the object to have.  The
 * runtime will print this many words of the obj vtbl).
 *
 * `nbytes` is the number of bytes of body data we expect the object to have.
 * The runtime will print this many bytes of the obj body.  You probably want
 * this to at least be 4u, since an implicit captured tydesc pointer sits in
 * the front of any obj's data tuple.x
 */
fn debug_obj<T>(x: T, nmethods: uint, nbytes: uint) {
    rustrt::debug_obj::<T>(sys::get_type_desc::<T>(), x, nmethods, nbytes);
}

fn debug_fn<T>(x: T) {
    rustrt::debug_fn::<T>(sys::get_type_desc::<T>(), x);
}

unsafe fn ptr_cast<T, U>(x: @T) -> @U {
    ret rustrt::debug_ptrcast::<T, U>(sys::get_type_desc::<T>(), x);
}

fn refcount<T>(a: @T) -> uint unsafe {
    let p: *uint = unsafe::reinterpret_cast(a);
    ret *p;
}

// Local Variables:
// mode: rust;
// fill-column: 78;
// indent-tabs-mode: nil
// c-basic-offset: 4
// buffer-file-coding-system: utf-8-unix
// compile-command: "make -k -C $RBUILD 2>&1 | sed -e 's/\\/x\\//x:\\//g'";
// End: