![]() |
|
#include <tlist.h>
Inheritance diagram for TagLib::List< T >:
Public Member Functions | |
List () | |
List (const List< T > &l) | |
virtual | ~List () |
Iterator | begin () |
ConstIterator | begin () const |
Iterator | end () |
ConstIterator | end () const |
void | insert (Iterator it, const T &value) |
void | sortedInsert (const T &value, bool unique=false) |
List< T > & | append (const T &item) |
List< T > & | append (const List< T > &l) |
List< T > & | prepend (const T &item) |
List< T > & | prepend (const List< T > &l) |
void | clear () |
uint | size () const |
bool | isEmpty () const |
Iterator | find (const T &value) |
ConstIterator | find (const T &value) const |
bool | contains (const T &value) const |
void | erase (Iterator it) |
const T & | front () const |
T & | front () |
const T & | back () const |
T & | back () |
void | setAutoDelete (bool autoDelete) |
T & | operator[] (uint i) |
const T & | operator[] (uint i) const |
List< T > & | operator= (const List< T > &l) |
bool | operator== (const List< T > &l) const |
Protected Member Functions | |
void | detach () |
This is basic generic list that's somewhere between a std::list and a QValueList. This class is implicitly shared. For example:
TagLib::List<int> l = someOtherIntList;
The above example is very cheap. This also makes lists suitable for the return types of functions. The above example will just copy a pointer rather than copying the data in the list. When your shared list's data changes, only then will the data be copied.
TagLib::List< T >::List | ( | ) |
Constructs an empty list.
TagLib::List< T >::List | ( | const List< T > & | l | ) |
Make a shallow, implicitly shared, copy of l. Because this is implicitly shared, this method is lightweight and suitable for pass-by-value usage.
virtual TagLib::List< T >::~List | ( | ) | [virtual] |
Destroys this List instance. If auto deletion is enabled and this list contains a pointer type all of the memebers are also deleted.
Iterator TagLib::List< T >::begin | ( | ) |
Returns an STL style iterator to the beginning of the list. See std::list::const_iterator for the semantics.
ConstIterator TagLib::List< T >::begin | ( | ) | const |
Returns an STL style constant iterator to the beginning of the list. See std::list::iterator for the semantics.
Iterator TagLib::List< T >::end | ( | ) |
Returns an STL style iterator to the end of the list. See std::list::iterator for the semantics.
ConstIterator TagLib::List< T >::end | ( | ) | const |
Returns an STL style constant iterator to the end of the list. See std::list::const_iterator for the semantics.
void TagLib::List< T >::insert | ( | Iterator | it, | |
const T & | value | |||
) |
Inserts a copy of value before it.
void TagLib::List< T >::sortedInsert | ( | const T & | value, | |
bool | unique = false | |||
) |
Inserts the value into the list. This assumes that the list is currently sorted. If unique is true then the value will not be inserted if it is already in the list.
List<T>& TagLib::List< T >::append | ( | const T & | item | ) |
Appends item to the end of the list and returns a reference to the list.
List<T>& TagLib::List< T >::append | ( | const List< T > & | l | ) |
Appends all of the values in l to the end of the list and returns a reference to the list.
List<T>& TagLib::List< T >::prepend | ( | const T & | item | ) |
Prepends item to the beginning list and returns a reference to the list.
List<T>& TagLib::List< T >::prepend | ( | const List< T > & | l | ) |
Prepends all of the items in l to the beginning list and returns a reference to the list.
void TagLib::List< T >::clear | ( | ) |
Clears the list. If auto deletion is enabled and this list contains a pointer type the members are also deleted.
uint TagLib::List< T >::size | ( | ) | const |
Returns the number of elements in the list.
bool TagLib::List< T >::isEmpty | ( | ) | const |
Iterator TagLib::List< T >::find | ( | const T & | value | ) |
Find the first occurance of value.
ConstIterator TagLib::List< T >::find | ( | const T & | value | ) | const |
Find the first occurance of value.
bool TagLib::List< T >::contains | ( | const T & | value | ) | const |
Returns true if the list contains value.
void TagLib::List< T >::erase | ( | Iterator | it | ) |
Erase the item at it from the list.
const T& TagLib::List< T >::front | ( | ) | const |
Returns a reference to the first item in the list.
T& TagLib::List< T >::front | ( | ) |
Returns a reference to the first item in the list.
const T& TagLib::List< T >::back | ( | ) | const |
Returns a reference to the last item in the list.
T& TagLib::List< T >::back | ( | ) |
Returns a reference to the last item in the list.
void TagLib::List< T >::setAutoDelete | ( | bool | autoDelete | ) |
Auto delete the members of the list when the last reference to the list passes out of scope. This will have no effect on lists which do not contain a pointer type.
T& TagLib::List< T >::operator[] | ( | uint | i | ) |
Returns a reference to item i in the list.
const T& TagLib::List< T >::operator[] | ( | uint | i | ) | const |
Returns a const reference to item i in the list.
List<T>& TagLib::List< T >::operator= | ( | const List< T > & | l | ) |
Make a shallow, implicitly shared, copy of l. Because this is implicitly shared, this method is lightweight and suitable for pass-by-value usage.
bool TagLib::List< T >::operator== | ( | const List< T > & | l | ) | const |
Compares this list with l and returns true if all of the elements are the same.
void TagLib::List< T >::detach | ( | ) | [protected] |