2013-07-22 02:20:52 +02:00
|
|
|
// Copyright 2013 The Rust Project Developers. See the COPYRIGHT
|
|
|
|
// file at the top-level directory of this distribution and at
|
|
|
|
// http://rust-lang.org/COPYRIGHT.
|
|
|
|
//
|
|
|
|
// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
|
|
|
|
// http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
|
|
|
|
// <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
|
|
|
|
// option. This file may not be copied, modified, or distributed
|
|
|
|
// except according to those terms.
|
|
|
|
|
2014-02-16 09:04:33 +01:00
|
|
|
#[allow(missing_doc)];
|
|
|
|
|
2014-03-03 01:01:13 +01:00
|
|
|
//! Contains struct definitions for the layout of compiler built-in types.
|
|
|
|
//!
|
|
|
|
//! They can be used as targets of transmutes in unsafe code for manipulating
|
|
|
|
//! the raw representations directly.
|
|
|
|
//!
|
|
|
|
//! Their definitition should always match the ABI defined in `rustc::back::abi`.
|
|
|
|
|
2013-07-22 02:20:52 +02:00
|
|
|
use cast;
|
|
|
|
|
|
|
|
/// The representation of a Rust managed box
|
2014-02-06 05:05:30 +01:00
|
|
|
pub struct Box<T> {
|
|
|
|
ref_count: uint,
|
|
|
|
drop_glue: fn(ptr: *mut u8),
|
|
|
|
prev: *mut Box<T>,
|
|
|
|
next: *mut Box<T>,
|
|
|
|
data: T
|
|
|
|
}
|
|
|
|
|
2013-07-22 02:20:52 +02:00
|
|
|
/// The representation of a Rust vector
|
|
|
|
pub struct Vec<T> {
|
|
|
|
fill: uint,
|
|
|
|
alloc: uint,
|
|
|
|
data: T
|
|
|
|
}
|
|
|
|
|
|
|
|
/// The representation of a Rust string
|
|
|
|
pub type String = Vec<u8>;
|
|
|
|
|
|
|
|
/// The representation of a Rust slice
|
|
|
|
pub struct Slice<T> {
|
|
|
|
data: *T,
|
|
|
|
len: uint
|
|
|
|
}
|
|
|
|
|
|
|
|
/// The representation of a Rust closure
|
|
|
|
pub struct Closure {
|
|
|
|
code: *(),
|
|
|
|
env: *(),
|
|
|
|
}
|
|
|
|
|
2014-02-11 01:13:50 +01:00
|
|
|
/// The representation of a Rust procedure (`proc()`)
|
|
|
|
pub struct Procedure {
|
|
|
|
code: *(),
|
|
|
|
env: *(),
|
|
|
|
}
|
|
|
|
|
2014-03-03 01:01:13 +01:00
|
|
|
/// The representation of a Rust trait object.
|
|
|
|
///
|
|
|
|
/// This struct does not have a `Repr` implementation
|
|
|
|
/// because there is no way to refer to all trait objects generically.
|
|
|
|
pub struct TraitObject {
|
|
|
|
vtable: *(),
|
|
|
|
data: *(),
|
|
|
|
}
|
|
|
|
|
2013-07-22 02:20:52 +02:00
|
|
|
/// This trait is meant to map equivalences between raw structs and their
|
|
|
|
/// corresponding rust values.
|
|
|
|
pub trait Repr<T> {
|
|
|
|
/// This function "unwraps" a rust value (without consuming it) into its raw
|
|
|
|
/// struct representation. This can be used to read/write different values
|
|
|
|
/// for the struct. This is a safe method because by default it does not
|
2014-03-03 01:01:13 +01:00
|
|
|
/// enable write-access to the fields of the return value in safe code.
|
2013-09-07 07:29:29 +02:00
|
|
|
#[inline]
|
2013-07-22 02:20:52 +02:00
|
|
|
fn repr(&self) -> T { unsafe { cast::transmute_copy(self) } }
|
|
|
|
}
|
|
|
|
|
2013-12-10 08:16:18 +01:00
|
|
|
impl<'a, T> Repr<Slice<T>> for &'a [T] {}
|
|
|
|
impl<'a> Repr<Slice<u8>> for &'a str {}
|
2013-07-22 02:20:52 +02:00
|
|
|
impl<T> Repr<*Box<T>> for @T {}
|
2014-01-14 22:33:08 +01:00
|
|
|
impl<T> Repr<*Vec<T>> for ~[T] {}
|
2013-08-10 09:28:47 +02:00
|
|
|
impl Repr<*String> for ~str {}
|
2013-07-22 02:20:52 +02:00
|
|
|
|
2013-10-27 20:12:40 +01:00
|
|
|
#[cfg(test)]
|
|
|
|
mod tests {
|
|
|
|
use super::*;
|
|
|
|
|
|
|
|
use cast;
|
|
|
|
|
|
|
|
#[test]
|
|
|
|
fn synthesize_closure() {
|
|
|
|
unsafe {
|
|
|
|
let x = 10;
|
2013-11-19 06:15:42 +01:00
|
|
|
let f: |int| -> int = |y| x + y;
|
2013-10-27 20:12:40 +01:00
|
|
|
|
|
|
|
assert_eq!(f(20), 30);
|
|
|
|
|
|
|
|
let original_closure: Closure = cast::transmute(f);
|
|
|
|
|
|
|
|
let actual_function_pointer = original_closure.code;
|
|
|
|
let environment = original_closure.env;
|
|
|
|
|
|
|
|
let new_closure = Closure {
|
|
|
|
code: actual_function_pointer,
|
|
|
|
env: environment
|
|
|
|
};
|
|
|
|
|
2013-11-19 06:15:42 +01:00
|
|
|
let new_f: |int| -> int = cast::transmute(new_closure);
|
2013-10-27 20:12:40 +01:00
|
|
|
assert_eq!(new_f(20), 30);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|