TagLib
1.13.1
|
An implementation of TagLib::File with MPC specific methods. More...
#include <mpcfile.h>
Public Types | |
enum | TagTypes { NoTags = 0x0000 , ID3v1 = 0x0001 , ID3v2 = 0x0002 , APE = 0x0004 , AllTags = 0xffff } |
![]() | |
enum | Position { Beginning , Current , End } |
enum | StripTags { StripNone , StripOthers } |
enum | DuplicateTags { Duplicate , DoNotDuplicate } |
Public Member Functions | |
File (FileName file, bool readProperties=true, Properties::ReadStyle propertiesStyle=Properties::Average) | |
File (IOStream *stream, bool readProperties=true, Properties::ReadStyle propertiesStyle=Properties::Average) | |
virtual | ~File () |
virtual TagLib::Tag * | tag () const |
PropertyMap | properties () const |
void | removeUnsupportedProperties (const StringList &properties) |
PropertyMap | setProperties (const PropertyMap &) |
virtual Properties * | audioProperties () const |
virtual bool | save () |
ID3v1::Tag * | ID3v1Tag (bool create=false) |
APE::Tag * | APETag (bool create=false) |
void | strip (int tags=AllTags) |
TAGLIB_DEPRECATED void | remove (int tags=AllTags) |
bool | hasID3v1Tag () const |
bool | hasAPETag () const |
![]() | |
FileName | name () const |
PropertyMap | properties () const |
void | removeUnsupportedProperties (const StringList &properties) |
PropertyMap | setProperties (const PropertyMap &properties) |
ByteVector | readBlock (unsigned long length) |
void | writeBlock (const ByteVector &data) |
long | find (const ByteVector &pattern, long fromOffset=0, const ByteVector &before=ByteVector()) |
long | rfind (const ByteVector &pattern, long fromOffset=0, const ByteVector &before=ByteVector()) |
void | insert (const ByteVector &data, unsigned long start=0, unsigned long replace=0) |
void | removeBlock (unsigned long start=0, unsigned long length=0) |
bool | readOnly () const |
bool | isOpen () const |
bool | isValid () const |
void | seek (long offset, Position p=Beginning) |
void | clear () |
long | tell () const |
long | length () |
Static Public Member Functions | |
static bool | isSupported (IOStream *stream) |
![]() | |
static TAGLIB_DEPRECATED bool | isReadable (const char *file) |
static TAGLIB_DEPRECATED bool | isWritable (const char *name) |
Additional Inherited Members | |
![]() | |
File (FileName file) | |
File (IOStream *stream) | |
void | setValid (bool valid) |
void | truncate (long length) |
![]() | |
static unsigned int | bufferSize () |
An implementation of TagLib::File with MPC specific methods.
This implements and provides an interface for MPC files to the TagLib::Tag and TagLib::AudioProperties interfaces by way of implementing the abstract TagLib::File API as well as providing some additional information specific to MPC files. The only invalid tag combination supported is an ID3v1 tag after an APE tag.
TagLib::MPC::File::File | ( | FileName | file, |
bool | readProperties = true, | ||
Properties::ReadStyle | propertiesStyle = Properties::Average ) |
Constructs an MPC file from file. If readProperties is true the file's audio properties will also be read.
References TagLib::AudioProperties::Average.
Referenced by isSupported().
TagLib::MPC::File::File | ( | IOStream * | stream, |
bool | readProperties = true, | ||
Properties::ReadStyle | propertiesStyle = Properties::Average ) |
Constructs an MPC file from stream. If readProperties is true the file's audio properties will also be read.
References TagLib::AudioProperties::Average.
|
virtual |
Destroys this instance of the File.
Reimplemented from TagLib::File.
APE::Tag * TagLib::MPC::File::APETag | ( | bool | create = false | ) |
Returns a pointer to the APE tag of the file.
If create is false (the default) this may return a null pointer if there is no valid APE tag. If create is true it will create an APE tag if one does not exist and returns a valid pointer. If there already be an ID3v1 tag, the new APE tag will be placed before it.
|
virtual |
Returns the MPC::Properties for this file. If no audio properties were read then this will return a null pointer.
Implements TagLib::File.
bool TagLib::MPC::File::hasAPETag | ( | ) | const |
bool TagLib::MPC::File::hasID3v1Tag | ( | ) | const |
Returns whether or not the file on disk actually has an ID3v1 tag.
ID3v1::Tag * TagLib::MPC::File::ID3v1Tag | ( | bool | create = false | ) |
Returns a pointer to the ID3v1 tag of the file.
If create is false (the default) this returns a null pointer if there is no valid APE tag. If create is true it will create an APE tag if one does not exist and returns a valid pointer.
|
static |
PropertyMap TagLib::MPC::File::properties | ( | ) | const |
Implements the unified property interface – export function. If the file contains both an APE and an ID3v1 tag, only the APE tag will be converted to the PropertyMap.
Referenced by removeUnsupportedProperties().
TAGLIB_DEPRECATED void TagLib::MPC::File::remove | ( | int | tags = AllTags | ) |
void TagLib::MPC::File::removeUnsupportedProperties | ( | const StringList & | properties | ) |
References properties().
|
virtual |
PropertyMap TagLib::MPC::File::setProperties | ( | const PropertyMap & | ) |
Implements the unified property interface – import function. Affects only the APEv2 tag which will be created if necessary. If an ID3v1 tag exists, it will be updated as well.
void TagLib::MPC::File::strip | ( | int | tags = AllTags | ) |
|
virtual |
Returns the Tag for this file. This will be an APE tag, an ID3v1 tag or a combination of the two.
Implements TagLib::File.