TagLib 1.5 (TagLib: TagLib::APE::Item Class Reference)

TagLib::APE::Item Class Reference

An implementation of APE-items. More...

#include <apeitem.h>

List of all members.

Public Types

enum  ItemTypes { Text = 0, Binary = 1, Locator = 2 }

Public Member Functions

 Item ()
 Item (const String &key, const String &value)
 Item (const String &key, const StringList &values)
 Item (const Item &item)
virtual ~Item ()
Itemoperator= (const Item &item)
String key () const
ByteVector value () const
void setKey (const String &key)
void setValue (const String &value)
void setValues (const StringList &values)
void appendValue (const String &value)
void appendValues (const StringList &values)
int size () const
String toString () const
StringList toStringList () const
StringList values () const
ByteVector render () const
void parse (const ByteVector &data)
void setReadOnly (bool readOnly)
bool isReadOnly () const
void setType (ItemTypes type)
ItemTypes type () const
bool isEmpty () const


Detailed Description

An implementation of APE-items.

This class provides the features of items in the APEv2 standard.


Member Enumeration Documentation

enum TagLib::APE::Item::ItemTypes
 

Enum of types an Item can have. The value of 3 is reserved.

Enumeration values:
Text  Item contains text information coded in UTF-8.
Binary  Item contains binary information.
Locator  Item is a locator of external stored information.


Constructor & Destructor Documentation

TagLib::APE::Item::Item  ) 
 

Constructs an empty item.

TagLib::APE::Item::Item const String key,
const String value
 

Constructs an item with key and value.

TagLib::APE::Item::Item const String key,
const StringList values
 

Constructs an item with key and values.

TagLib::APE::Item::Item const Item item  ) 
 

Construct an item as a copy of item.

virtual TagLib::APE::Item::~Item  )  [virtual]
 

Destroys the item.


Member Function Documentation

void TagLib::APE::Item::appendValue const String value  ) 
 

Appends value to create (or extend) the current list of values.

See also:
toString()

void TagLib::APE::Item::appendValues const StringList values  ) 
 

Appends values to extend the current list of values.

See also:
toStringList()

bool TagLib::APE::Item::isEmpty  )  const
 

Returns if the item has any real content.

bool TagLib::APE::Item::isReadOnly  )  const
 

Return true if the item is read-only.

String TagLib::APE::Item::key  )  const
 

Returns the key.

Item& TagLib::APE::Item::operator= const Item item  ) 
 

Copies the contents of item into this item.

void TagLib::APE::Item::parse const ByteVector data  ) 
 

Parse the item from the ByteVector data.

ByteVector TagLib::APE::Item::render  )  const
 

Render the item to a ByteVector.

void TagLib::APE::Item::setKey const String key  ) 
 

Sets the key for the item to key.

void TagLib::APE::Item::setReadOnly bool  readOnly  ) 
 

Set the item to read-only.

void TagLib::APE::Item::setType ItemTypes  type  ) 
 

Sets the type of the item to type.

See also:
ItemTypes

void TagLib::APE::Item::setValue const String value  ) 
 

Sets the value of the item to value and clears any previous contents.

See also:
toString()

void TagLib::APE::Item::setValues const StringList values  ) 
 

Sets the value of the item to the list of values in value and clears any previous contents.

See also:
toStringList()

int TagLib::APE::Item::size  )  const
 

Returns the size of the full item.

String TagLib::APE::Item::toString  )  const
 

Returns the value as a single string. In case of multiple strings, the first is returned.

StringList TagLib::APE::Item::toStringList  )  const
 

See also:
values

ItemTypes TagLib::APE::Item::type  )  const
 

Returns the type of the item.

ByteVector TagLib::APE::Item::value  )  const
 

Returns the binary value.

StringList TagLib::APE::Item::values  )  const
 

Returns the list of values.


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