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
|
/*
Copyright (C) 2002 Rik Hemsley (rikkus) <rik@kde.org>
Copyright (C) 2002 Benjamin Meyer <ben-devel@meyerhome.net>
Copyright (C) 2002-2004 Nadeem Hasan <nhasan@nadmm.com>
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; see the file COPYING.LIB. If not, write to
the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
Boston, MA 02110-1301, USA.
*/
#ifndef KCDDB_CDINFO_H
#define KCDDB_CDINFO_H
#include <tqstringlist.h>
#include <tqvaluelist.h>
#include <kdemacros.h>
#include <tqvariant.h>
namespace KCDDB
{
/**
* Information about a sepecific track in a cd.
*/
class KDE_EXPORT TrackInfo
{
public:
TrackInfo();
~TrackInfo();
TrackInfo(const TrackInfo& clone);
TrackInfo& operator=(const TrackInfo& clone);
/**
* Get data for type that has been assigned to this track.
* @p type is case insensitive.
* For example <code>get("title")</code>
*/
TQVariant get(const TQString &type) const;
#ifndef KDE_NO_COMPAT
// Use get("title");
TQString title;
// Use get("extt");
TQString extt;
#endif
};
typedef TQValueList<TrackInfo> TrackInfoList;
/**
* Information about a CD
*
* Typically CDInfo is obtained from the client such as:
* <code>KCDDB::Client *cddb = new KCDDB::Client();
* cddb->lookup(discSignature);
* CDInfo info = cddb->bestLookupResponse();</code>
*/
class KDE_EXPORT CDInfo
{
public:
CDInfo();
~CDInfo();
CDInfo(const CDInfo& clone);
CDInfo& operator=(const CDInfo& clone);
/**
* Load CDInfo from a string that is CDDB compatible
* @return true if successful
*/
bool load(const TQString &);
/**
* Load CDInfo from a stringList that is CDDB compatible
* @return true if successful
*/
bool load(const TQStringList &);
/**
* Clear all information, setting this to invalid
* internal
*/
void clear();
/**
* @return true if the cd information is valid
*/
bool isValid() const;
/**
* @param submit If submit is true only returns CDDB compatible information
* @return a string containing all of the CD's information.
*/
TQString toString(bool submit=false) const;
/**
* Get data for type that has been assigned to this disc.
* @p type is case insensitive.
* For example <code>get("title")</code>
*/
TQVariant get(const TQString &type) const;
// Use get(...)
TQString id;
TQString artist;
TQString title;
TQString genre;
TQString category;
TQString extd;
uint year;
uint length; // in milliseconds
uint revision;
TrackInfoList trackInfoList;
protected:
/**
* @returns a valid CDDB line made up of name and value
*/
TQString createLine(const TQString& name, const TQString& value) const;
/**
* Checks to make sure that trackNumber exists
*/
void checkTrack( uint );
/**
* escape's string for CDDB processing
*/
static TQString escape( const TQString & );
/**
* fixes an escaped string that has been CDDB processed
*/
static TQString unescape( const TQString & );
};
typedef TQValueList<CDInfo> CDInfoList;
}
#endif // KCDDB_CDINFO_H
// vim:tabstop=2:shiftwidth=2:expandtab:cinoptions=(s,U1,m1
|
