1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
|
// -*- C++ -*-
// $Id: field_impl.h,v 1.4 2002/06/29 14:43:00 t1mpy Exp $
// id3lib: a C++ library for creating and manipulating id3v1/v2 tags
// Copyright 1999, 2000 Scott Thomas Haug
// This library is free software; you can redistribute it and/or modify it
// under the terms of the GNU Library General Public License as published by
// the Free Software Foundation; either version 2 of the License, or (at your
// option) any later version.
//
// This library is distributed in the hope that it will be useful, but WITHOUT
// ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
// FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public
// License for more details.
//
// You should have received a copy of the GNU Library General Public License
// along with this library; if not, write to the Free Software Foundation,
// Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
// The id3lib authors encourage improvements and optimisations to be sent to
// the id3lib coordinator. Please see the README file for details on where to
// send such submissions. See the AUTHORS file for a list of people who have
// contributed to id3lib. See the ChangeLog file for a list of changes to
// id3lib. These files are distributed with id3lib at
// http://download.sourceforge.net/id3lib/
#ifndef _ID3LIB_FIELD_IMPL_H_
#define _ID3LIB_FIELD_IMPL_H_
#include <stdlib.h>
#include "field.h"
#include "id3/id3lib_strings.h"
struct ID3_FieldDef;
struct ID3_FrameDef;
class ID3_Frame;
class ID3_Reader;
class ID3_FieldImpl : public ID3_Field
{
friend class ID3_FrameImpl;
public:
~ID3_FieldImpl();
void Clear();
size_t Size() const;
size_t BinSize() const;
size_t GetNumTextItems() const;
// integer field functions
ID3_Field& operator= (uint32 val) { this->Set(val); return *this; }
void Set(uint32);
uint32 Get() const;
void SetInteger(uint32);
uint32 GetInteger() const;
// ASCII string field functions
ID3_Field& operator= (const char* s) { this->Set(s); return *this; }
size_t Set(const char* data);
size_t Get(char*, size_t) const;
size_t Get(char*, size_t, size_t) const;
const char* GetRawText() const;
const char* GetRawTextItem(size_t) const;
size_t Add(const char* data);
dami::String GetText() const;
dami::String GetTextItem(size_t) const;
size_t SetText(dami::String);
size_t AddText(dami::String);
// Unicode string field functions
ID3_Field& operator= (const unicode_t* s) { this->Set(s); return *this; }
size_t Set(const unicode_t*);
size_t Get(unicode_t *buffer, size_t) const;
size_t Get(unicode_t *buffer, size_t, size_t) const;
size_t Add(const unicode_t*);
const unicode_t* GetRawUnicodeText() const;
const unicode_t* GetRawUnicodeTextItem(size_t) const;
// binary field functions
size_t Set(const uchar* buf, size_t size);
size_t Set(const char* buf, size_t size)
{
return this->Set(reinterpret_cast<const uchar *>(buf), size);
}
size_t Get(uchar*, size_t) const;
const uchar* GetRawBinary() const;
void FromFile(const char*);
void ToFile(const char *sInfo) const;
size_t SetBinary(dami::BString);
dami::BString GetBinary() const;
// miscelaneous functions
ID3_Field& operator=( const ID3_Field & );
bool InScope(ID3_V2Spec spec) const
{ return _spec_begin <= spec && spec <= _spec_end; }
ID3_FieldID GetID() const { return _id; }
ID3_FieldType GetType() const { return _type; }
bool SetEncoding(ID3_TextEnc enc);
ID3_TextEnc GetEncoding() const { return _enc; }
bool IsEncodable() const { return (_flags & ID3FF_ENCODABLE) > 0; }
void Render(ID3_Writer&) const;
bool Parse(ID3_Reader&);
bool HasChanged() const;
private:
size_t SetText_i(dami::String);
size_t AddText_i(dami::String);
private:
// To prevent public instantiation, the constructor is made private
ID3_FieldImpl();
ID3_FieldImpl(const ID3_FieldDef&);
const ID3_FieldID _id; // the ID of this field
const ID3_FieldType _type; // what type is this field or should be
const ID3_V2Spec _spec_begin; // spec end
const ID3_V2Spec _spec_end; // spec begin
const flags_t _flags; // special field flags
mutable bool _changed; // field changed since last parse/render?
dami::BString _binary; // for binary strings
dami::String _text; // for ascii strings
uint32 _integer; // for numbers
const size_t _fixed_size; // for fixed length fields (0 if not)
size_t _num_items; // the number of items in the text string
ID3_TextEnc _enc; // encoding for text fields
protected:
void RenderInteger(ID3_Writer&) const;
void RenderText(ID3_Writer&) const;
void RenderBinary(ID3_Writer&) const;
bool ParseInteger(ID3_Reader&);
bool ParseText(ID3_Reader&);
bool ParseBinary(ID3_Reader&);
};
// Ack! Not for public use
ID3_FrameDef *ID3_FindFrameDef(ID3_FrameID id);
ID3_FrameID ID3_FindFrameID(const char *id);
#endif /* _ID3LIB_FIELD_H_ */
|