]> git.saurik.com Git - apt.git/blame - apt-pkg/cacheiterators.h
deprecate confusing Pkg.CandVersion() method
[apt.git] / apt-pkg / cacheiterators.h
CommitLineData
578bfd0a
AL
1// -*- mode: cpp; mode: fold -*-
2// Description /*{{{*/
578bfd0a
AL
3/* ######################################################################
4
5 Cache Iterators - Iterators for navigating the cache structure
6
7 The iterators all provides ++,==,!=,->,* and end for their type.
8 The end function can be used to tell if the list has been fully
9 traversed.
10
11 Unlike STL iterators these contain helper functions to access the data
12 that is being iterated over. This is because the data structures can't
13 be formed in a manner that is intuitive to use and also mmapable.
14
15 For each variable in the target structure that would need a translation
16 to be accessed correctly a translating function of the same name is
17 present in the iterator. If applicable the translating function will
18 return an iterator.
19
20 The DepIterator can iterate over two lists, a list of 'version depends'
21 or a list of 'package reverse depends'. The type is determined by the
22 structure passed to the constructor, which should be the structure
6c139d6e
AL
23 that has the depends pointer as a member. The provide iterator has the
24 same system.
578bfd0a 25
094a497d 26 This header is not user includable, please use apt-pkg/pkgcache.h
578bfd0a
AL
27
28 ##################################################################### */
29 /*}}}*/
578bfd0a
AL
30#ifndef PKGLIB_CACHEITERATORS_H
31#define PKGLIB_CACHEITERATORS_H
453b82a3 32#include<apt-pkg/pkgcache.h>
a02db58f 33#include<apt-pkg/macros.h>
453b82a3 34
b3fdb998 35#include<iterator>
453b82a3
DK
36#include <iosfwd>
37#include <string>
eff0c22e
JAK
38#ifdef APT_PKG_EXPOSE_STRING_VIEW
39#include <apt-pkg/string_view.h>
40#endif
8ceeb9d6
DK
41
42#include<string.h>
472ff00e 43
773e2c1f
DK
44// abstract Iterator template /*{{{*/
45/* This template provides the very basic iterator methods we
5bf15716 46 need to have for doing some walk-over-the-cache magic */
b3fdb998
DK
47template<typename Str, typename Itr> class pkgCache::Iterator :
48 public std::iterator<std::forward_iterator_tag, Str> {
773e2c1f
DK
49 /** \brief Returns the Pointer for this struct in the owner
50 * The implementation of this method should be pretty short
51 * as it will only return the Pointer into the mmap stored
52 * in the owner but the name of this pointer is different for
1e3f4083 53 * each structure and we want to abstract here at least for the
773e2c1f
DK
54 * basic methods from the actual structure.
55 * \return Pointer to the first structure of this type
56 */
3707fd4f
DK
57 Str* OwnerPointer() const { return static_cast<Itr const*>(this)->OwnerPointer(); }
58
59 protected:
60 Str *S;
61 pkgCache *Owner;
773e2c1f
DK
62
63 public:
64 // Iteration
d3e8fbb3 65 inline bool end() const {return Owner == 0 || S == OwnerPointer();}
773e2c1f
DK
66
67 // Comparison
d3e8fbb3
DK
68 inline bool operator ==(const Itr &B) const {return S == B.S;}
69 inline bool operator !=(const Itr &B) const {return S != B.S;}
773e2c1f
DK
70
71 // Accessors
d3e8fbb3
DK
72 inline Str *operator ->() {return S;}
73 inline Str const *operator ->() const {return S;}
74 inline operator Str *() {return S == OwnerPointer() ? 0 : S;}
75 inline operator Str const *() const {return S == OwnerPointer() ? 0 : S;}
76 inline Str &operator *() {return *S;}
77 inline Str const &operator *() const {return *S;}
78 inline pkgCache *Cache() const {return Owner;}
773e2c1f
DK
79
80 // Mixed stuff
d3e8fbb3
DK
81 inline bool IsGood() const { return S && Owner && ! end();}
82 inline unsigned long Index() const {return S - OwnerPointer();}
773e2c1f 83
f7a35f2e
DK
84 void ReMap(void const * const oldMap, void const * const newMap) {
85 if (Owner == 0 || S == 0)
a9fe5928 86 return;
cf4ff3b7 87 S += (Str const * const)(newMap) - (Str const * const)(oldMap);
a9fe5928
DK
88 }
89
773e2c1f 90 // Constructors - look out for the variable assigning
d3e8fbb3
DK
91 inline Iterator() : S(0), Owner(0) {}
92 inline Iterator(pkgCache &Owner,Str *T = 0) : S(T), Owner(&Owner) {}
5bf15716
DK
93};
94 /*}}}*/
95// Group Iterator /*{{{*/
96/* Packages with the same name are collected in a Group so someone only
97 interest in package names can iterate easily over the names, so the
98 different architectures can be treated as of the "same" package
99 (apt internally treat them as totally different packages) */
100class pkgCache::GrpIterator: public Iterator<Group, GrpIterator> {
25396fb0
DK
101 long HashIndex;
102
3707fd4f 103 public:
5bf15716 104 inline Group* OwnerPointer() const {
c55b8a54 105 return (Owner != 0) ? Owner->GrpP : 0;
d3e8fbb3 106 }
5bf15716 107
25396fb0 108 // This constructor is the 'begin' constructor, never use it.
e8afd168 109 explicit inline GrpIterator(pkgCache &Owner) : Iterator<Group, GrpIterator>(Owner), HashIndex(-1) {
25396fb0 110 S = OwnerPointer();
3707fd4f 111 operator++();
d3e8fbb3 112 }
25396fb0 113
3707fd4f
DK
114 GrpIterator& operator++();
115 inline GrpIterator operator++(int) { GrpIterator const tmp(*this); operator++(); return tmp; }
5bf15716 116
d3e8fbb3 117 inline const char *Name() const {return S->Name == 0?0:Owner->StrP + S->Name;}
5bf15716 118 inline PkgIterator PackageList() const;
8f3ba4e8 119 PkgIterator FindPkg(std::string Arch = "any") const;
eff0c22e
JAK
120#ifdef APT_PKG_EXPOSE_STRING_VIEW
121 APT_HIDDEN PkgIterator FindPkg(APT::StringView Arch = APT::StringView("any", 3)) const;
122 APT_HIDDEN PkgIterator FindPkg(const char *Arch) const;
123#endif
bd2fb30a
DK
124 /** \brief find the package with the "best" architecture
125
126 The best architecture is either the "native" or the first
3db58cf4
DK
127 in the list of Architectures which is not an end-Pointer
128
129 \param PreferNonVirtual tries to respond with a non-virtual package
130 and only if this fails returns the best virtual package */
131 PkgIterator FindPreferredPkg(bool const &PreferNonVirtual = true) const;
e841200b 132 PkgIterator NextPkg(PkgIterator const &Pkg) const;
5bf15716
DK
133
134 // Constructors
25396fb0 135 inline GrpIterator(pkgCache &Owner, Group *Trg) : Iterator<Group, GrpIterator>(Owner, Trg), HashIndex(0) {
5bf15716
DK
136 if (S == 0)
137 S = OwnerPointer();
d3e8fbb3
DK
138 }
139 inline GrpIterator() : Iterator<Group, GrpIterator>(), HashIndex(0) {}
5bf15716 140
773e2c1f
DK
141};
142 /*}}}*/
92fcbfc1 143// Package Iterator /*{{{*/
773e2c1f
DK
144class pkgCache::PkgIterator: public Iterator<Package, PkgIterator> {
145 long HashIndex;
146
3707fd4f 147 public:
773e2c1f 148 inline Package* OwnerPointer() const {
c55b8a54 149 return (Owner != 0) ? Owner->PkgP : 0;
d3e8fbb3 150 }
773e2c1f 151
773e2c1f 152 // This constructor is the 'begin' constructor, never use it.
e8afd168 153 explicit inline PkgIterator(pkgCache &Owner) : Iterator<Package, PkgIterator>(Owner), HashIndex(-1) {
773e2c1f 154 S = OwnerPointer();
3707fd4f 155 operator++();
d3e8fbb3 156 }
773e2c1f 157
3707fd4f
DK
158 PkgIterator& operator++();
159 inline PkgIterator operator++(int) { PkgIterator const tmp(*this); operator++(); return tmp; }
773e2c1f
DK
160
161 enum OkState {NeedsNothing,NeedsUnpack,NeedsConfigure};
162
163 // Accessors
fe86debb 164 inline const char *Name() const { return Group().Name(); }
7a669774 165 // Versions have sections - and packages can have different versions with different sections
50ef3344 166 // so this interface is broken by design. Run as fast as you can to Version.Section().
5dd00edb 167 APT_DEPRECATED_MSG("Use the .Section method of VerIterator instead") inline const char *Section() const;
773e2c1f 168 inline bool Purge() const {return S->CurrentState == pkgCache::State::Purge ||
d3e8fbb3
DK
169 (S->CurrentVer == 0 && S->CurrentState == pkgCache::State::NotInstalled);}
170 inline const char *Arch() const {return S->Arch == 0?0:Owner->StrP + S->Arch;}
a02db58f 171 inline APT_PURE GrpIterator Group() const { return GrpIterator(*Owner, Owner->GrpP + S->Group);}
773e2c1f 172
a02db58f
DK
173 inline VerIterator VersionList() const APT_PURE;
174 inline VerIterator CurrentVer() const APT_PURE;
175 inline DepIterator RevDependsList() const APT_PURE;
176 inline PrvIterator ProvidesList() const APT_PURE;
177 OkState State() const APT_PURE;
29636cc7 178 APT_DEPRECATED_MSG("This method does not respect apt_preferences! Use pkgDepCache::GetCandidateVersion(Pkg)") const char *CandVersion() const APT_PURE;
a02db58f 179 const char *CurVersion() const APT_PURE;
773e2c1f
DK
180
181 //Nice printable representation
182 friend std::ostream& operator <<(std::ostream& out, PkgIterator i);
75ce2062 183 std::string FullName(bool const &Pretty = false) const;
773e2c1f
DK
184
185 // Constructors
186 inline PkgIterator(pkgCache &Owner,Package *Trg) : Iterator<Package, PkgIterator>(Owner, Trg), HashIndex(0) {
187 if (S == 0)
188 S = OwnerPointer();
d3e8fbb3
DK
189 }
190 inline PkgIterator() : Iterator<Package, PkgIterator>(), HashIndex(0) {}
578bfd0a 191};
92fcbfc1
DK
192 /*}}}*/
193// Version Iterator /*{{{*/
773e2c1f 194class pkgCache::VerIterator : public Iterator<Version, VerIterator> {
3707fd4f 195 public:
773e2c1f 196 inline Version* OwnerPointer() const {
c55b8a54 197 return (Owner != 0) ? Owner->VerP : 0;
d3e8fbb3 198 }
773e2c1f 199
773e2c1f 200 // Iteration
3707fd4f
DK
201 inline VerIterator& operator++() {if (S != Owner->VerP) S = Owner->VerP + S->NextVer; return *this;}
202 inline VerIterator operator++(int) { VerIterator const tmp(*this); operator++(); return tmp; }
773e2c1f
DK
203
204 // Comparison
205 int CompareVer(const VerIterator &B) const;
8ceeb9d6
DK
206 /** \brief compares two version and returns if they are similar
207
208 This method should be used to identify if two pseudo versions are
1e3f4083 209 referring to the same "real" version */
8ceeb9d6
DK
210 inline bool SimilarVer(const VerIterator &B) const {
211 return (B.end() == false && S->Hash == B->Hash && strcmp(VerStr(), B.VerStr()) == 0);
d3e8fbb3 212 }
773e2c1f
DK
213
214 // Accessors
d3e8fbb3
DK
215 inline const char *VerStr() const {return S->VerStr == 0?0:Owner->StrP + S->VerStr;}
216 inline const char *Section() const {return S->Section == 0?0:Owner->StrP + S->Section;}
a221efc3
DK
217 /** \brief source package name this version comes from
218 Always contains the name, even if it is the same as the binary name */
219 inline const char *SourcePkgName() const {return Owner->StrP + S->SourcePkgName;}
220 /** \brief source version this version comes from
221 Always contains the version string, even if it is the same as the binary version */
222 inline const char *SourceVerStr() const {return Owner->StrP + S->SourceVerStr;}
c5dac10c 223 inline const char *Arch() const {
2a2a7ef4 224 if ((S->MultiArch & pkgCache::Version::All) == pkgCache::Version::All)
ca238ede 225 return "all";
c5dac10c 226 return S->ParentPkg == 0?0:Owner->StrP + ParentPkg()->Arch;
d3e8fbb3
DK
227 }
228 inline PkgIterator ParentPkg() const {return PkgIterator(*Owner,Owner->PkgP + S->ParentPkg);}
773e2c1f
DK
229
230 inline DescIterator DescriptionList() const;
231 DescIterator TranslatedDescription() const;
232 inline DepIterator DependsList() const;
233 inline PrvIterator ProvidesList() const;
234 inline VerFileIterator FileList() const;
235 bool Downloadable() const;
d3e8fbb3 236 inline const char *PriorityType() const {return Owner->Priority(S->Priority);}
a02db58f 237 const char *MultiArchType() const APT_PURE;
8f3ba4e8 238 std::string RelStr() const;
773e2c1f
DK
239
240 bool Automatic() const;
241 VerFileIterator NewestFile() const;
242
243 inline VerIterator(pkgCache &Owner,Version *Trg = 0) : Iterator<Version, VerIterator>(Owner, Trg) {
244 if (S == 0)
245 S = OwnerPointer();
d3e8fbb3
DK
246 }
247 inline VerIterator() : Iterator<Version, VerIterator>() {}
578bfd0a 248};
92fcbfc1
DK
249 /*}}}*/
250// Description Iterator /*{{{*/
773e2c1f 251class pkgCache::DescIterator : public Iterator<Description, DescIterator> {
3707fd4f 252 public:
773e2c1f 253 inline Description* OwnerPointer() const {
c55b8a54 254 return (Owner != 0) ? Owner->DescP : 0;
d3e8fbb3 255 }
773e2c1f 256
773e2c1f 257 // Iteration
3707fd4f
DK
258 inline DescIterator& operator++() {if (S != Owner->DescP) S = Owner->DescP + S->NextDesc; return *this;}
259 inline DescIterator operator++(int) { DescIterator const tmp(*this); operator++(); return tmp; }
773e2c1f
DK
260
261 // Comparison
262 int CompareDesc(const DescIterator &B) const;
263
264 // Accessors
d3e8fbb3
DK
265 inline const char *LanguageCode() const {return Owner->StrP + S->language_code;}
266 inline const char *md5() const {return Owner->StrP + S->md5sum;}
773e2c1f
DK
267 inline DescFileIterator FileList() const;
268
d3e8fbb3 269 inline DescIterator() : Iterator<Description, DescIterator>() {}
773e2c1f
DK
270 inline DescIterator(pkgCache &Owner,Description *Trg = 0) : Iterator<Description, DescIterator>(Owner, Trg) {
271 if (S == 0)
272 S = Owner.DescP;
d3e8fbb3 273 }
a52f938b 274};
92fcbfc1
DK
275 /*}}}*/
276// Dependency iterator /*{{{*/
773e2c1f
DK
277class pkgCache::DepIterator : public Iterator<Dependency, DepIterator> {
278 enum {DepVer, DepRev} Type;
71c9e95b 279 DependencyData * S2;
773e2c1f 280
3707fd4f 281 public:
773e2c1f 282 inline Dependency* OwnerPointer() const {
c55b8a54 283 return (Owner != 0) ? Owner->DepP : 0;
d3e8fbb3 284 }
773e2c1f 285
773e2c1f 286 // Iteration
71c9e95b 287 DepIterator& operator++();
3707fd4f 288 inline DepIterator operator++(int) { DepIterator const tmp(*this); operator++(); return tmp; }
773e2c1f
DK
289
290 // Accessors
71c9e95b
DK
291 inline const char *TargetVer() const {return S2->Version == 0?0:Owner->StrP + S2->Version;}
292 inline PkgIterator TargetPkg() const {return PkgIterator(*Owner,Owner->PkgP + S2->Package);}
d3e8fbb3
DK
293 inline PkgIterator SmartTargetPkg() const {PkgIterator R(*Owner,0);SmartTargetPkg(R);return R;}
294 inline VerIterator ParentVer() const {return VerIterator(*Owner,Owner->VerP + S->ParentVer);}
295 inline PkgIterator ParentPkg() const {return PkgIterator(*Owner,Owner->PkgP + Owner->VerP[S->ParentVer].ParentPkg);}
296 inline bool Reverse() const {return Type == DepRev;}
a02db58f
DK
297 bool IsCritical() const APT_PURE;
298 bool IsNegative() const APT_PURE;
299 bool IsIgnorable(PrvIterator const &Prv) const APT_PURE;
300 bool IsIgnorable(PkgIterator const &Pkg) const APT_PURE;
8c7af4d4
DK
301 /* MultiArch can be translated to SingleArch for an resolver and we did so,
302 by adding dependencies to help the resolver understand the problem, but
303 sometimes it is needed to identify these to ignore them… */
304 inline bool IsMultiArchImplicit() const APT_PURE {
305 return (S2->CompareOp & pkgCache::Dep::MultiArchImplicit) == pkgCache::Dep::MultiArchImplicit;
306 }
307 /* This covers additionally negative dependencies, which aren't arch-specific,
3a8776a3 308 but change architecture nonetheless as a Conflicts: foo does applies for all archs */
8c7af4d4
DK
309 bool IsImplicit() const APT_PURE;
310
a02db58f
DK
311 bool IsSatisfied(VerIterator const &Ver) const APT_PURE;
312 bool IsSatisfied(PrvIterator const &Prv) const APT_PURE;
773e2c1f 313 void GlobOr(DepIterator &Start,DepIterator &End);
e841200b
DK
314 Version **AllTargets() const;
315 bool SmartTargetPkg(PkgIterator &Result) const;
71c9e95b
DK
316 inline const char *CompType() const {return Owner->CompType(S2->CompareOp);}
317 inline const char *DepType() const {return Owner->DepType(S2->Type);}
318
319 // overrides because we are special
320 struct DependencyProxy
321 {
322 map_stringitem_t &Version;
323 map_pointer_t &Package;
4dc77823 324 map_id_t &ID;
71c9e95b
DK
325 unsigned char &Type;
326 unsigned char &CompareOp;
327 map_pointer_t &ParentVer;
328 map_pointer_t &DependencyData;
329 map_pointer_t &NextRevDepends;
330 map_pointer_t &NextDepends;
b291aa59 331 map_pointer_t &NextData;
71c9e95b
DK
332 DependencyProxy const * operator->() const { return this; }
333 DependencyProxy * operator->() { return this; }
334 };
350d30d2
JAK
335 inline DependencyProxy operator->() const {return (DependencyProxy) { S2->Version, S2->Package, S->ID, S2->Type, S2->CompareOp, S->ParentVer, S->DependencyData, S->NextRevDepends, S->NextDepends, S2->NextData };}
336 inline DependencyProxy operator->() {return (DependencyProxy) { S2->Version, S2->Package, S->ID, S2->Type, S2->CompareOp, S->ParentVer, S->DependencyData, S->NextRevDepends, S->NextDepends, S2->NextData };}
71c9e95b
DK
337 void ReMap(void const * const oldMap, void const * const newMap)
338 {
339 Iterator<Dependency, DepIterator>::ReMap(oldMap, newMap);
340 if (Owner == 0 || S == 0 || S2 == 0)
341 return;
342 S2 += (DependencyData const * const)(newMap) - (DependencyData const * const)(oldMap);
343 }
773e2c1f 344
47f6d1b7
DK
345 //Nice printable representation
346 friend std::ostream& operator <<(std::ostream& out, DepIterator D);
347
773e2c1f 348 inline DepIterator(pkgCache &Owner, Dependency *Trg, Version* = 0) :
71c9e95b 349 Iterator<Dependency, DepIterator>(Owner, Trg), Type(DepVer), S2(Trg == 0 ? Owner.DepDataP : (Owner.DepDataP + Trg->DependencyData)) {
773e2c1f
DK
350 if (S == 0)
351 S = Owner.DepP;
d3e8fbb3 352 }
773e2c1f 353 inline DepIterator(pkgCache &Owner, Dependency *Trg, Package*) :
71c9e95b 354 Iterator<Dependency, DepIterator>(Owner, Trg), Type(DepRev), S2(Trg == 0 ? Owner.DepDataP : (Owner.DepDataP + Trg->DependencyData)) {
773e2c1f
DK
355 if (S == 0)
356 S = Owner.DepP;
d3e8fbb3 357 }
71c9e95b 358 inline DepIterator() : Iterator<Dependency, DepIterator>(), Type(DepVer), S2(0) {}
578bfd0a 359};
92fcbfc1
DK
360 /*}}}*/
361// Provides iterator /*{{{*/
773e2c1f
DK
362class pkgCache::PrvIterator : public Iterator<Provides, PrvIterator> {
363 enum {PrvVer, PrvPkg} Type;
364
3707fd4f 365 public:
773e2c1f 366 inline Provides* OwnerPointer() const {
c55b8a54 367 return (Owner != 0) ? Owner->ProvideP : 0;
d3e8fbb3 368 }
773e2c1f 369
773e2c1f 370 // Iteration
3707fd4f
DK
371 inline PrvIterator& operator ++() {if (S != Owner->ProvideP) S = Owner->ProvideP +
372 (Type == PrvVer?S->NextPkgProv:S->NextProvides); return *this;}
373 inline PrvIterator operator++(int) { PrvIterator const tmp(*this); operator++(); return tmp; }
773e2c1f
DK
374
375 // Accessors
fe86debb 376 inline const char *Name() const {return ParentPkg().Name();}
d3e8fbb3
DK
377 inline const char *ProvideVersion() const {return S->ProvideVersion == 0?0:Owner->StrP + S->ProvideVersion;}
378 inline PkgIterator ParentPkg() const {return PkgIterator(*Owner,Owner->PkgP + S->ParentPkg);}
379 inline VerIterator OwnerVer() const {return VerIterator(*Owner,Owner->VerP + S->Version);}
380 inline PkgIterator OwnerPkg() const {return PkgIterator(*Owner,Owner->PkgP + Owner->VerP[S->Version].ParentPkg);}
773e2c1f 381
8c7af4d4
DK
382 /* MultiArch can be translated to SingleArch for an resolver and we did so,
383 by adding provides to help the resolver understand the problem, but
384 sometimes it is needed to identify these to ignore them… */
385 bool IsMultiArchImplicit() const APT_PURE
386 { return (S->Flags & pkgCache::Flag::MultiArchImplicit) == pkgCache::Flag::MultiArchImplicit; }
387
773e2c1f 388
d3e8fbb3 389 inline PrvIterator() : Iterator<Provides, PrvIterator>(), Type(PrvVer) {}
773e2c1f
DK
390 inline PrvIterator(pkgCache &Owner, Provides *Trg, Version*) :
391 Iterator<Provides, PrvIterator>(Owner, Trg), Type(PrvVer) {
392 if (S == 0)
393 S = Owner.ProvideP;
d3e8fbb3 394 }
773e2c1f
DK
395 inline PrvIterator(pkgCache &Owner, Provides *Trg, Package*) :
396 Iterator<Provides, PrvIterator>(Owner, Trg), Type(PrvPkg) {
397 if (S == 0)
398 S = Owner.ProvideP;
d3e8fbb3 399 }
578bfd0a 400};
92fcbfc1 401 /*}}}*/
b07aeb1a
DK
402// Release file /*{{{*/
403class pkgCache::RlsFileIterator : public Iterator<ReleaseFile, RlsFileIterator> {
3707fd4f 404 public:
b07aeb1a
DK
405 inline ReleaseFile* OwnerPointer() const {
406 return (Owner != 0) ? Owner->RlsFileP : 0;
d3e8fbb3 407 }
773e2c1f 408
773e2c1f 409 // Iteration
3707fd4f
DK
410 inline RlsFileIterator& operator++() {if (S != Owner->RlsFileP) S = Owner->RlsFileP + S->NextFile;return *this;}
411 inline RlsFileIterator operator++(int) { RlsFileIterator const tmp(*this); operator++(); return tmp; }
773e2c1f
DK
412
413 // Accessors
d3e8fbb3
DK
414 inline const char *FileName() const {return S->FileName == 0?0:Owner->StrP + S->FileName;}
415 inline const char *Archive() const {return S->Archive == 0?0:Owner->StrP + S->Archive;}
d3e8fbb3
DK
416 inline const char *Version() const {return S->Version == 0?0:Owner->StrP + S->Version;}
417 inline const char *Origin() const {return S->Origin == 0?0:Owner->StrP + S->Origin;}
418 inline const char *Codename() const {return S->Codename ==0?0:Owner->StrP + S->Codename;}
419 inline const char *Label() const {return S->Label == 0?0:Owner->StrP + S->Label;}
420 inline const char *Site() const {return S->Site == 0?0:Owner->StrP + S->Site;}
b07aeb1a
DK
421 inline bool Flagged(pkgCache::Flag::ReleaseFileFlags const flag) const {return (S->Flags & flag) == flag; }
422
423 bool IsOk();
424 std::string RelStr();
425
426 // Constructors
427 inline RlsFileIterator() : Iterator<ReleaseFile, RlsFileIterator>() {}
e8afd168 428 explicit inline RlsFileIterator(pkgCache &Owner) : Iterator<ReleaseFile, RlsFileIterator>(Owner, Owner.RlsFileP) {}
b07aeb1a
DK
429 inline RlsFileIterator(pkgCache &Owner,ReleaseFile *Trg) : Iterator<ReleaseFile, RlsFileIterator>(Owner, Trg) {}
430};
431 /*}}}*/
432// Package file /*{{{*/
433class pkgCache::PkgFileIterator : public Iterator<PackageFile, PkgFileIterator> {
3707fd4f 434 public:
b07aeb1a
DK
435 inline PackageFile* OwnerPointer() const {
436 return (Owner != 0) ? Owner->PkgFileP : 0;
437 }
438
b07aeb1a 439 // Iteration
3707fd4f
DK
440 inline PkgFileIterator& operator++() {if (S != Owner->PkgFileP) S = Owner->PkgFileP + S->NextFile; return *this;}
441 inline PkgFileIterator operator++(int) { PkgFileIterator const tmp(*this); operator++(); return tmp; }
b07aeb1a
DK
442
443 // Accessors
444 inline const char *FileName() const {return S->FileName == 0?0:Owner->StrP + S->FileName;}
445 inline pkgCache::RlsFileIterator ReleaseFile() const {return RlsFileIterator(*Owner, Owner->RlsFileP + S->Release);}
446 inline const char *Archive() const {return S->Release == 0 ? Component() : ReleaseFile().Archive();}
447 inline const char *Version() const {return S->Release == 0 ? NULL : ReleaseFile().Version();}
448 inline const char *Origin() const {return S->Release == 0 ? NULL : ReleaseFile().Origin();}
449 inline const char *Codename() const {return S->Release == 0 ? NULL : ReleaseFile().Codename();}
450 inline const char *Label() const {return S->Release == 0 ? NULL : ReleaseFile().Label();}
451 inline const char *Site() const {return S->Release == 0 ? NULL : ReleaseFile().Site();}
452 inline bool Flagged(pkgCache::Flag::ReleaseFileFlags const flag) const {return S->Release== 0 ? false : ReleaseFile().Flagged(flag);}
453 inline bool Flagged(pkgCache::Flag::PkgFFlags const flag) const {return (S->Flags & flag) == flag;}
454 inline const char *Component() const {return S->Component == 0?0:Owner->StrP + S->Component;}
d3e8fbb3
DK
455 inline const char *Architecture() const {return S->Architecture == 0?0:Owner->StrP + S->Architecture;}
456 inline const char *IndexType() const {return S->IndexType == 0?0:Owner->StrP + S->IndexType;}
773e2c1f
DK
457
458 bool IsOk();
8f3ba4e8 459 std::string RelStr();
773e2c1f
DK
460
461 // Constructors
d3e8fbb3 462 inline PkgFileIterator() : Iterator<PackageFile, PkgFileIterator>() {}
e8afd168 463 explicit inline PkgFileIterator(pkgCache &Owner) : Iterator<PackageFile, PkgFileIterator>(Owner, Owner.PkgFileP) {}
d3e8fbb3 464 inline PkgFileIterator(pkgCache &Owner,PackageFile *Trg) : Iterator<PackageFile, PkgFileIterator>(Owner, Trg) {}
578bfd0a 465};
92fcbfc1
DK
466 /*}}}*/
467// Version File /*{{{*/
773e2c1f 468class pkgCache::VerFileIterator : public pkgCache::Iterator<VerFile, VerFileIterator> {
3707fd4f 469 public:
773e2c1f 470 inline VerFile* OwnerPointer() const {
c55b8a54 471 return (Owner != 0) ? Owner->VerFileP : 0;
d3e8fbb3 472 }
773e2c1f 473
773e2c1f 474 // Iteration
3707fd4f
DK
475 inline VerFileIterator& operator++() {if (S != Owner->VerFileP) S = Owner->VerFileP + S->NextFile; return *this;}
476 inline VerFileIterator operator++(int) { VerFileIterator const tmp(*this); operator++(); return tmp; }
773e2c1f
DK
477
478 // Accessors
d3e8fbb3 479 inline PkgFileIterator File() const {return PkgFileIterator(*Owner,S->File + Owner->PkgFileP);}
773e2c1f 480
d3e8fbb3
DK
481 inline VerFileIterator() : Iterator<VerFile, VerFileIterator>() {}
482 inline VerFileIterator(pkgCache &Owner,VerFile *Trg) : Iterator<VerFile, VerFileIterator>(Owner, Trg) {}
dcb79bae 483};
92fcbfc1
DK
484 /*}}}*/
485// Description File /*{{{*/
773e2c1f 486class pkgCache::DescFileIterator : public Iterator<DescFile, DescFileIterator> {
3707fd4f 487 public:
773e2c1f 488 inline DescFile* OwnerPointer() const {
c55b8a54 489 return (Owner != 0) ? Owner->DescFileP : 0;
d3e8fbb3 490 }
773e2c1f 491
773e2c1f 492 // Iteration
3707fd4f
DK
493 inline DescFileIterator& operator++() {if (S != Owner->DescFileP) S = Owner->DescFileP + S->NextFile; return *this;}
494 inline DescFileIterator operator++(int) { DescFileIterator const tmp(*this); operator++(); return tmp; }
773e2c1f
DK
495
496 // Accessors
d3e8fbb3 497 inline PkgFileIterator File() const {return PkgFileIterator(*Owner,S->File + Owner->PkgFileP);}
773e2c1f 498
d3e8fbb3
DK
499 inline DescFileIterator() : Iterator<DescFile, DescFileIterator>() {}
500 inline DescFileIterator(pkgCache &Owner,DescFile *Trg) : Iterator<DescFile, DescFileIterator>(Owner, Trg) {}
a52f938b 501};
92fcbfc1 502 /*}}}*/
1e3f4083 503// Inlined Begin functions can't be in the class because of order problems /*{{{*/
5bf15716 504inline pkgCache::PkgIterator pkgCache::GrpIterator::PackageList() const
d3e8fbb3 505 {return PkgIterator(*Owner,Owner->PkgP + S->FirstPackage);}
578bfd0a 506inline pkgCache::VerIterator pkgCache::PkgIterator::VersionList() const
d3e8fbb3 507 {return VerIterator(*Owner,Owner->VerP + S->VersionList);}
578bfd0a 508inline pkgCache::VerIterator pkgCache::PkgIterator::CurrentVer() const
d3e8fbb3 509 {return VerIterator(*Owner,Owner->VerP + S->CurrentVer);}
578bfd0a 510inline pkgCache::DepIterator pkgCache::PkgIterator::RevDependsList() const
d3e8fbb3 511 {return DepIterator(*Owner,Owner->DepP + S->RevDepends,S);}
578bfd0a 512inline pkgCache::PrvIterator pkgCache::PkgIterator::ProvidesList() const
d3e8fbb3 513 {return PrvIterator(*Owner,Owner->ProvideP + S->ProvidesList,S);}
a52f938b 514inline pkgCache::DescIterator pkgCache::VerIterator::DescriptionList() const
d3e8fbb3 515 {return DescIterator(*Owner,Owner->DescP + S->DescriptionList);}
578bfd0a 516inline pkgCache::PrvIterator pkgCache::VerIterator::ProvidesList() const
d3e8fbb3 517 {return PrvIterator(*Owner,Owner->ProvideP + S->ProvidesList,S);}
578bfd0a 518inline pkgCache::DepIterator pkgCache::VerIterator::DependsList() const
d3e8fbb3 519 {return DepIterator(*Owner,Owner->DepP + S->DependsList,S);}
dcb79bae 520inline pkgCache::VerFileIterator pkgCache::VerIterator::FileList() const
d3e8fbb3 521 {return VerFileIterator(*Owner,Owner->VerFileP + S->FileList);}
a52f938b 522inline pkgCache::DescFileIterator pkgCache::DescIterator::FileList() const
d3e8fbb3 523 {return DescFileIterator(*Owner,Owner->DescFileP + S->FileList);}
5dd00edb 524APT_DEPRECATED_MSG("Use the .Section method of VerIterator instead") inline const char * pkgCache::PkgIterator::Section() const
a1dfe337 525 {return S->VersionList == 0 ? 0 : VersionList().Section();}
92fcbfc1 526 /*}}}*/
578bfd0a 527#endif