]>
Commit | Line | Data |
---|---|---|
1 | // -*- mode: cpp; mode: fold -*- | |
2 | // Description /*{{{*/ | |
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 | |
23 | that has the depends pointer as a member. The provide iterator has the | |
24 | same system. | |
25 | ||
26 | This header is not user includable, please use apt-pkg/pkgcache.h | |
27 | ||
28 | ##################################################################### */ | |
29 | /*}}}*/ | |
30 | #ifndef PKGLIB_CACHEITERATORS_H | |
31 | #define PKGLIB_CACHEITERATORS_H | |
32 | #include<apt-pkg/pkgcache.h> | |
33 | #include<apt-pkg/macros.h> | |
34 | ||
35 | #include<iterator> | |
36 | #include <iosfwd> | |
37 | #include <string> | |
38 | #ifdef APT_PKG_EXPOSE_STRING_VIEW | |
39 | #include <apt-pkg/string_view.h> | |
40 | #endif | |
41 | ||
42 | #include<string.h> | |
43 | ||
44 | // abstract Iterator template /*{{{*/ | |
45 | /* This template provides the very basic iterator methods we | |
46 | need to have for doing some walk-over-the-cache magic */ | |
47 | template<typename Str, typename Itr> class pkgCache::Iterator : | |
48 | public std::iterator<std::forward_iterator_tag, Str> { | |
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 | |
53 | * each structure and we want to abstract here at least for the | |
54 | * basic methods from the actual structure. | |
55 | * \return Pointer to the first structure of this type | |
56 | */ | |
57 | Str* OwnerPointer() const { return static_cast<Itr const*>(this)->OwnerPointer(); } | |
58 | ||
59 | protected: | |
60 | Str *S; | |
61 | pkgCache *Owner; | |
62 | ||
63 | public: | |
64 | // Iteration | |
65 | inline bool end() const {return Owner == 0 || S == OwnerPointer();} | |
66 | ||
67 | // Comparison | |
68 | inline bool operator ==(const Itr &B) const {return S == B.S;} | |
69 | inline bool operator !=(const Itr &B) const {return S != B.S;} | |
70 | ||
71 | // Accessors | |
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;} | |
79 | ||
80 | // Mixed stuff | |
81 | inline bool IsGood() const { return S && Owner && ! end();} | |
82 | inline unsigned long Index() const {return S - OwnerPointer();} | |
83 | ||
84 | void ReMap(void const * const oldMap, void const * const newMap) { | |
85 | if (Owner == 0 || S == 0) | |
86 | return; | |
87 | S += (Str const * const)(newMap) - (Str const * const)(oldMap); | |
88 | } | |
89 | ||
90 | // Constructors - look out for the variable assigning | |
91 | inline Iterator() : S(0), Owner(0) {} | |
92 | inline Iterator(pkgCache &Owner,Str *T = 0) : S(T), Owner(&Owner) {} | |
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) */ | |
100 | class pkgCache::GrpIterator: public Iterator<Group, GrpIterator> { | |
101 | long HashIndex; | |
102 | ||
103 | public: | |
104 | inline Group* OwnerPointer() const { | |
105 | return (Owner != 0) ? Owner->GrpP : 0; | |
106 | } | |
107 | ||
108 | // This constructor is the 'begin' constructor, never use it. | |
109 | explicit inline GrpIterator(pkgCache &Owner) : Iterator<Group, GrpIterator>(Owner), HashIndex(-1) { | |
110 | S = OwnerPointer(); | |
111 | operator++(); | |
112 | } | |
113 | ||
114 | GrpIterator& operator++(); | |
115 | inline GrpIterator operator++(int) { GrpIterator const tmp(*this); operator++(); return tmp; } | |
116 | ||
117 | inline const char *Name() const {return S->Name == 0?0:Owner->StrP + S->Name;} | |
118 | inline PkgIterator PackageList() const; | |
119 | PkgIterator FindPkg(std::string Arch = "any") const; | |
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 | |
124 | /** \brief find the package with the "best" architecture | |
125 | ||
126 | The best architecture is either the "native" or the first | |
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; | |
132 | PkgIterator NextPkg(PkgIterator const &Pkg) const; | |
133 | ||
134 | // Constructors | |
135 | inline GrpIterator(pkgCache &Owner, Group *Trg) : Iterator<Group, GrpIterator>(Owner, Trg), HashIndex(0) { | |
136 | if (S == 0) | |
137 | S = OwnerPointer(); | |
138 | } | |
139 | inline GrpIterator() : Iterator<Group, GrpIterator>(), HashIndex(0) {} | |
140 | ||
141 | }; | |
142 | /*}}}*/ | |
143 | // Package Iterator /*{{{*/ | |
144 | class pkgCache::PkgIterator: public Iterator<Package, PkgIterator> { | |
145 | long HashIndex; | |
146 | ||
147 | public: | |
148 | inline Package* OwnerPointer() const { | |
149 | return (Owner != 0) ? Owner->PkgP : 0; | |
150 | } | |
151 | ||
152 | // This constructor is the 'begin' constructor, never use it. | |
153 | explicit inline PkgIterator(pkgCache &Owner) : Iterator<Package, PkgIterator>(Owner), HashIndex(-1) { | |
154 | S = OwnerPointer(); | |
155 | operator++(); | |
156 | } | |
157 | ||
158 | PkgIterator& operator++(); | |
159 | inline PkgIterator operator++(int) { PkgIterator const tmp(*this); operator++(); return tmp; } | |
160 | ||
161 | enum OkState {NeedsNothing,NeedsUnpack,NeedsConfigure}; | |
162 | ||
163 | // Accessors | |
164 | inline const char *Name() const { return Group().Name(); } | |
165 | // Versions have sections - and packages can have different versions with different sections | |
166 | // so this interface is broken by design. Run as fast as you can to Version.Section(). | |
167 | APT_DEPRECATED_MSG("Use the .Section method of VerIterator instead") inline const char *Section() const; | |
168 | inline bool Purge() const {return S->CurrentState == pkgCache::State::Purge || | |
169 | (S->CurrentVer == 0 && S->CurrentState == pkgCache::State::NotInstalled);} | |
170 | inline const char *Arch() const {return S->Arch == 0?0:Owner->StrP + S->Arch;} | |
171 | inline APT_PURE GrpIterator Group() const { return GrpIterator(*Owner, Owner->GrpP + S->Group);} | |
172 | ||
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; | |
178 | APT_DEPRECATED_MSG("This method does not respect apt_preferences! Use pkgDepCache::GetCandidateVersion(Pkg)") const char *CandVersion() const APT_PURE; | |
179 | const char *CurVersion() const APT_PURE; | |
180 | ||
181 | //Nice printable representation | |
182 | friend std::ostream& operator <<(std::ostream& out, PkgIterator i); | |
183 | std::string FullName(bool const &Pretty = false) const; | |
184 | ||
185 | // Constructors | |
186 | inline PkgIterator(pkgCache &Owner,Package *Trg) : Iterator<Package, PkgIterator>(Owner, Trg), HashIndex(0) { | |
187 | if (S == 0) | |
188 | S = OwnerPointer(); | |
189 | } | |
190 | inline PkgIterator() : Iterator<Package, PkgIterator>(), HashIndex(0) {} | |
191 | }; | |
192 | /*}}}*/ | |
193 | // Version Iterator /*{{{*/ | |
194 | class pkgCache::VerIterator : public Iterator<Version, VerIterator> { | |
195 | public: | |
196 | inline Version* OwnerPointer() const { | |
197 | return (Owner != 0) ? Owner->VerP : 0; | |
198 | } | |
199 | ||
200 | // Iteration | |
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; } | |
203 | ||
204 | // Comparison | |
205 | int CompareVer(const VerIterator &B) const; | |
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 | |
209 | referring to the same "real" version */ | |
210 | inline bool SimilarVer(const VerIterator &B) const { | |
211 | return (B.end() == false && S->Hash == B->Hash && strcmp(VerStr(), B.VerStr()) == 0); | |
212 | } | |
213 | ||
214 | // Accessors | |
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;} | |
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;} | |
223 | inline const char *Arch() const { | |
224 | if ((S->MultiArch & pkgCache::Version::All) == pkgCache::Version::All) | |
225 | return "all"; | |
226 | return S->ParentPkg == 0?0:Owner->StrP + ParentPkg()->Arch; | |
227 | } | |
228 | inline PkgIterator ParentPkg() const {return PkgIterator(*Owner,Owner->PkgP + S->ParentPkg);} | |
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; | |
236 | inline const char *PriorityType() const {return Owner->Priority(S->Priority);} | |
237 | const char *MultiArchType() const APT_PURE; | |
238 | std::string RelStr() const; | |
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(); | |
246 | } | |
247 | inline VerIterator() : Iterator<Version, VerIterator>() {} | |
248 | }; | |
249 | /*}}}*/ | |
250 | // Description Iterator /*{{{*/ | |
251 | class pkgCache::DescIterator : public Iterator<Description, DescIterator> { | |
252 | public: | |
253 | inline Description* OwnerPointer() const { | |
254 | return (Owner != 0) ? Owner->DescP : 0; | |
255 | } | |
256 | ||
257 | // Iteration | |
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; } | |
260 | ||
261 | // Comparison | |
262 | int CompareDesc(const DescIterator &B) const; | |
263 | ||
264 | // Accessors | |
265 | inline const char *LanguageCode() const {return Owner->StrP + S->language_code;} | |
266 | inline const char *md5() const {return Owner->StrP + S->md5sum;} | |
267 | inline DescFileIterator FileList() const; | |
268 | ||
269 | inline DescIterator() : Iterator<Description, DescIterator>() {} | |
270 | inline DescIterator(pkgCache &Owner,Description *Trg = 0) : Iterator<Description, DescIterator>(Owner, Trg) { | |
271 | if (S == 0) | |
272 | S = Owner.DescP; | |
273 | } | |
274 | }; | |
275 | /*}}}*/ | |
276 | // Dependency iterator /*{{{*/ | |
277 | class pkgCache::DepIterator : public Iterator<Dependency, DepIterator> { | |
278 | enum {DepVer, DepRev} Type; | |
279 | DependencyData * S2; | |
280 | ||
281 | public: | |
282 | inline Dependency* OwnerPointer() const { | |
283 | return (Owner != 0) ? Owner->DepP : 0; | |
284 | } | |
285 | ||
286 | // Iteration | |
287 | DepIterator& operator++(); | |
288 | inline DepIterator operator++(int) { DepIterator const tmp(*this); operator++(); return tmp; } | |
289 | ||
290 | // Accessors | |
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);} | |
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;} | |
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; | |
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, | |
308 | but change architecture nonetheless as a Conflicts: foo does applies for all archs */ | |
309 | bool IsImplicit() const APT_PURE; | |
310 | ||
311 | bool IsSatisfied(VerIterator const &Ver) const APT_PURE; | |
312 | bool IsSatisfied(PrvIterator const &Prv) const APT_PURE; | |
313 | void GlobOr(DepIterator &Start,DepIterator &End); | |
314 | Version **AllTargets() const; | |
315 | bool SmartTargetPkg(PkgIterator &Result) const; | |
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; | |
324 | map_id_t &ID; | |
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; | |
331 | map_pointer_t &NextData; | |
332 | DependencyProxy const * operator->() const { return this; } | |
333 | DependencyProxy * operator->() { return this; } | |
334 | }; | |
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 };} | |
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 | } | |
344 | ||
345 | //Nice printable representation | |
346 | friend std::ostream& operator <<(std::ostream& out, DepIterator D); | |
347 | ||
348 | inline DepIterator(pkgCache &Owner, Dependency *Trg, Version* = 0) : | |
349 | Iterator<Dependency, DepIterator>(Owner, Trg), Type(DepVer), S2(Trg == 0 ? Owner.DepDataP : (Owner.DepDataP + Trg->DependencyData)) { | |
350 | if (S == 0) | |
351 | S = Owner.DepP; | |
352 | } | |
353 | inline DepIterator(pkgCache &Owner, Dependency *Trg, Package*) : | |
354 | Iterator<Dependency, DepIterator>(Owner, Trg), Type(DepRev), S2(Trg == 0 ? Owner.DepDataP : (Owner.DepDataP + Trg->DependencyData)) { | |
355 | if (S == 0) | |
356 | S = Owner.DepP; | |
357 | } | |
358 | inline DepIterator() : Iterator<Dependency, DepIterator>(), Type(DepVer), S2(0) {} | |
359 | }; | |
360 | /*}}}*/ | |
361 | // Provides iterator /*{{{*/ | |
362 | class pkgCache::PrvIterator : public Iterator<Provides, PrvIterator> { | |
363 | enum {PrvVer, PrvPkg} Type; | |
364 | ||
365 | public: | |
366 | inline Provides* OwnerPointer() const { | |
367 | return (Owner != 0) ? Owner->ProvideP : 0; | |
368 | } | |
369 | ||
370 | // Iteration | |
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; } | |
374 | ||
375 | // Accessors | |
376 | inline const char *Name() const {return ParentPkg().Name();} | |
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);} | |
381 | ||
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 | ||
388 | ||
389 | inline PrvIterator() : Iterator<Provides, PrvIterator>(), Type(PrvVer) {} | |
390 | inline PrvIterator(pkgCache &Owner, Provides *Trg, Version*) : | |
391 | Iterator<Provides, PrvIterator>(Owner, Trg), Type(PrvVer) { | |
392 | if (S == 0) | |
393 | S = Owner.ProvideP; | |
394 | } | |
395 | inline PrvIterator(pkgCache &Owner, Provides *Trg, Package*) : | |
396 | Iterator<Provides, PrvIterator>(Owner, Trg), Type(PrvPkg) { | |
397 | if (S == 0) | |
398 | S = Owner.ProvideP; | |
399 | } | |
400 | }; | |
401 | /*}}}*/ | |
402 | // Release file /*{{{*/ | |
403 | class pkgCache::RlsFileIterator : public Iterator<ReleaseFile, RlsFileIterator> { | |
404 | public: | |
405 | inline ReleaseFile* OwnerPointer() const { | |
406 | return (Owner != 0) ? Owner->RlsFileP : 0; | |
407 | } | |
408 | ||
409 | // Iteration | |
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; } | |
412 | ||
413 | // Accessors | |
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;} | |
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;} | |
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>() {} | |
428 | explicit inline RlsFileIterator(pkgCache &Owner) : Iterator<ReleaseFile, RlsFileIterator>(Owner, Owner.RlsFileP) {} | |
429 | inline RlsFileIterator(pkgCache &Owner,ReleaseFile *Trg) : Iterator<ReleaseFile, RlsFileIterator>(Owner, Trg) {} | |
430 | }; | |
431 | /*}}}*/ | |
432 | // Package file /*{{{*/ | |
433 | class pkgCache::PkgFileIterator : public Iterator<PackageFile, PkgFileIterator> { | |
434 | public: | |
435 | inline PackageFile* OwnerPointer() const { | |
436 | return (Owner != 0) ? Owner->PkgFileP : 0; | |
437 | } | |
438 | ||
439 | // Iteration | |
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; } | |
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;} | |
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;} | |
457 | ||
458 | bool IsOk(); | |
459 | std::string RelStr(); | |
460 | ||
461 | // Constructors | |
462 | inline PkgFileIterator() : Iterator<PackageFile, PkgFileIterator>() {} | |
463 | explicit inline PkgFileIterator(pkgCache &Owner) : Iterator<PackageFile, PkgFileIterator>(Owner, Owner.PkgFileP) {} | |
464 | inline PkgFileIterator(pkgCache &Owner,PackageFile *Trg) : Iterator<PackageFile, PkgFileIterator>(Owner, Trg) {} | |
465 | }; | |
466 | /*}}}*/ | |
467 | // Version File /*{{{*/ | |
468 | class pkgCache::VerFileIterator : public pkgCache::Iterator<VerFile, VerFileIterator> { | |
469 | public: | |
470 | inline VerFile* OwnerPointer() const { | |
471 | return (Owner != 0) ? Owner->VerFileP : 0; | |
472 | } | |
473 | ||
474 | // Iteration | |
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; } | |
477 | ||
478 | // Accessors | |
479 | inline PkgFileIterator File() const {return PkgFileIterator(*Owner,S->File + Owner->PkgFileP);} | |
480 | ||
481 | inline VerFileIterator() : Iterator<VerFile, VerFileIterator>() {} | |
482 | inline VerFileIterator(pkgCache &Owner,VerFile *Trg) : Iterator<VerFile, VerFileIterator>(Owner, Trg) {} | |
483 | }; | |
484 | /*}}}*/ | |
485 | // Description File /*{{{*/ | |
486 | class pkgCache::DescFileIterator : public Iterator<DescFile, DescFileIterator> { | |
487 | public: | |
488 | inline DescFile* OwnerPointer() const { | |
489 | return (Owner != 0) ? Owner->DescFileP : 0; | |
490 | } | |
491 | ||
492 | // Iteration | |
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; } | |
495 | ||
496 | // Accessors | |
497 | inline PkgFileIterator File() const {return PkgFileIterator(*Owner,S->File + Owner->PkgFileP);} | |
498 | ||
499 | inline DescFileIterator() : Iterator<DescFile, DescFileIterator>() {} | |
500 | inline DescFileIterator(pkgCache &Owner,DescFile *Trg) : Iterator<DescFile, DescFileIterator>(Owner, Trg) {} | |
501 | }; | |
502 | /*}}}*/ | |
503 | // Inlined Begin functions can't be in the class because of order problems /*{{{*/ | |
504 | inline pkgCache::PkgIterator pkgCache::GrpIterator::PackageList() const | |
505 | {return PkgIterator(*Owner,Owner->PkgP + S->FirstPackage);} | |
506 | inline pkgCache::VerIterator pkgCache::PkgIterator::VersionList() const | |
507 | {return VerIterator(*Owner,Owner->VerP + S->VersionList);} | |
508 | inline pkgCache::VerIterator pkgCache::PkgIterator::CurrentVer() const | |
509 | {return VerIterator(*Owner,Owner->VerP + S->CurrentVer);} | |
510 | inline pkgCache::DepIterator pkgCache::PkgIterator::RevDependsList() const | |
511 | {return DepIterator(*Owner,Owner->DepP + S->RevDepends,S);} | |
512 | inline pkgCache::PrvIterator pkgCache::PkgIterator::ProvidesList() const | |
513 | {return PrvIterator(*Owner,Owner->ProvideP + S->ProvidesList,S);} | |
514 | inline pkgCache::DescIterator pkgCache::VerIterator::DescriptionList() const | |
515 | {return DescIterator(*Owner,Owner->DescP + S->DescriptionList);} | |
516 | inline pkgCache::PrvIterator pkgCache::VerIterator::ProvidesList() const | |
517 | {return PrvIterator(*Owner,Owner->ProvideP + S->ProvidesList,S);} | |
518 | inline pkgCache::DepIterator pkgCache::VerIterator::DependsList() const | |
519 | {return DepIterator(*Owner,Owner->DepP + S->DependsList,S);} | |
520 | inline pkgCache::VerFileIterator pkgCache::VerIterator::FileList() const | |
521 | {return VerFileIterator(*Owner,Owner->VerFileP + S->FileList);} | |
522 | inline pkgCache::DescFileIterator pkgCache::DescIterator::FileList() const | |
523 | {return DescFileIterator(*Owner,Owner->DescFileP + S->FileList);} | |
524 | APT_DEPRECATED_MSG("Use the .Section method of VerIterator instead") inline const char * pkgCache::PkgIterator::Section() const | |
525 | {return S->VersionList == 0 ? 0 : VersionList().Section();} | |
526 | /*}}}*/ | |
527 | #endif |