Struct Name 

pub struct Name {
    pub family: Option<String>,
    pub given: Option<String>,
    pub dropping_particle: Option<String>,
    pub non_dropping_particle: Option<String>,
    pub suffix: Option<String>,
    pub literal: Option<String>,
    pub extra: BTreeMap<String, String>,
}

Name complex field type.

Contains information about one person.

Should have at least the family field (for personyms) or the literal field (for institutions). People using mononyms can have just the family field as their sole name.

Fields

family: Option<String>

Represents the familial name that a person inherits.

given: Option<String>

Represents the name a person has been given or has chosen for themselves.

dropping_particle: Option<String>

Elements before the given name.

For example, in “Rev. Martin Luther Jr.”, “Rev.” is the dropping particle.

It’s also acceptable to include these particles directly as part of the given field.

non_dropping_particle: Option<String>

Elements before the family name.

For example, in “Bartolomé de las Casas”, “de las” are the non-dropping particles.

It’s also acceptable to include these particles directly as part of the family field.

suffix: Option<String>

Elements after the family name.

For example, in “Rev. Martin Luther Jr.”, “Jr.” is the suffix.

Multiple suffixes may be given, e.g. “Jr., Ph.D.”.

It’s also acceptable to include these suffixes directly as part of the family field.

literal: Option<String>

Name of an institution, or whole name of a person.

extra: BTreeMap<String, String>

Name fields not defined above.

Trait Implementations

impl Clone for Name

fn clone(&self) -> Name

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Name

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

Formats the value using the given formatter.

impl Default for Name

fn default() -> Name

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Name

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Hash for Name

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Name

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Name

impl StructuralPartialEq for Name