Struct rutie::Enumerator [−][src]
pub struct Enumerator { /* fields omitted */ }
Expand description
Enumerator
Implementations
Advances the iterator and returns the next value.
Returns Err
when iteration is finished.
Examples
use rutie::{Array, Fixnum, Object, VM, VerifiedObject, Enumerator};
let mut iter = Array::new().push(Fixnum::new(2)).push(Fixnum::new(1)).to_enum();
// A call to next() returns the next value...
assert_eq!(Ok(Fixnum::new(2).to_any_object()), iter.next());
assert_eq!(Ok(Fixnum::new(1).to_any_object()), iter.next());
// ... and then Err once it's over.
assert!(iter.next().is_err(), "not error!");
// More calls will always return Err.
assert!(iter.next().is_err(), "not error!");
assert!(iter.next().is_err(), "not error!");
Advances the iterator and returns the next values.
Returns Err
when iteration is finished.
Examples
use rutie::{Array, Fixnum, Object, VM, VerifiedObject, Enumerator};
let mut array = Array::with_capacity(2);
array.push(Fixnum::new(1));
array.push(Fixnum::new(2));
let mut iter = array.to_enum();
// A call to next_values() returns the next values...
let mut result1 = Array::with_capacity(1);
result1.push(Fixnum::new(1));
assert_eq!(Ok(result1), iter.next_values());
let mut result2 = Array::with_capacity(1);
result2.push(Fixnum::new(2));
assert_eq!(Ok(result2), iter.next_values());
// ... and then Err once it's over.
assert!(iter.next_values().is_err(), "not error!");
// More calls will always retirn Err.
assert!(iter.next_values().is_err(), "not error!");
assert!(iter.next_values().is_err(), "not error!");
Peeks into the iterator and returns the next value.
Returns Err
when iteration is finished.
Examples
use rutie::{Array, Fixnum, Object, VM, VerifiedObject, Enumerator};
let mut iter = Array::new().push(Fixnum::new(2)).push(Fixnum::new(1)).to_enum();
// A call to peek() returns the next value without progressing the iteration
assert_eq!(Ok(Fixnum::new(2).to_any_object()), iter.peek());
assert_eq!(Ok(Fixnum::new(2).to_any_object()), iter.peek());
Peeks into the iterator and returns the next values.
Returns Err
when iteration is finished.
Examples
use rutie::{Array, Fixnum, Object, VM, VerifiedObject, Enumerator};
let mut array = Array::with_capacity(2);
array.push(Fixnum::new(1));
array.push(Fixnum::new(2));
let mut iter = array.to_enum();
// A call to peek_values() returns the next values without progressing the iteration
let mut result1 = Array::with_capacity(1);
result1.push(Fixnum::new(1));
assert_eq!(Ok(result1.dup()), iter.peek_values());
assert_eq!(Ok(result1), iter.peek_values());
Rewind the iteration back to the beginning.
Returns Err
when iteration is finished.
Examples
use rutie::{Array, Fixnum, Object, VM, VerifiedObject, Enumerator};
let mut iter = Array::new().push(Fixnum::new(2)).push(Fixnum::new(1)).to_enum();
// A call to next() returns the next value...
assert_eq!(Ok(Fixnum::new(2).to_any_object()), iter.next());
assert_eq!(Ok(Fixnum::new(1).to_any_object()), iter.next());
assert!(iter.next().is_err(), "not error!");
iter.rewind();
// A call to next() returns the next value...
assert_eq!(Ok(Fixnum::new(2).to_any_object()), iter.next());
assert_eq!(Ok(Fixnum::new(1).to_any_object()), iter.next());
assert!(iter.next().is_err(), "not error!");
Feed a return value back in to internal yield inside enumerator.
Examples
use rutie::{Array, Fixnum, Object, VM, VerifiedObject, Enumerator, Class};
let mut e_iter = VM::eval("[1,2,3].map").unwrap().
try_convert_to::<Enumerator>().unwrap();
assert_eq!(Ok(Fixnum::new(1).to_any_object()), e_iter.next());
e_iter.feed(Fixnum::new(999).to_any_object());
assert_eq!(Ok(Fixnum::new(2).to_any_object()), e_iter.next());
e_iter.feed(Fixnum::new(888).to_any_object());
assert_eq!(Ok(Fixnum::new(3).to_any_object()), e_iter.next());
e_iter.feed(Fixnum::new(777).to_any_object());
match e_iter.next() {
Ok(_) => unreachable!(),
Err(e) => {
let mut expected = Array::with_capacity(3);
expected.push(Fixnum::new(999).to_any_object());
expected.push(Fixnum::new(888).to_any_object());
expected.push(Fixnum::new(777).to_any_object());
assert!(Class::from_existing("StopIteration").case_equals(&e));
assert_eq!(expected.to_any_object(), unsafe { e.send("result", &[]) });
},
}
Ruby:
e = [1,2,3].map
p e.next #=> 1
e.feed 999
p e.next #=> 2
e.feed 888
p e.next #=> 3
e.feed 777
begin
e.next
rescue StopIteration
p $!.result #=> [999, 888, 777]
end
Trait Implementations
Returns a singleton class of current object. Read more
Gets an immutable reference to the Rust structure which is wrapped into a Ruby object. Read more
Gets a mutable reference to the Rust structure which is wrapped into a Ruby object.
Defines an instance method for the given class or object. Read more
Defines a private instance method for the given class or object. Read more
Defines a class method for given class or singleton method for object. Read more
An alias for define_method
(similar to Ruby syntax def some_method
).
An alias for define_private_method
(similar to Ruby syntax private def some_method
).
An alias for define_singleton_method
(similar to Ruby def self.some_method
).
Calls a given method on an object similarly to Ruby Object#send
method Read more
Checks whether the object responds to given method Read more
fn protect_send(
&self,
method: &str,
arguments: &[AnyObject]
) -> Result<AnyObject, AnyException>
fn protect_send(
&self,
method: &str,
arguments: &[AnyObject]
) -> Result<AnyObject, AnyException>
protect_send
returns Result<AnyObject, AnyObject> Read more
fn protect_public_send(
&self,
method: &str,
arguments: &[AnyObject]
) -> Result<AnyObject, AnyException>
fn protect_public_send(
&self,
method: &str,
arguments: &[AnyObject]
) -> Result<AnyObject, AnyException>
protect_public_send
returns Result<AnyObject, AnyObject> Read more
Converts struct to AnyObject
Read more
Gets an instance variable of object Read more
Sets an instance variable for object Read more
Unsafely casts current object to the specified Ruby type Read more
Safely casts current object to the specified Ruby type Read more