Struct gedcomx::Person

#[non_exhaustive]
pub struct Person {

    pub id: Option<Id>,
    pub lang: Option<Lang>,
    pub sources: Vec<SourceReference>,
    pub analysis: Option<ResourceReference>,
    pub notes: Vec<Note>,
    pub confidence: Option<ConfidenceLevel>,
    pub attribution: Option<Attribution>,
    pub extracted: Option<bool>,
    pub evidence: Vec<EvidenceReference>,
    pub media: Vec<SourceReference>,
    pub identifiers: Vec<Identifier>,
    pub private: Option<bool>,
    pub gender: Option<Gender>,
    pub names: Vec<Name>,
    pub facts: Vec<Fact>,
}

A description of a person.

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.

id: Option<Id>

An identifier for the conclusion data. The id is to be used as a “fragment identifier” as defined by RFC 3986, Section 3.5.

lang: Option<Lang>

The locale identifier for the conclusion.

sources: Vec<SourceReference>

The list of references to the sources of related to this conclusion. Note that the sources referenced from conclusions are also considered to be sources of the entities that contain them. For example, a source associated with the Name of a Person is also source for the Person.

analysis: Option<ResourceReference>

A reference to the analysis document explaining the analysis that went into this conclusion. If provided, MUST resolve to an instance of Document of type Analysis.

notes: Vec<Note>

A list of notes about this conclusion.

confidence: Option<ConfidenceLevel>

The level of confidence the contributor has about the data.

attribution: Option<Attribution>

The attribution of this conclusion. If not provided, the attribution of the containing data set (e.g. file) of the conclusion is assumed.

extracted: Option<bool>

Whether this subject is to be constrained as an extracted conclusion.

evidence: Vec<EvidenceReference>

References to other subjects that support this subject.

If provided, each reference MUST resolve to an instance of subject of the same type as this instance (e.g., if the subject is an instance of Person, all of its evidence references must resolve to instances of Person).

media: Vec<SourceReference>

References to multimedia resources for this subject, such as photos or videos, intended to provide additional context or illustration for the subject and not considered evidence supporting the identity of the subject or its supporting conclusions.

Media references SHOULD be ordered by priority such that applications that wish to display a single media item (such as an image) MAY choose the first applicable media reference. Note that the SourceReference is used for multimedia references and therefore MUST resolve to a SourceDescription of the resource, which in turn provides a reference to the resource itself.

identifiers: Vec<Identifier>

A list of identifiers for the subject.

private: Option<bool>

Whether this instance of Person has been designated for limited distribution or display.

gender: Option<Gender>

The sex of the person as assigned at birth (see Sex Assignment).

names: Vec<Name>

The names of the person.

If more than one name is provided, names are assumed to be given in order of preference, with the most preferred name in the first position in the list.

facts: Vec<Fact>

The facts of the person.

Implementations

impl Person

pub fn new(
    id: Option<Id>,
    lang: Option<Lang>,
    sources: Vec<SourceReference>,
    analysis: Option<ResourceReference>,
    notes: Vec<Note>,
    confidence: Option<ConfidenceLevel>,
    attribution: Option<Attribution>,
    extracted: Option<bool>,
    evidence: Vec<EvidenceReference>,
    media: Vec<SourceReference>,
    identifiers: Vec<Identifier>,
    private: Option<bool>,
    gender: Option<Gender>,
    names: Vec<Name>,
    facts: Vec<Fact>
) -> Self

pub fn builder() -> PersonBuilder

Trait Implementations

impl Clone for Person

fn clone(&self) -> Person

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Person

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

Formats the value using the given formatter.

impl Default for Person

fn default() -> Person

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Person

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl PartialEq<Person> for Person

fn eq(&self, other: &Person) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Person) -> bool

This method tests for !=.

impl Serialize for Person

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

Serialize this value into the given Serde serializer.

impl TryFrom<&'_ Person> for EvidenceReference

type Error = GedcomxError

The type returned in the event of a conversion error.

fn try_from(f: &Person) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<&'_ Person> for ResourceReference

type Error = GedcomxError

The type returned in the event of a conversion error.

fn try_from(person: &Person) -> Result<Self, Self::Error>

Performs the conversion.

impl YaDeserialize for Person

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

impl YaSerialize for Person

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 StructuralPartialEq for Person