apeitem.h
Go to the documentation of this file.
1/***************************************************************************
2 copyright : (C) 2004 by Allan Sandfeld Jensen
3 email : kde@carewolf.org
4 ***************************************************************************/
5
6/***************************************************************************
7 * This library is free software; you can redistribute it and/or modify *
8 * it under the terms of the GNU Lesser General Public License version *
9 * 2.1 as published by the Free Software Foundation. *
10 * *
11 * This library is distributed in the hope that it will be useful, but *
12 * WITHOUT ANY WARRANTY; without even the implied warranty of *
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU *
14 * Lesser General Public License for more details. *
15 * *
16 * You should have received a copy of the GNU Lesser General Public *
17 * License along with this library; if not, write to the Free Software *
18 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA *
19 * 02110-1301 USA *
20 * *
21 * Alternatively, this file is available under the Mozilla Public *
22 * License Version 1.1. You may obtain a copy of the License at *
23 * http://www.mozilla.org/MPL/ *
24 ***************************************************************************/
25
26#ifndef TAGLIB_APEITEM_H
27#define TAGLIB_APEITEM_H
28
29#include "tbytevector.h"
30#include "tstring.h"
31#include "tstringlist.h"
32
33namespace TagLib {
34
35 namespace APE {
36
38
43 {
44 public:
48 enum ItemTypes {
50 Text = 0,
52 Binary = 1,
54 Locator = 2
55 };
60
64 // BIC: Remove this, StringList has a constructor from a single string
65 Item(const String &key, const String &value);
66
70 Item(const String &key, const StringList &values);
71
76 Item(const String &key, const ByteVector &value, bool binary);
77
81 Item(const Item &item);
82
86 virtual ~Item();
87
91 Item &operator=(const Item &item);
92
96 void swap(Item &item);
97
101 String key() const;
102
108
113 void setBinaryData(const ByteVector &value);
114
115#ifndef DO_NOT_DOCUMENT
116 /* Remove in next binary incompatible release */
117 ByteVector value() const;
118#endif
119
123 void setKey(const String &key);
124
130 void setValue(const String &value);
131
138 void setValues(const StringList &values);
139
145 void appendValue(const String &value);
146
152 void appendValues(const StringList &values);
153
157 int size() const;
158
165
166#ifndef DO_NOT_DOCUMENT
167 /* Remove in next binary incompatible release */
168 StringList toStringList() const;
169#endif
170
176
181
185 void parse(const ByteVector& data);
186
190 void setReadOnly(bool readOnly);
191
195 bool isReadOnly() const;
196
202 void setType(ItemTypes type);
203
208
212 bool isEmpty() const;
213
214 private:
215 class ItemPrivate;
216 ItemPrivate *d;
217 };
218 }
219
220}
221
222#endif
223
224
An implementation of APE-items.
Definition: apeitem.h:43
Item(const String &key, const StringList &values)
bool isReadOnly() const
String key() const
String toString() const
void setReadOnly(bool readOnly)
Item & operator=(const Item &item)
void setType(ItemTypes type)
ItemTypes
Definition: apeitem.h:48
int size() const
ByteVector render() const
ItemTypes type() const
void setKey(const String &key)
Item(const String &key, const String &value)
bool isEmpty() const
void swap(Item &item)
StringList values() const
Item(const String &key, const ByteVector &value, bool binary)
void appendValues(const StringList &values)
void setValues(const StringList &values)
void appendValue(const String &value)
void parse(const ByteVector &data)
void setBinaryData(const ByteVector &value)
ByteVector binaryData() const
void setValue(const String &value)
Item(const Item &item)
A byte vector.
Definition: tbytevector.h:46
A list of strings.
Definition: tstringlist.h:46
A wide string class suitable for unicode.
Definition: tstring.h:85
A namespace for all TagLib related classes and functions.
Definition: apefile.h:41
#define TAGLIB_EXPORT
Definition: taglib_export.h:40