Struct DatePrimitive 

pub struct DatePrimitive { /* private fields */ }

One or more dates and what they say: music21’s DatePrimitive and the four classes under it, which differ only in the relevances they take and in how they are written.

use music21::metadata::primitives::{DateKind, DatePrimitive, Relevance};

let span = DatePrimitive::between(["2009/12/31", "2010/1/28"])?;
assert_eq!(span.to_string(), "2009/12/31 to 2010/01/28");
assert_eq!(span.kind(), DateKind::Between);

let prior = DatePrimitive::relative("2009/12/31", Relevance::Prior)?;
assert_eq!(prior.to_string(), "prior to 2009/12/31");

Implementations

impl DatePrimitive

pub fn dates(&self) -> &[Date]

The dates it holds.

pub fn relevance(&self) -> Relevance

What they say.

pub fn kind(&self) -> DateKind

Which of music21’s four classes it is.

pub fn set_relevance(&mut self, relevance: Relevance) -> Result<()>

Says something else about the dates it holds.

Errors

A relevance one of music21’s other date classes keeps: its own setters refuse any that is not theirs, so DateSingle cannot be made to say between.

pub fn single(written: &str, relevance: Relevance) -> Result<Self>

One date: music21’s DateSingle.

Errors

A date that cannot be read, or a relevance DateSingle does not take.

pub fn relative(written: &str, relevance: Relevance) -> Result<Self>

A date something happened before or after: music21’s DateRelative.

Errors

A date that cannot be read, or a relevance DateRelative does not take.

pub fn between<I, S>(written: I) -> Result<Self>

where I: IntoIterator<Item = S>, S: AsRef<str>,

A span between dates: music21’s DateBetween.

Errors

A date that cannot be read.

pub fn selection<I, S>(written: I, relevance: Relevance) -> Result<Self>

where I: IntoIterator<Item = S>, S: AsRef<str>,

A choice among dates: music21’s DateSelection.

Errors

A date that cannot be read, or a relevance DateSelection does not take.

pub fn of_dates( dates: Vec<Date>, relevance: Relevance, kind: DateKind, ) -> Result<Self>

Dates already read, said to be of a kind.

Errors

A relevance that kind does not take.

Trait Implementations

impl Clone for DatePrimitive

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 DatePrimitive

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for DatePrimitive

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 DatePrimitive

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

Formats the value using the given formatter.

impl Eq for DatePrimitive

impl Hash for DatePrimitive

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 DatePrimitive

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for DatePrimitive

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 DatePrimitive