Struct Tags 

pub struct Tags { /* private fields */ }

A collection of tags with operations for add, remove, rename, query, and dedup.

Implementations

impl Tags

pub fn new() -> Self

Create an empty tag collection.

pub fn add(&mut self, tag: Tag)

Add a tag. If a tag with the same name already exists, it is replaced.

pub fn dedup(&mut self)

Remove duplicate tags, keeping the first occurrence of each name (compared case-insensitively).

pub fn has(&self, name: &str) -> bool

Check whether a tag with the given name exists (case-insensitive).

pub fn is_empty(&self) -> bool

Return whether the collection is empty.

pub fn iter(&self) -> impl Iterator<Item = &Tag>

Return an iterator over the tags.

pub fn len(&self) -> usize

Return the number of tags.

pub fn matches_wildcard(&self, pattern: &str) -> bool

Check whether any tag name matches a wildcard pattern.

Wildcards: * matches zero or more characters, ? matches exactly one. Matching is case-insensitive.

pub fn remove(&mut self, name: &str) -> usize

Remove all tags whose names match case-insensitively. Returns the number of tags removed.

pub fn remove_by_regex(&mut self, pattern: &str) -> usize

Remove all tags whose names match a regex pattern (case-insensitive). Returns the number of tags removed.

pub fn remove_by_wildcard(&mut self, pattern: &str) -> usize

Remove all tags whose names match a wildcard pattern. Returns the number of tags removed.

pub fn rename(&mut self, old_name: &str, new_name: &str) -> usize

Rename all tags matching old_name to new_name, preserving values. Returns the number of tags renamed.

pub fn rename_by_wildcard(&mut self, pattern: &str, new_name: &str) -> usize

Rename all tags matching a wildcard pattern to new_name, preserving values. Returns the number of tags renamed.

Trait Implementations

impl Clone for Tags

fn clone(&self) -> Tags

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Tags

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

Formats the value using the given formatter.

impl Default for Tags

fn default() -> Tags

Returns the “default value” for a type.

impl Display for Tags

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

Formats the value using the given formatter.

impl FromIterator<Tag> for Tags

fn from_iter<I: IntoIterator<Item = Tag>>(iter: I) -> Self

Creates a value from an iterator.

impl PartialEq for Tags

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

impl StructuralPartialEq for Tags