Struct Contributor 

pub struct Contributor { /* private fields */ }

Somebody who had a hand in a work: music21’s metadata.Contributor. A composer, a lyricist, an arranger, or anybody else, under one or more names.

use music21::metadata::primitives::{Contributor, Text};

let composer = Contributor::new("composer", [Text::new("Beethoven, Ludwig van")]);
assert_eq!(composer.role(), Some("composer"));
assert_eq!(composer.to_string(), "composer:Beethoven, Ludwig van");

Implementations

impl Contributor

pub fn role_of_abbreviation(abbreviation: &str) -> Result<&'static str>

The role an abbreviation stands for, read without regard to case: music21’s abbreviationToRole.

Errors

An abbreviation no role is written with.

pub fn abbreviation_of_role(role: &str) -> Result<&'static str>

The abbreviation a role is written with, read without regard to case: music21’s roleToAbbreviation.

Errors

A role no abbreviation is written for.

pub fn new<I, T>(role: impl Into<String>, names: I) -> Self

where I: IntoIterator<Item = T>, T: Into<Text>,

Somebody in a role, under these names. An abbreviation is read as the role it stands for.

pub fn unnamed() -> Self

Somebody in no role at all, which is what music21 starts a contributor out as.

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

What they did, where it is known.

pub fn names(&self) -> &[Text]

Every name they go by, the first being the one music21 answers for name.

pub fn name(&self) -> Option<&Text>

The name they go by.

pub fn birth(&self) -> Option<&DatePrimitive>

When they were born, where it is known.

pub fn death(&self) -> Option<&DatePrimitive>

When they died, where it is known.

pub fn set_role(&mut self, role: Option<String>)

Says what they did. An abbreviation is read as the role it stands for, as music21’s own setter reads one, so a contributor given com is a composer.

pub fn set_name(&mut self, name: Text)

Gives them one name, in place of any they had: music21’s name setter, which replaces the whole list.

pub fn set_names(&mut self, names: Vec<Text>)

Gives them every name they go by.

pub fn set_birth(&mut self, birth: Option<DatePrimitive>)

Says when they were born.

pub fn set_death(&mut self, death: Option<DatePrimitive>)

Says when they died.

Trait Implementations

impl Clone for Contributor

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Contributor

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

Formats the value using the given formatter.

impl Default for Contributor

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Contributor

Available on crate feature serde only.

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Contributor

Written as music21’s _reprInternal writes one: the role, a colon, and every name they go by.

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

Formats the value using the given formatter.

impl Eq for Contributor

impl Hash for Contributor

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 Contributor

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Contributor

Available on crate feature serde only.

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Contributor