vcard-rs 0.1.0

vCard parser, validator, editor and builder library for Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

//! # N value
//!
//! The decoded `N` (structured name) value.
//!
//! `N` is one of the few genuinely structured RFC 6350 values (section 6.2.2):
//! five `;`-ordered components (family, given, additional, prefixes, suffixes),
//! each a possibly multi-valued `,`-separated list. This bespoke type names
//! those components so callers read `name.family` rather than indexing a raw
//! component vector. Pure, always-unescaped data; the splitting, ordering and
//! escaping live on the syntax side ([`crate::tree`]). The wire name lives on
//! [`crate::prop::VcardProp::name`].

use alloc::{borrow::Cow, vec::Vec};

/// The decoded N value: five name components, each a clean (unescaped) value
/// list.
#[derive(Clone, Debug, Default, PartialEq, Eq)]
pub struct VcardN<'a> {
    /// Family names.
    pub family: Vec<Cow<'a, str>>,
    /// Given names.
    pub given: Vec<Cow<'a, str>>,
    /// Additional names.
    pub additional: Vec<Cow<'a, str>>,
    /// Honorific prefixes.
    pub prefixes: Vec<Cow<'a, str>>,
    /// Honorific suffixes.
    pub suffixes: Vec<Cow<'a, str>>,
}