Struct AccessGrants 

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

A validated map from principal to rights, limited to MAX_ACCESS_GRANT_ENTRIES entries and MAX_ACCESS_GRANTS_PRINCIPAL_BYTES bytes of principal ids. No entry has an empty set of rights. Decoding rejects repeated principals.

Implementations

impl AccessGrants

pub fn new( entries: BTreeMap<PrincipalId, AccessRights>, ) -> Result<Self, AccessGrantsError>

Validates entries against the caps and the no-empty-rights rule.

pub fn get(&self, principal_id: &PrincipalId) -> AccessRights

The rights granted to principal_id, empty when it has no entry.

pub fn iter(&self) -> impl Iterator<Item = (&PrincipalId, AccessRights)>

The entries in principal order.

pub fn len(&self) -> usize

Number of principals named.

pub fn is_empty(&self) -> bool

Whether no principal is named.

pub fn as_map(&self) -> &BTreeMap<PrincipalId, AccessRights>

The underlying map.

pub fn logical_bytes(&self) -> usize

Bytes this map accounts for when decoded: every principal id plus one byte per right.

Trait Implementations

impl Clone for AccessGrants

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AccessGrants

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

Formats the value using the given formatter.

impl Default for AccessGrants

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for AccessGrants

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl Eq for AccessGrants

impl PartialEq for AccessGrants

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for AccessGrants

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for AccessGrants

impl TryFrom<BTreeMap<PrincipalId, AccessRights>> for AccessGrants

type Error = AccessGrantsError

The type returned in the event of a conversion error.

fn try_from( entries: BTreeMap<PrincipalId, AccessRights>, ) -> Result<Self, Self::Error>

Performs the conversion.