Struct MetadataValue 

pub struct MetadataValue { /* private fields */ }

One value of a metadata name: its text and, for a contributor or a copyright, the role it was given – and the primitive it is, which says what more is known about it.

The text and the role are a reading of the content, not a second copy of it. Every way of building one of these fills all three together and nothing can write to them afterwards, so they cannot drift apart: a contributor’s text is the first name they go by, and a date’s is the way music21 writes it.

A value built as a plain text is not equal to one built as a contributor or a date of the same text, and that is right: the one knows what it is and the other does not.

Implementations

impl MetadataValue

pub fn new(text: impl Into<String>) -> Self

A value that is only text.

pub fn with_role(text: impl Into<String>, role: impl Into<String>) -> Self

A value with a role, as a contributor or a copyright has.

pub fn of_text(text: Text) -> Self

A value that is a piece of text saying what language it is in: music21’s Text, or its Copyright where the text has a role.

pub fn of_contributor(contributor: Contributor) -> Self

A value that is somebody who had a hand in the work: music21’s Contributor. Its text is the first name they go by, which is what music21’s own writers write.

pub fn of_date(date: DatePrimitive) -> Self

A value that is a date: music21’s four date classes. Its text is the way music21 writes that date.

pub fn text(&self) -> &str

The value as text: music21’s str(value).

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

The role, where the value has one.

pub fn content(&self) -> &MetadataContent

What the value is: a text, a contributor or a date.

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

The text with its language, where the value is one.

pub fn as_contributor(&self) -> Option<&Contributor>

The contributor, where the value is one.

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

The date, where the value is one.

Trait Implementations

impl Clone for MetadataValue

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 MetadataValue

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MetadataValue

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 Eq for MetadataValue

impl PartialEq for MetadataValue

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for MetadataValue

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 MetadataValue