Struct NamePart

#[non_exhaustive]
pub struct NamePart {
    pub part_type: Option<NamePartType>,
    pub value: String,
    pub qualifiers: Vec<Qualifier>,
}

A portion of a full name, including the terms that make up that portion.

Some name parts may have qualifiers to provide additional semantic meaning to the name part (e.g., “given name” or “surname”).

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

part_type: Option<NamePartType>

The type of the name part.

value: String

The term(s) from the name that make up this name part.

A name part value MAY contain more than one term from the full name, such as in the name part “John Fitzgerald” from the full name “John Fitzgerald Kennedy”. If multiple terms are detailed in a single NamePart, these terms SHOULD be separated using the name separator appropriate to the locale applicable to the containing name form.

qualifiers: Vec<Qualifier>

Qualifiers to add additional semantic meaning to the name part.

If present, use of a NamePartQualifier is RECOMMENDED.

Implementations

impl NamePart

pub fn new( part_type: Option<NamePartType>, value: String, qualifiers: Vec<Qualifier>, ) -> Self

pub fn builder<I: Into<String>>(value: I) -> NamePartBuilder

Trait Implementations

impl Arbitrary for NamePart

fn arbitrary(g: &mut Gen) -> Self

Return an arbitrary value.

fn shrink(&self) -> Box<dyn Iterator<Item = Self>>

Return an iterator of values that are smaller than itself.

impl Clone for NamePart

fn clone(&self) -> NamePart

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for NamePart

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

Formats the value using the given formatter.

impl Default for NamePart

fn default() -> NamePart

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for NamePart

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for NamePart

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl YaDeserialize for NamePart

fn deserialize<R: Read>(reader: &mut Deserializer<R>) -> Result<Self, String>

impl YaSerialize for NamePart

fn serialize<W: Write>(&self, writer: &mut Serializer<W>) -> Result<(), String>

fn serialize_attributes( &self, source_attributes: Vec<OwnedAttribute>, source_namespace: Namespace, ) -> Result<(Vec<OwnedAttribute>, Namespace), String>

impl Eq for NamePart

impl StructuralPartialEq for NamePart