Struct Author 

pub struct Author { /* private fields */ }

Represents a single author as (typically) described on the author line.

The attributes firstname, middlename, lastname, and authorinitials are automatically derived from the full value of the author string. When assigned implicitly via the author line, the value includes all of the characters and words prior to the semicolon (;), angle bracket (<), or the end of the line. Note that when using the implicit author line, the full name can have a maximum of three space-separated names. If it has more, then the full name is assigned to the firstname attribute. You can adjoin names using an underscore (_) character.

Implementations

impl Author

pub fn name(&self) -> &str

Returns the full name of the author.

The name includes the entire author declaration except for email.

pub fn firstname(&self) -> &str

Returns the first, forename, or given name of the author.

The first space-separated name in the value of the author attribute is automatically assigned to firstname.

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

Returns the middle name or initial of the author.

If author contains three space-separated names, the second name is assigned to the middlename attribute.

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

Returns the last, surname, or family name of the author.

If the author name contains two or three space-separated names, the last of those names is assigned to the lastname attribute.

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

Returns the email address or URL associated with the author.

When assigned via the author line, it’s enclosed in a pair of angle brackets (< >). A URL can be used in place of the email address.

pub fn initials(&self) -> String

Returns the initials of the author.

The first character of the firstname, middlename, and lastname attribute values are assigned to the authorinitials attribute. The value of the authorinitials attribute will consist of three characters or less depending on how many parts are in the author’s name.

Trait Implementations

impl Clone for Author

fn clone(&self) -> Author

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Author

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

Formats the value using the given formatter.

impl PartialEq for Author

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

impl StructuralPartialEq for Author