Struct ParticipantLabels 

pub struct ParticipantLabels { /* private fields */ }

The numbers a workspace’s participants are told apart by, resolved once from its roster and read for each label shown. Cheap to rebuild whenever the roster changes.

Implementations

impl ParticipantLabels

pub fn new<'a>( people: impl IntoIterator<Item = (&'a str, &'a str)>, ) -> ParticipantLabels

Resolve the numbers for people, each an (id, name) pair. Order does not matter, and a repeated id counts once (its last name). A blank name collides with nothing: it is shown as whatever stands in for it.

pub fn by_joining<'a>( people: impl IntoIterator<Item = (&'a str, &'a str, Option<u64>)>, ) -> ParticipantLabels

Self::new for people as (id, name, joined), joined being when the workspace admitted them (any unit every replica shares, such as the admission’s Unix time). Whoever joined first is numbered first; those the workspace has no time for follow, by id.

pub fn number(&self, id: &str) -> Option<usize>

The number id is told apart by, when their name collides.

pub fn label(&self, id: &str, name: &str) -> String

name as id is shown: “Ada (2)” when the workspace has more than one Ada, name itself otherwise. The number is only added while name is still the one that collided, so a caller holding a newer name than the roster’s never shows a number that belongs to the old one.

pub fn is_empty(&self) -> bool

Whether any participant needs a number.

Trait Implementations

impl Clone for ParticipantLabels

fn clone(&self) -> ParticipantLabels

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ParticipantLabels

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

Formats the value using the given formatter.

impl Default for ParticipantLabels

fn default() -> ParticipantLabels

Returns the “default value” for a type.

impl PartialEq for ParticipantLabels

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl Eq for ParticipantLabels

impl StructuralPartialEq for ParticipantLabels