Struct ruru::Thread
[−]
[src]
pub struct Thread { /* fields omitted */ }
Thread
Methods
impl Thread
[src]
fn new<F, R>(func: F) -> Self where
F: FnOnce() -> R,
R: Object,
F: FnOnce() -> R,
R: Object,
Creates a new green thread.
The returning value of the closure will be available as #value
of the thread
Examples
use ruru::{Fixnum, Thread, VM}; Thread::new(|| { let computation_result = 1 + 2; Fixnum::new(computation_result) });
Ruby:
Thread.new do
computation_result = 1 + 2
computation_result
end
fn wait_fd(fd: RawFd)
Tells scheduler to switch to other threads while current thread is waiting for a readable event on the given file descriptor.
Examples
use std::os::unix::io::AsRawFd; use std::os::unix::net::UnixStream; use ruru::{Thread, VM}; let (unix_socket, _) = UnixStream::pair().unwrap(); Thread::wait_fd(unix_socket.as_raw_fd());
fn call_without_gvl<F, R, G>(func: F, unblock_func: Option<G>) -> R where
F: FnOnce() -> R,
G: FnOnce(),
F: FnOnce() -> R,
G: FnOnce(),
Release GVL for current thread.
Warning! Due to MRI limitations, interaction with Ruby objects is not allowed while GVL is released, it may cause unexpected behaviour. Read more at Ruby documentation
You should extract all the information from Ruby world before invoking
thread_call_without_gvl
.
GVL will be re-acquired when the closure is finished.
Examples
#[macro_use] extern crate ruru; use ruru::{Class, Fixnum, Object, Thread}; class!(Calculator); methods!( Calculator, itself, fn heavy_computation() -> Fixnum { let computation = || { 2 * 2 }; let unblocking_function = || {}; // release GVL for current thread until `computation` is completed let result = Thread::call_without_gvl( computation, Some(unblocking_function) ); // GVL is re-acquired, we can interact with Ruby-world Fixnum::new(result) } ); fn main() { Class::new("Calculator", None).define(|itself| { itself.def("heavy_computation", heavy_computation); }); }
fn call_without_gvl2<F, R, G>(func: F, unblock_func: Option<G>) -> R where
F: FnOnce() -> R,
G: FnOnce(),
F: FnOnce() -> R,
G: FnOnce(),
fn call_with_gvl<F, R>(func: F) -> R where
F: FnOnce() -> R,
F: FnOnce() -> R,
Trait Implementations
impl Debug for Thread
[src]
impl PartialEq for Thread
[src]
fn eq(&self, __arg_0: &Thread) -> bool
This method tests for self
and other
values to be equal, and is used by ==
. Read more
fn ne(&self, __arg_0: &Thread) -> bool
This method tests for !=
.
impl From<Value> for Thread
[src]
impl Object for Thread
[src]
fn value(&self) -> Value
Returns internal value
of current object. Read more
fn class(&self) -> Class
Returns a class of current object. Read more
fn singleton_class(&self) -> Class
Returns a singleton class of current object. Read more
fn get_data<'a, T>(&'a self, wrapper: &'a DataTypeWrapper<T>) -> &mut T
Gets a Rust structure that is wrapped into a Ruby object. Read more
fn define<F: Fn(&mut Self)>(&mut self, f: F) -> &Self
Wraps calls to the object. Read more
fn define_method<I: Object, O: Object>(
&mut self,
name: &str,
callback: Callback<I, O>
)
&mut self,
name: &str,
callback: Callback<I, O>
)
Defines an instance method for the given class or object. Read more
fn define_singleton_method<I: Object, O: Object>(
&mut self,
name: &str,
callback: Callback<I, O>
)
&mut self,
name: &str,
callback: Callback<I, O>
)
Defines a class method for given class or singleton method for object. Read more
fn def<I: Object, O: Object>(&mut self, name: &str, callback: Callback<I, O>)
An alias for define_method
(similar to Ruby syntax def some_method
).
fn def_self<I: Object, O: Object>(
&mut self,
name: &str,
callback: Callback<I, O>
)
&mut self,
name: &str,
callback: Callback<I, O>
)
An alias for define_singleton_method
(similar to Ruby def self.some_method
).
fn send(&self, method: &str, arguments: Vec<AnyObject>) -> AnyObject
Calls a given method on an object similarly to Ruby Object#send
method Read more
fn respond_to(&self, method: &str) -> bool
Checks whether the object responds to given method Read more
fn is_nil(&self) -> bool
Checks whether the object is nil
Read more
fn to_any_object(&self) -> AnyObject
Converts struct to AnyObject
Read more
fn instance_variable_get(&self, variable: &str) -> AnyObject
Gets an instance variable of object Read more
fn instance_variable_set<T: Object>(
&mut self,
variable: &str,
value: T
) -> AnyObject
&mut self,
variable: &str,
value: T
) -> AnyObject
Sets an instance variable for object Read more
fn is_frozen(&self) -> bool
Returns the freeze status of the object. Read more
fn freeze(&mut self) -> Self
Prevents further modifications to the object. Read more
unsafe fn to<T: Object>(&self) -> T
Unsafely casts current object to the specified Ruby type Read more
fn try_convert_to<T: VerifiedObject>(&self) -> Result<T>
Safely casts current object to the specified Ruby type Read more
fn ty(&self) -> ValueType
Determines the value type of the object Read more