Struct musicbrainz_rs::entity::artist::Artist[][src]

pub struct Artist {
Show fields pub id: String, pub name: String, pub sort_name: String, pub disambiguation: String, pub artist_type: Option<ArtistType>, pub gender: Option<Gender>, pub area: Option<Area>, pub begin_area: Option<Area>, pub relations: Option<Vec<Relation>>, pub releases: Option<Vec<Release>>, pub works: Option<Vec<Work>>, pub release_groups: Option<Vec<ReleaseGroup>>, pub recordings: Option<Vec<Recording>>, pub aliases: Option<Vec<Alias>>, pub tags: Option<Vec<Tag>>, pub genres: Option<Vec<Genre>>, pub rating: Option<Rating>, pub country: Option<String>, pub annotation: Option<String>, pub life_span: Option<LifeSpan>,
}
Expand description

An artist is generally a musician (or musician persona), group of musicians, or other music professional (like a producer or engineer). Occasionally, it can also be a non-musical person (like a photographer, an illustrator, or a poet whose writings are set to music), or even a fictional character. For some other special cases, see special purpose artists.

Fields

id: Stringname: String

The official name of an artist, be it a person or a band.

sort_name: String

The sort name is a variant of the artist name which would be used when sorting artists by name, such as in record shops or libraries. Among other things, sort names help to ensure that all the artists that start with “The” don’t end up up under “T”. The guidelines for sort names are the best place to check for more specific usage info.

disambiguation: Stringartist_type: Option<ArtistType>

The type is used to state whether an artist is a person, a group, or something else.

gender: Option<Gender>

The gender is used to explicitly state whether a person or character identifies as male, female or neither. Groups do not have genders.

area: Option<Area>

The artist area, as the name suggests, indicates the area with which an artist is primarily identified with. It is often, but not always, its birth/formation country.

begin_area: Option<Area>

The artist begin area, as the name suggests, indicates the area with which an artist started to perform.

relations: Option<Vec<Relation>>releases: Option<Vec<Release>>works: Option<Vec<Work>>release_groups: Option<Vec<ReleaseGroup>>recordings: Option<Vec<Recording>>aliases: Option<Vec<Alias>>

Aliases are used to store alternate names or misspellings. For more information and examples, see the page about aliases.

tags: Option<Vec<Tag>>genres: Option<Vec<Genre>>rating: Option<Rating>country: Option<String>annotation: Option<String>

Annotations are text fields, functioning like a miniature wiki, that can be added to any existing artists, labels, recordings, releases, release groups and works.

life_span: Option<LifeSpan>

The begin and end dates indicate when an artist started and finished its existence. Its exact meaning depends on the type of artist:

  • For a person Begin date represents date of birth, and end date represents date of death.

    • For a group (or orchestra/choir) Begin date represents the date when the group first formed: if a group dissolved and then reunited, the date is still that of when they first formed. End date represents the date when the group last dissolved: if a group dissolved and then reunited, the date is that of when they last dissolved (if they are together, it should be blank!). For listing other inactivity periods, just use the annotation and the “member of” relationships.

    • For a character Begin date represents the date (in real life) when the character concept was created. The End date should not be set, since new media featuring a character can be created at any time. In particular, the Begin and End date fields should not be used to hold the fictional birth or death dates of a character. (This information can be put in the annotation.)

    • For others There are no clear indications about how to use dates for artists of the type Other at the moment.

Implementations

impl Artist[src]

Trait Implementations

impl Browsable for Artist[src]

const COUNT_FIELD: &'static str[src]

const OFFSET_FIELD: &'static str[src]

const ENTITIES_FIELD: &'static str[src]

impl Browse<'_> for Artist[src]

fn browse() -> BrowseQuery<Self> where
    Self: Sized + Path<'a>, 
[src]

impl Clone for Artist[src]

fn clone(&self) -> Artist[src]

Returns a copy of the value. Read more

fn clone_from(&mut self, source: &Self)1.0.0[src]

Performs copy-assignment from source. Read more

impl Debug for Artist[src]

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

Formats the value using the given formatter. Read more

impl Default for Artist[src]

fn default() -> Artist[src]

Returns the “default value” for a type. Read more

impl<'de> Deserialize<'de> for Artist where
    Artist: Default
[src]

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

Deserialize this value from the given Serde deserializer. Read more

impl Fetch<'_> for Artist[src]

fn fetch() -> FetchQuery<Self> where
    Self: Sized + Path<'a>, 
[src]

impl PartialEq<Artist> for Artist[src]

fn eq(&self, other: &Artist) -> bool[src]

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

fn ne(&self, other: &Artist) -> bool[src]

This method tests for !=.

impl Path<'_> for Artist[src]

fn path() -> &'static str[src]

impl Search<'_> for Artist[src]

fn search(query: String) -> SearchQuery<Self> where
    Self: Sized + Path<'a>, 
[src]

impl Searchable for Artist[src]

const CREATED_FIELD: &'static str[src]

const COUNT_FIELD: &'static str[src]

const OFFSET_FIELD: &'static str[src]

const ENTITIES_FIELD: &'static str[src]

impl Serialize for Artist[src]

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

Serialize this value into the given Serde serializer. Read more

impl StructuralPartialEq for Artist[src]

Auto Trait Implementations

impl RefUnwindSafe for Artist

impl Send for Artist

impl Sync for Artist

impl Unpin for Artist

impl UnwindSafe for Artist

Blanket Implementations

impl<T> Any for T where
    T: 'static + ?Sized
[src]

pub fn type_id(&self) -> TypeId[src]

Gets the TypeId of self. Read more

impl<T> Borrow<T> for T where
    T: ?Sized
[src]

pub fn borrow(&self) -> &T[src]

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T where
    T: ?Sized
[src]

pub fn borrow_mut(&mut self) -> &mut T[src]

Mutably borrows from an owned value. Read more

impl<T> From<T> for T[src]

pub fn from(t: T) -> T[src]

Performs the conversion.

impl<T, U> Into<U> for T where
    U: From<T>, 
[src]

pub fn into(self) -> U[src]

Performs the conversion.

impl<T> ToOwned for T where
    T: Clone
[src]

type Owned = T

The resulting type after obtaining ownership.

pub fn to_owned(&self) -> T[src]

Creates owned data from borrowed data, usually by cloning. Read more

pub fn clone_into(&self, target: &mut T)[src]

🔬 This is a nightly-only experimental API. (toowned_clone_into)

recently added

Uses borrowed data to replace owned data, usually by cloning. Read more

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
[src]

type Error = Infallible

The type returned in the event of a conversion error.

pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>[src]

Performs the conversion.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
[src]

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>[src]

Performs the conversion.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 

type Err = <U as TryFrom<T>>::Err

pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Err>

impl<T> DeserializeOwned for T where
    T: for<'de> Deserialize<'de>, 
[src]