TagLib 1.10 (TagLib: TagLib::RIFF::File Class Reference)

TagLib::RIFF::File Class Reference

An RIFF file class with some useful methods specific to RIFF. More...

#include <rifffile.h>

Inheritance diagram for TagLib::RIFF::File:
Collaboration diagram for TagLib::RIFF::File:

List of all members.

Public Member Functions

virtual ~File ()

Protected Types

enum  Endianness { BigEndian, LittleEndian }

Protected Member Functions

 File (FileName file, Endianness endianness)
 File (IOStream *stream, Endianness endianness)
uint riffSize () const
uint chunkCount () const
uint chunkOffset (uint i) const
uint chunkDataSize (uint i) const
uint chunkPadding (uint i) const
ByteVector chunkName (uint i) const
ByteVector chunkData (uint i)
void setChunkData (uint i, const ByteVector &data)
void setChunkData (const ByteVector &name, const ByteVector &data)
void setChunkData (const ByteVector &name, const ByteVector &data, bool alwaysCreate)
void removeChunk (uint i)
void removeChunk (const ByteVector &name)

Detailed Description

An RIFF file class with some useful methods specific to RIFF.

This implements the generic TagLib::File API and additionally provides access to properties that are distinct to RIFF files, notably access to the different ID3 tags.


Member Enumeration Documentation

Enumerator:
BigEndian 
LittleEndian 

Constructor & Destructor Documentation

virtual TagLib::RIFF::File::~File ( ) [virtual]

Destroys this instance of the File.

Reimplemented from TagLib::File.

Reimplemented in TagLib::RIFF::AIFF::File, and TagLib::RIFF::WAV::File.

TagLib::RIFF::File::File ( FileName  file,
Endianness  endianness 
) [protected]
TagLib::RIFF::File::File ( IOStream stream,
Endianness  endianness 
) [protected]

Member Function Documentation

uint TagLib::RIFF::File::chunkCount ( ) const [protected]
Returns:
The number of chunks in the file.
ByteVector TagLib::RIFF::File::chunkData ( uint  i) [protected]

Reads the chunk data from the file and returns it.

Note:
This will move the read pointer for the file.
uint TagLib::RIFF::File::chunkDataSize ( uint  i) const [protected]
Returns:
The size of the chunk data.
ByteVector TagLib::RIFF::File::chunkName ( uint  i) const [protected]
Returns:
The name of the specified chunk, for instance, "COMM" or "ID3 "
uint TagLib::RIFF::File::chunkOffset ( uint  i) const [protected]
Returns:
The offset within the file for the selected chunk number.
uint TagLib::RIFF::File::chunkPadding ( uint  i) const [protected]
Returns:
The size of the padding after the chunk (can be either 0 or 1).
void TagLib::RIFF::File::removeChunk ( uint  i) [protected]

Removes the specified chunk.

Warning:
This will update the file immediately.
void TagLib::RIFF::File::removeChunk ( const ByteVector name) [protected]

Removes the chunk name.

Warning:
This will update the file immediately.
This removes all the chunks with the given name.
uint TagLib::RIFF::File::riffSize ( ) const [protected]
Returns:
The size of the main RIFF chunk.
void TagLib::RIFF::File::setChunkData ( const ByteVector name,
const ByteVector data 
) [protected]

Sets the data for the chunk name to data. If a chunk with the given name already exists it will be overwritten, otherwise it will be created after the existing chunks.

Warning:
This will update the file immediately.
void TagLib::RIFF::File::setChunkData ( const ByteVector name,
const ByteVector data,
bool  alwaysCreate 
) [protected]

Sets the data for the chunk name to data. If a chunk with the given name already exists it will be overwritten, otherwise it will be created after the existing chunks.

Note:
If alwaysCreate is true, a new chunk is created regardless of whether or not the chunk name exists. It should only be used for "LIST" chunks.
Warning:
This will update the file immediately.
void TagLib::RIFF::File::setChunkData ( uint  i,
const ByteVector data 
) [protected]

Sets the data for the specified chunk to data.

Warning:
This will update the file immediately.

The documentation for this class was generated from the following file: