/usr/include/musicbrainz3/metadata.h is in libmusicbrainz3-dev 3.0.2-2.1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 | /*
* MusicBrainz -- The Internet music metadatabase
*
* Copyright (C) 2006 Lukas Lalinsky
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
*
* $Id: metadata.h 9218 2007-06-25 20:11:09Z luks $
*/
#ifndef __MUSICBRAINZ3_METADATA_H__
#define __MUSICBRAINZ3_METADATA_H__
#include <musicbrainz3/model.h>
#include <musicbrainz3/results.h>
namespace MusicBrainz
{
/**
* Represents a parsed Music Metadata XML document.
*
* The Music Metadata XML format is very flexible and may contain a
* diverse set of data (e.g. an artist, a release and a list of tracks),
* but usually only a small subset is used (either an artist, a release
* or a track, or a lists of objects from one class).
*
* @see MbXmlParser for reading
*/
class MB_API Metadata
{
public:
Metadata();
virtual ~Metadata();
/**
* Returns the artist.
*
* @param remove if set to \c true, the object will be removed from
* this Metadata instance and the caller is responsible for
* deleting it when it is no longer needed
*
* @return a pointer to Artist object, or \c NULL
*/
Artist *getArtist(bool remove = false);
/**
* Sets the artist.
*
* @param artist a pointer to Artist object, or \c NULL
*/
void setArtist(Artist *artist);
/**
* Returns the release.
*
* @param remove if set to \c true, the object will be removed from
* this Metadata instance and the caller is responsible for
* deleting it when it is no longer needed
*
* @return a pointer to Release object, or \c NULL
*/
Release *getRelease(bool remove = false);
/**
* Sets the release.
*
* @param release a pointer to Release object, or \c NULL
*/
void setRelease(Release *release);
/**
* Returns a track.
*
* @param remove if set to \c true, the object will be removed from
* this Metadata instance and the caller is responsible for
* deleting it when it is no longer needed
*
* @return a pointer to Track object, or \c NULL
*/
Track *getTrack(bool remove = false);
/**
* Sets the track.
*
* @param track a pointer to Track object, or \c NULL
*/
void setTrack(Track *track);
/**
* Returns the label.
*
* @param remove if set to \c true, the object will be removed from
* this Metadata instance and the caller is responsible for
* deleting it when it is no longer needed
*
* @return a pointer to Label object, or \c NULL
*/
Label *getLabel(bool remove = false);
/**
* Sets the label.
*
* @param label a pointer to Label object, or \c NULL
*/
void setLabel(Label *label);
/**
* Returns a list of users.
*
* @return a vector of pointers to User objects
*
* @note This is a MusicBrainz extension.
*/
UserList &getUserList();
UserList getUserList(bool remove);
/**
* Returns a artist result list.
*
* @return a vector of pointers to ArtistResult objects
*/
ArtistResultList &getArtistResults();
ArtistResultList getArtistResults(bool remove);
/**
* Returns a track result list.
*
* @return a vector of pointers to TrackResult objects
*/
TrackResultList &getTrackResults();
TrackResultList getTrackResults(bool remove);
/**
* Returns a release result list.
*
* @return a vector of pointers to ReleaseResult objects
*/
ReleaseResultList &getReleaseResults();
ReleaseResultList getReleaseResults(bool remove);
private:
class MetadataPrivate;
MetadataPrivate *d;
};
}
#endif
|