Struct Attributes 

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

A validated attribute map for one inode.

Construction and decoding both enforce the same limits: a map holds at most MAX_ATTRIBUTE_ENTRIES entries, each value is at most MAX_ATTRIBUTE_VALUE_BYTES UTF-8 bytes, and the whole map is at most MAX_ATTRIBUTES_TOTAL_BYTES logical UTF-8 bytes. The total counts key bytes and value bytes and nothing else, so it does not depend on the encoding the map is written in. Durable state that breaks a limit fails to decode rather than decoding to something smaller.

An empty map is valid. It is the cleared state, and clearing an inode’s attributes is a real update with its own revision.

Implementations

impl Attributes

pub fn new( entries: BTreeMap<AttributeKey, AttributeValue>, ) -> Result<Self, AttributesError>

Creates a map after checking every limit.

pub fn get(&self, key: &AttributeKey) -> Option<&AttributeValue>

Returns the value stored under a key.

pub fn iter(&self) -> impl Iterator<Item = (&AttributeKey, &AttributeValue)>

Iterates the entries in key order.

pub fn len(&self) -> usize

Returns the number of entries.

pub fn is_empty(&self) -> bool

Reports whether the map holds no entries.

pub fn as_map(&self) -> &BTreeMap<AttributeKey, AttributeValue>

Returns the entries.

pub fn logical_bytes(&self) -> usize

Returns the map’s total logical size in UTF-8 bytes.

Trait Implementations

impl Clone for Attributes

fn clone(&self) -> Attributes

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Attributes

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

Formats the value using the given formatter.

impl Default for Attributes

fn default() -> Attributes

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Attributes

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Attributes

impl From<Attributes> for BTreeMap<AttributeKey, AttributeValue>

fn from(attributes: Attributes) -> Self

Converts to this type from the input type.

impl PartialEq for Attributes

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Attributes

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 Attributes

impl TryFrom<BTreeMap<AttributeKey, AttributeValue>> for Attributes

type Error = AttributesError

The type returned in the event of a conversion error.

fn try_from( entries: BTreeMap<AttributeKey, AttributeValue>, ) -> Result<Self, Self::Error>

Performs the conversion.