Struct magnus::value::Id

pub struct Id(/* private fields */);

The internal value of a Ruby symbol.

Implementations

impl Id

pub fn new<T>(name: T) -> Self

where T: AsRef<str>,

Create a new Id for name.

Panics

Panics if called from a non-Ruby thread. See Ruby::intern for the non-panicking version.

Examples

use magnus::value::Id;

let id = Id::new("example");
assert_eq!(id.name().unwrap(), "example");

pub fn check(name: &str) -> Option<Self>

Return the Id for name, if one exists.

Panics

Panics if called from a non-Ruby thread. See Ruby::check_id for the non-panicking version.

Examples

use magnus::{value::Id, StaticSymbol};

assert!(Id::check("example").is_none());
StaticSymbol::new("example");
assert!(Id::check("example").is_some());

pub fn name(self) -> Result<&'static str, Error>

Return the symbol name associated with this Id as a static string reference.

May error if the name is not valid utf-8.

Examples

use magnus::value::Id;

let id = Id::new("example");
assert_eq!(id.name().unwrap(), "example");

Trait Implementations

impl AsRawId for Id

Available on crate feature rb-sys only.

fn as_raw(self) -> ID

Convert magnus::value::Id to rb_sys::ID.

impl Borrow<OpaqueId> for Id

fn borrow(&self) -> &OpaqueId

Immutably borrows from an owned value.

impl Clone for Id

fn clone(&self) -> Id

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Id

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

Formats the value using the given formatter.

impl From<Id> for OpaqueId

fn from(id: Id) -> Self

Converts to this type from the input type.

impl From<Id> for StaticSymbol

fn from(id: Id) -> Self

Converts to this type from the input type.

impl From<Id> for Symbol

fn from(id: Id) -> Self

Converts to this type from the input type.

impl From<StaticSymbol> for Id

fn from(sym: StaticSymbol) -> Self

Converts to this type from the input type.

impl From<Symbol> for Id

fn from(sym: Symbol) -> Self

Converts to this type from the input type.

impl FromRawId for Id

Available on crate feature rb-sys only.

unsafe fn from_raw(id: ID) -> Id

Convert rb_sys::ID to magnus::value::Id.

impl Hash for Id

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl IntoId for Id

fn into_id_with(self, _: &Ruby) -> Id

Convert self into Id.

fn into_id(self) -> Id

Convert self into Id.

unsafe fn into_id_unchecked(self) -> Id

Convert self into Id.

impl IntoSymbol for Id

fn into_symbol_with(self, handle: &Ruby) -> Symbol

Convert self into Symbol.

fn into_symbol(self) -> Symbol

Convert self into Symbol.

unsafe fn into_symbol_unchecked(self) -> Symbol

Convert self into Symbol.

impl IntoValue for Id

fn into_value_with(self, handle: &Ruby) -> Value

Convert self into Value.

fn into_value(self) -> Value

Convert self into Value.

unsafe fn into_value_unchecked(self) -> Value

Convert self into Value.

impl PartialEq<Id> for LazyId

fn eq(&self, other: &Id) -> bool

Panics

Panics if the first call is from a non-Ruby thread. This LazyId will then be poisoned and all future use of it will panic.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<Id> for OpaqueId

fn eq(&self, other: &Id) -> bool

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

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<Id> for StaticSymbol

fn eq(&self, other: &Id) -> bool

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

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<Id> for Symbol

fn eq(&self, other: &Id) -> bool

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

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<LazyId> for Id

fn eq(&self, other: &LazyId) -> bool

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

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<OpaqueId> for Id

fn eq(&self, other: &OpaqueId) -> bool

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

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<StaticSymbol> for Id

fn eq(&self, other: &StaticSymbol) -> bool

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

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<Symbol> for Id

fn eq(&self, other: &Symbol) -> bool

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

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq for Id

fn eq(&self, other: &Id) -> bool

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

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for Id

impl Eq for Id

impl StructuralPartialEq for Id