libmusicbrainz3
3.0.3
|
Public Member Functions | |
Release (const std::string &id=std::string(), const std::string &title=std::string()) | |
Constructor. | |
~Release () | |
Destructor. | |
std::string | getTitle () const |
Returns the track's title. | |
void | setTitle (const std::string &title) |
Sets the release's title. | |
std::string | getTextLanguage () const |
Returns the language used in release and track titles. | |
void | setTextLanguage (const std::string &language) |
Sets the language used in releaes and track titles. | |
std::string | getTextScript () const |
Returns the script used in release and track titles. | |
void | setTextScript (const std::string &script) |
Sets the script used in releaes and track titles. | |
Artist * | getArtist () |
Returns the main artist of this release. | |
void | setArtist (Artist *artist) |
Sets this release's main artist. | |
ReleaseGroup * | getReleaseGroup () |
Returns the release group of this release. | |
void | setReleaseGroup (ReleaseGroup *releaseGroup) |
Sets this release's group. | |
std::string | getAsin () const |
Returns the Amazon shop identifier (ASIN). | |
void | setAsin (const std::string &asin) |
Sets the Amazon shop identifier (ASIN). | |
TrackList & | getTracks () |
Returns the tracks this release contains. | |
int | getNumTracks () const |
Returns number of tracks. | |
Track * | getTrack (int index) |
Returns an track specified by index. | |
int | getTracksOffset () const |
Returns the offset of the track list. | |
void | setTracksOffset (const int offset) |
Sets the offset of the track list. | |
int | getTracksCount () const |
Returns the number of tracks on this release. | |
void | setTracksCount (const int count) |
Sets the count of the track list. | |
DiscList & | getDiscs () |
Returns the discs associated with this release. | |
int | getNumDiscs () const |
Returns number of discs. | |
Disc * | getDisc (int index) |
Returns an disc specified by index. | |
ReleaseEventList & | getReleaseEvents () |
Returns the list of release events. | |
int | getNumReleaseEvents () const |
Returns number of release events. | |
ReleaseEvent * | getReleaseEvent (int index) |
Returns an release event specified by index. | |
void | setTypes (const std::vector< std::string > &types) |
Sets the list of release types. | |
std::vector< std::string > & | getTypes () |
Returns the list of release types. | |
int | getNumTypes () const |
Returns the number of release types. | |
std::string | getType (int index) const |
Returns the type specified by index. | |
![]() | |
virtual | ~Entity () |
Destructor. | |
virtual std::string | getId () const |
Returns a MusicBrainz ID. | |
virtual void | setId (const std::string &value) |
Sets a MusicBrainz ID. | |
RelationList | getRelations (const std::string &targetType=std::string(), const std::string &relationType=std::string()) const |
Returns a list of relations. | |
void | addRelation (Relation *relation) |
Adds a relation. | |
int | getNumRelations () const |
Returns number of relations. | |
Relation * | getRelation (int index) |
Returns an relation specified by index. | |
TagList & | getTags () |
int | getNumTags () const |
Tag * | getTag (int index) |
float | getRating () const |
void | setRating (float rating) |
int | getRatingVoteCount () const |
void | setRatingVoteCount (int count) |
Static Public Attributes | |
static const std::string | TYPE_NONE |
static const std::string | TYPE_ALBUM |
static const std::string | TYPE_SINGLE |
static const std::string | TYPE_EP |
static const std::string | TYPE_COMPILATION |
static const std::string | TYPE_SOUNDTRACK |
static const std::string | TYPE_SPOKENWORD |
static const std::string | TYPE_INTERVIEW |
static const std::string | TYPE_AUDIOBOOK |
static const std::string | TYPE_LIVE |
static const std::string | TYPE_REMIX |
static const std::string | TYPE_OTHER |
static const std::string | TYPE_OFFICIAL |
static const std::string | TYPE_PROMOTION |
static const std::string | TYPE_BOOTLEG |
static const std::string | TYPE_PSEUDO_RELEASE |
Additional Inherited Members | |
![]() | |
Entity (const std::string &id) | |
Constructor. |
Represents a Release.
A release within MusicBrainz is an Entity which contains Track objects. Releases may be of more than one type: There can be albums, singles, compilations, live recordings, official releases, bootlegs etc.
MusicBrainz::Release::Release | ( | const std::string & | id = std::string() , |
const std::string & | title = std::string() |
||
) |
Constructor.
id | a string containing an absolute URI |
title | a string containing the title |
MusicBrainz::Release::~Release | ( | ) |
Destructor.
Artist* MusicBrainz::Release::getArtist | ( | ) |
Returns the main artist of this release.
std::string MusicBrainz::Release::getAsin | ( | ) | const |
Returns the Amazon shop identifier (ASIN).
The ASIN is a 10-letter code (except for books) assigned by Amazon, which looks like 'B000002IT2' or 'B00006I4YD'.
Disc* MusicBrainz::Release::getDisc | ( | int | index | ) |
Returns an disc specified by index.
This is equivalent to getDiscs()
[index]
index
must be always lower than the result of getNumDiscs()
DiscList& MusicBrainz::Release::getDiscs | ( | ) |
Returns the discs associated with this release.
Discs are currently containers for MusicBrainz DiscIDs. Note that under rare circumstances (identical TOCs), a DiscID could be associated with more than one release.
const
int MusicBrainz::Release::getNumDiscs | ( | ) | const |
Returns number of discs.
This is equivalent to getDiscs()
.size()
int MusicBrainz::Release::getNumReleaseEvents | ( | ) | const |
Returns number of release events.
This is equivalent to getReleaseEvents()
.size()
int MusicBrainz::Release::getNumTracks | ( | ) | const |
Returns number of tracks.
This is equivalent to getTracks()
.size()
int MusicBrainz::Release::getNumTypes | ( | ) | const |
Returns the number of release types.
ReleaseEvent* MusicBrainz::Release::getReleaseEvent | ( | int | index | ) |
Returns an release event specified by index.
This is equivalent to getReleaseevents()
[index]
index
must be always lower than the result of getNumReleaseEvents()
ReleaseEventList& MusicBrainz::Release::getReleaseEvents | ( | ) |
Returns the list of release events.
A Release may contain a list of so-called release events, each represented using a ReleaseEvent object. Release evens specify where and when this release was, well, released.
ReleaseGroup* MusicBrainz::Release::getReleaseGroup | ( | ) |
Returns the release group of this release.
std::string MusicBrainz::Release::getTextLanguage | ( | ) | const |
Returns the language used in release and track titles.
To represent the language, the ISO-639-2/T standard is used, which provides three-letter terminological language codes like "ENG", "DEU", "JPN", "KOR", "ZHO" or "YID".
Note that this refers to release and track titles, not lyrics.
std::string MusicBrainz::Release::getTextScript | ( | ) | const |
Returns the script used in release and track titles.
To represent the script, ISO-15924 script codes are used. Valid codes are, among others: "Latn", "Cyrl", "Hans", "Hebr"
Note that this refers to release and track titles, not lyrics.
std::string MusicBrainz::Release::getTitle | ( | ) | const |
Returns the track's title.
The style and format of this attribute is specified by the style guide.
Track* MusicBrainz::Release::getTrack | ( | int | index | ) |
Returns an track specified by index.
This is equivalent to getTracks()
[index]
index
must be always lower than the result of getNumTracks()
TrackList& MusicBrainz::Release::getTracks | ( | ) |
Returns the tracks this release contains.
int MusicBrainz::Release::getTracksCount | ( | ) | const |
Returns the number of tracks on this release.
This may or may not match with the number of elements that getTracks and getNumTracks returns. If the count is higher than the list, it indicates that the list is incomplete.
int MusicBrainz::Release::getTracksOffset | ( | ) | const |
Returns the offset of the track list.
This is used if the track list is incomplete (ie. the web service only returned part of the tracks on this release). Note that the offset value is zero-based, which means track 0 is the first track.
std::string MusicBrainz::Release::getType | ( | int | index | ) | const |
Returns the type specified by index.
This is an equivalent to getTypes()
[index]
index
must be always lower than the result of getNumTypes()
index | index |
std::vector<std::string>& MusicBrainz::Release::getTypes | ( | ) |
void MusicBrainz::Release::setArtist | ( | Artist * | artist | ) |
Sets this release's main artist.
artist | a pointer to Artist object |
void MusicBrainz::Release::setAsin | ( | const std::string & | asin | ) |
Sets the Amazon shop identifier (ASIN).
asin | a string containing the ASIN |
void MusicBrainz::Release::setReleaseGroup | ( | ReleaseGroup * | releaseGroup | ) |
Sets this release's group.
releaseGroup | a pointer to ReleaseGroup object |
void MusicBrainz::Release::setTextLanguage | ( | const std::string & | language | ) |
Sets the language used in releaes and track titles.
language | a string containing a language code |
void MusicBrainz::Release::setTextScript | ( | const std::string & | script | ) |
Sets the script used in releaes and track titles.
script | a string containing a script code |
void MusicBrainz::Release::setTitle | ( | const std::string & | title | ) |
Sets the release's title.
title,: | a string containing the release's title |
void MusicBrainz::Release::setTracksCount | ( | const int | count | ) |
Sets the count of the track list.
count | an integer containing the count |
void MusicBrainz::Release::setTracksOffset | ( | const int | offset | ) |
Sets the offset of the track list.
offset | an integer containing the offset |
void MusicBrainz::Release::setTypes | ( | const std::vector< std::string > & | types | ) |
Sets the list of release types.
types | a vector of strings string |
|
static |
|
static |
|
static |
|
static |
|
static |
|
static |
|
static |
|
static |
|
static |
|
static |
|
static |
|
static |
|
static |
|
static |
|
static |
|
static |