Struct Book 

pub struct Book {
    cards: Vec<BookCard>,
    by_address: HashMap<String, Vec<usize>>,
    by_number: HashMap<String, Vec<usize>>,
    by_name: HashMap<String, Vec<usize>>,
    names: BTreeMap<String, String>,
    region: Option<&'static Region>,
}

Your address books, as who may reach you needs them (docs/porch.md, “Who may reach you, and when”): who is in them, by address, number, name and card, with each card’s categories. Read from every address book, on a server or on this device only, read-only ones too.

Fields

cards: Vec<BookCard>

by_address: HashMap<String, Vec<usize>>

Address, lower case → its cards.

by_number: HashMap<String, Vec<usize>>

A number’s key (phones::key) → its cards.

by_name: HashMap<String, Vec<usize>>

A name as compared (name_key) → its cards.

names: BTreeMap<String, String>

Every category in use, as compared → as first written.

region: Option<&'static Region>

The country numbers written without one were read as.

Implementations

impl Book

pub fn of(contacts: &[Contact], region: Option<&'static Region>) -> Book

From contacts; region reads their numbers written without a country.

pub fn cards_of_address(&self, address: &str) -> &[usize]

The cards holding this address.

pub fn cards_of_number(&self, key: &str) -> &[usize]

The cards holding this number, by its key.

pub fn cards_named(&self, name: &str) -> &[usize]

The cards with this very name (name_key).

pub fn card(&self, index: usize) -> Option<&BookCard>

A card, by its place.

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

A card’s place, by its UID or its file.

pub fn categories_of(&self, cards: &[usize]) -> Vec<String>

The categories of these cards, as compared, each once.

pub fn of_address(&self, address: &str) -> Vec<String>

The categories of the cards holding this address, as compared.

pub fn names(&self) -> Vec<String>

Every category in use, as first written, in order.

pub fn numbers(&self) -> impl Iterator<Item = &str>

Every number on a card, by its key.

pub fn len(&self) -> usize

How many cards.

pub fn is_empty(&self) -> bool

pub fn region(&self) -> Option<&'static Region>

The country numbers written without one were read as.

pub fn load(region: Option<&'static Region>) -> Arc<Book>

From every address book, kept while their files do not change: read again only when one is added, changed or taken away, or the country numbers are read in changes; never per message or per call.

Trait Implementations

impl Clone for Book

fn clone(&self) -> Book

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Book

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

Formats the value using the given formatter.

impl Default for Book

fn default() -> Book

Returns the “default value” for a type.

impl Eq for Book

impl PartialEq for Book

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Book