http://www.ousob.com --- Legacy Redefined OuSob - File: /wwwroot/clipx/usr/include/taglib/apetag.h

/*************************************************************************** copyright : (C) 2004 by Allan Sandfeld Jensen email : kde@carewolf.org ***************************************************************************/ /*************************************************************************** * This library is free software; you can redistribute it and/or modify * * it under the terms of the GNU Lesser General Public License version * * 2.1 as published by the Free Software Foundation. * * * * 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 * * USA * ***************************************************************************/ #ifndef TAGLIB_APETAG_H #define TAGLIB_APETAG_H #include <tag.h> #include <tbytevector.h> #include <tmap.h> #include <tstring.h> #include "apeitem.h" namespace TagLib { class File; //! An implementation of the APE tagging format namespace APE { class Footer; /*! * A mapping between a list of item names, or keys, and the associated item. * * \see APE::Tag::itemListMap() */ typedef Map<const String, Item> ItemListMap; //! An APE tag implementation class Tag : public TagLib::Tag { public: /*! * Create an APE tag with default values. */ Tag(); /*! * Create an APE tag and parse the data in \a file with APE footer at * \a tagOffset. */ Tag(File *file, long tagOffset); /*! * Destroys this Tag instance. */ virtual ~Tag(); /*! * Renders the in memory values to a ByteVector suitable for writing to * the file. */ ByteVector render() const; /*! * Returns the string "APETAGEX" suitable for usage in locating the tag in a * file. */ static ByteVector fileIdentifier(); // Reimplementations. virtual String title() const; virtual String artist() const; virtual String album() const; virtual String comment() const; virtual String genre() const; virtual uint year() const; virtual uint track() const; virtual void setTitle(const String &s); virtual void setArtist(const String &s); virtual void setAlbum(const String &s); virtual void setComment(const String &s); virtual void setGenre(const String &s); virtual void setYear(uint i); virtual void setTrack(uint i); /*! * Returns a pointer to the tag's footer. */ Footer *footer() const; /*! * Returns a reference to the item list map. This is an ItemListMap of * all of the items in the tag. * * This is the most powerfull structure for accessing the items of the tag. * * \warning You should not modify this data structure directly, instead * use setItem() and removeItem(). */ const ItemListMap &itemListMap() const; /*! * Removes the \a key item from the tag */ void removeItem(const String &key); /*! * Adds to the item specified by \a key the data \a value. If \a replace * is true, then all of the other values on the same key will be removed * first. */ void addValue(const String &key, const String &value, bool replace = true); /*! * Sets the \a key item to the value of \a item. If an item with the \a key is already * present, it will be replaced. */ void setItem(const String &key, const Item &item); protected: /*! * Reads from the file specified in the constructor. */ void read(); /*! * Parses the body of the tag in \a data. */ void parse(const ByteVector &data); private: Tag(const Tag &); Tag &operator=(const Tag &); class TagPrivate; TagPrivate *d; }; } } #endif