Struct elfo_core::Addr

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

Represents the global, usually unique address of an actor or a group.

Uniqueness

An address is based on an IDR to make it a simple sendable number (as opposed to reference counting) and provide better performance of lookups than hashmaps. However, it means deletions and insertions to the same underlying slot multiple times can lead to reusing the address for a different actor.

Elfo tries to do its best to ensure the uniqueness of this value:

• Alive actors on the same node always have different addresses.
• Actors in different nodes have different address spaces.
• Actors in different groups have different address spaces.
• An address includes the version number to guard against the ABA problem.
• An address is randomized between restarts of the same node if the network feature is enabled.

Using addresses in messages

The current implementation of network depends on the fact that Addr cannot be sent inside messages. It prevents from different possible errors like responding without having a valid connection. The only way to get an address of remote actor is envelope.sender(). If sending Addr inside a message is unavoidable, use Local<Addr>, however it won’t be possible to send such message to a remote actor.

Implementations

impl Addr

pub const NULL: Addr = _

Availability

This API is marked as unstable and is only available when the unstable crate feature is enabled. This comes with no stability guarantees, and could be changed or removed at any time.

pub fn from_bits(bits: u64) -> Option<Self>

Availability

This API is marked as unstable and is only available when the unstable crate feature is enabled. This comes with no stability guarantees, and could be changed or removed at any time.

pub fn into_bits(self) -> u64

Availability

This API is marked as unstable and is only available when the unstable crate feature is enabled. This comes with no stability guarantees, and could be changed or removed at any time.

pub fn is_null(self) -> bool

pub fn is_local(self) -> bool

pub fn is_remote(self) -> bool

pub fn node_no(self) -> Option<NodeNo>

Availability

This API is marked as unstable and is only available when the unstable crate feature is enabled. This comes with no stability guarantees, and could be changed or removed at any time.

pub fn group_no(self) -> Option<GroupNo>

Availability

This API is marked as unstable and is only available when the unstable crate feature is enabled. This comes with no stability guarantees, and could be changed or removed at any time.

pub fn into_remote(self, node_no: NodeNo) -> Self

Availability

This API is marked as unstable and is only available when the unstable crate feature is enabled. This comes with no stability guarantees, and could be changed or removed at any time.

pub fn into_local(self) -> Self

Availability

This API is marked as unstable and is only available when the unstable crate feature is enabled. This comes with no stability guarantees, and could be changed or removed at any time.

Trait Implementations

impl Clone for Addr

fn clone(&self) -> Addr

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Addr

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

Formats the value using the given formatter.

impl Display for Addr

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

Formats the value using the given formatter.

impl Hash for Addr

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 Ord for Addr

fn cmp(&self, other: &Addr) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized + PartialOrd,

Restrict a value to a certain interval.

impl PartialEq for Addr

fn eq(&self, other: &Addr) -> 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 PartialOrd for Addr

fn partial_cmp(&self, other: &Addr) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

This method tests less than (for self and other) and is used by the < operator.

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

This method tests less than or equal to (for self and other) and is used by the <= operator.

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

This method tests greater than (for self and other) and is used by the > operator.

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

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl Copy for Addr

impl Eq for Addr

impl StructuralPartialEq for Addr