Struct rosy::Hash

#[repr(transparent)]
pub struct Hash(_);

An instance of Ruby's Hash class.

Methods

impl Hash

pub fn new() -> Self

Creates a new hash table.

pub fn from_map<'a, I, K, V>(map: I) -> Self where
    I: IntoIterator<Item = (&'a K, &'a V)>,
    K: Copy + Into<AnyObject> + 'a,
    V: Copy + Into<AnyObject> + 'a, 

Creates an instance from the key-value pairs in map.

Examples

This initializer is general enough to work with most map types. The most common use case would probably be interacting with Rust's HashMap.

use std::collections::HashMap;
use rosy::Hash;

let mut map = HashMap::new();
map.insert("is_working", true);

let hash = Hash::from_map(&map);
assert_eq!(hash.get("is_working"), true);

pub fn from_pairs<K: Object, V: Object>(pairs: &[(K, V)]) -> Self

This is supported on feature="ruby_2_6" only.

Creates a new hash table from pairs.

Examples

Although this may insert the objects efficiently, it requires a bit more verbose code.

However, one can use the turbofish (::<>) syntax to allow the compiler to infer types more easily:

use rosy::{Hash, String};

let hash = Hash::from_pairs::<String, String>(&[
    ("user".into(), "nvzqz".into()),
    ("name".into(), "Nikolai Vazquez".into()),
]);

assert_eq!(hash.get("user"), "nvzqz");
assert_eq!(hash.get("name"), "Nikolai Vazquez");

pub unsafe fn insert(self, key: impl Into<AnyObject>, val: impl Into<AnyObject>)

Associates val with key.

Safety

The caller must ensure that self is not frozen or else a FrozenError exception will be raised.

Examples

Rust types can automagically be converted to keys and values:

use rosy::{Hash, Object};

let hash = Hash::new();
unsafe { hash.insert("should_eat", true) };

assert_eq!(hash.to_s(), r#"{"should_eat"=>true}"#);

pub unsafe fn insert_pairs<K: Object, V: Object>(self, pairs: &[(K, V)])

This is supported on feature="ruby_2_6" only.

Inserts pairs into self in bulk.

Safety

The caller must ensure that self is not frozen or else a FrozenError exception will be raised.

pub fn get(self, key: impl Into<AnyObject>) -> AnyObject

Returns the value for key.

pub fn len(self) -> usize

Returns the number of key-value pairs in self.

pub fn is_empty(self) -> bool

Returns whether self is empty.

pub unsafe fn remove(self, key: impl Into<AnyObject>) -> AnyObject

Removes the value associated with key from self and returns it.

Safety

The caller must ensure that self is not frozen or else a FrozenError exception will be raised.

Examples

let hash = rosy::Hash::new();

unsafe {
    assert!(hash.remove("not_here").is_nil());
    hash.insert("is_here", true);
    assert_eq!(hash.remove("is_here"), true);
}

pub unsafe fn clear(self)

Removes all elements from self in-place.

Safety

The caller must ensure that self is not frozen or else a FrozenError exception will be raised.

Trait Implementations

impl GcInfoKey for Hash

unsafe fn stat_gc_unchecked(self) -> usize

Returns the status information for self with respect to the garbage collector.

unsafe fn latest_gc_info_unchecked(self) -> AnyObject

Returns the latest information regarding self with respect to the garbage collector.

fn stat_gc(self) -> Result<usize>

Returns the status information for self with respect to the garbage collector, or an exception if one is raised.

fn latest_gc_info(self) -> Result<AnyObject>

Returns the latest information regarding self with respect to the garbage collector.

impl Object for Hash

fn unique_id() -> Option<u128>

Returns a unique identifier for an object type to facilitate casting.

fn cast<A: Object>(obj: A) -> Option<Self>

Attempts to create an instance by casting obj.

fn ty(self) -> Ty

Returns the virtual type of self.

fn is_ty(self, ty: Ty) -> bool

Returns whether the virtual type of self is ty.

unsafe fn from_raw(raw: usize) -> Self

Creates a new object from raw without checking.

unsafe fn cast_unchecked(obj: impl Object) -> Self

Casts obj to Self without checking its type.

fn into_any_object(self) -> AnyObject

Returns self as an AnyObject.

fn as_any_object(&self) -> &AnyObject

Returns a reference to self as an AnyObject.

fn as_any_slice(&self) -> &[AnyObject]

Returns self as a reference to a single-element slice.

fn raw(self) -> usize

Returns the raw object pointer.

unsafe fn as_unchecked<O: Object>(&self) -> &O

Casts self to O without checking whether it is one.

unsafe fn into_unchecked<O: Object>(self) -> O

Converts self to O without checking whether it is one.

fn id(self) -> u64

Returns the object's identifier.

fn class(self) -> Class

Returns the Class for self.

fn singleton_class(self) -> Class

Returns the singleton Class of self, creating one if it doesn't exist already.

fn mark(self)

Marks self for Ruby to avoid garbage collecting it.

unsafe fn force_recycle(self)

Forces the garbage collector to free the contents of self.

fn def_singleton_method<N, F>(self, name: N, f: F) -> Result where
    N: Into<SymbolId>,
    F: MethodFn, 

Defines a method for name on the singleton class of self that calls f when invoked.

unsafe fn def_singleton_method_unchecked<N, F>(self, name: N, f: F) where
    N: Into<SymbolId>,
    F: MethodFn, 

Defines a method for name on the singleton class of self that calls f when invoked.

fn call(self, method: impl Into<SymbolId>) -> Result<AnyObject>

Calls method on self and returns the result.

unsafe fn call_unchecked(self, method: impl Into<SymbolId>) -> AnyObject

Calls method on self and returns the result.

fn call_with(
    self,
    method: impl Into<SymbolId>,
    args: &[impl Object]
) -> Result<AnyObject>

Calls method on self with args and returns the result.

unsafe fn call_with_unchecked(
    self,
    method: impl Into<SymbolId>,
    args: &[impl Object]
) -> AnyObject

Calls method on self with args and returns the result.

fn call_public(self, method: impl Into<SymbolId>) -> Result<AnyObject>

Calls the public method on self and returns the result.

unsafe fn call_public_unchecked(self, method: impl Into<SymbolId>) -> AnyObject

Calls the public method on self and returns the result.

fn call_public_with(
    self,
    method: impl Into<SymbolId>,
    args: &[impl Object]
) -> Result<AnyObject>

Calls the public method on self with args and returns the result.

unsafe fn call_public_with_unchecked(
    self,
    method: impl Into<SymbolId>,
    args: &[impl Object]
) -> AnyObject

Calls the public method on self with args and returns the result.

fn inspect(self) -> String

Returns a printable string representation of self.

fn to_s(self) -> String

Returns the result of calling the to_s method on self.

fn is_frozen(self) -> bool

Returns whether modifications can be made to self.

fn freeze(self)

Freezes self, preventing any further mutations.

fn is_eql<O: Object>(self, other: &O) -> bool

Returns whether self is equal to other in terms of the eql? method.

impl AsRef<AnyObject> for Hash

fn as_ref(&self) -> &AnyObject

Performs the conversion.

impl Clone for Hash

fn clone(&self) -> Hash

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl From<Hash> for AnyObject

fn from(object: Hash) -> AnyObject

Performs the conversion.

impl<K: Object, V: Object, '_> From<&'_ [(K, V)]> for Hash

fn from(pairs: &[(K, V)]) -> Self

Performs the conversion.

impl Copy for Hash

impl PartialEq<AnyObject> for Hash

fn eq(&self, obj: &AnyObject) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]

fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl Debug for Hash

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Display for Hash

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.

impl<K: Into<AnyObject>, V: Into<AnyObject>> FromIterator<(K, V)> for Hash

fn from_iter<I: IntoIterator<Item = (K, V)>>(iter: I) -> Self

Creates a value from an iterator.