Struct Tag 

pub struct Tag { /* private fields */ }

A tag from Bear’s database.

Tags in Bear organize notes hierarchically (e.g., “work/projects/bear-query”).

Nullable Fields

• name: Tag name. In theory should never be NULL, but we handle it defensively. A tag without a name would be unusual but possible in a corrupted database.
• modified: Timestamp of last modification. May be None for tags that have never been explicitly modified.

Example

let db = BearDb::new()?;
let tags = db.tags()?;

for tag in tags.iter() {
    let name = tag.name().unwrap_or("[unnamed]");
    match tag.modified() {
        Some(modified) => println!("Tag '{}' modified: {}", name, modified),
        None => println!("Tag '{}' (never modified)", name),
    }
}

Implementations

impl Tag

pub fn id(&self) -> TagId

Returns the tag’s primary key identifier.

This is always present (never NULL) and stable across the tag’s lifetime.

pub fn name(&self) -> Option<&str>

Returns the tag’s name, if present.

Returns None in the rare case of a tag without a name (corrupted data).

Tag names can be hierarchical, using / as separator:

• "work" - top-level tag
• "work/projects" - nested tag
• "work/projects/bear-query" - deeply nested tag

pub fn modified(&self) -> Option<OffsetDateTime>

Returns the timestamp of the tag’s last modification, if available.

Returns None for tags that have never been explicitly modified.

Trait Implementations

impl Clone for Tag

fn clone(&self) -> Tag

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Tag

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

Formats the value using the given formatter.