libzypp  17.25.0
zypp::target::rpm::librpmDb::db_const_iterator Class Reference

Subclass to retrieve database content. More...

#include <librpmDb.h>

Classes

class  D
 

Public Member Functions

 db_const_iterator (librpmDb::constPtr dbptr_r=0)
 Constructor. More...
 
 ~db_const_iterator ()
 Destructor. More...
 
shared_ptr< RpmExceptiondbError () const
 Return any database error. More...
 
void operator++ ()
 Advance to next RpmHeader::constPtr. More...
 
unsigned dbHdrNum () const
 Returns the current headers index in database, 0 if no header. More...
 
const RpmHeader::constPtroperator* () const
 Returns the current RpmHeader::constPtr or NULL, if no more entries available. More...
 
const RpmHeader::constPtroperator-> () const
 Forwards to the current RpmHeader::constPtr. More...
 
bool findAll ()
 Reset to iterate all packages. More...
 
bool findByFile (const std::string &file_r)
 Reset to iterate all packages that own a certain file. More...
 
bool findByProvides (const std::string &tag_r)
 Reset to iterate all packages that provide a certain tag. More...
 
bool findByRequiredBy (const std::string &tag_r)
 Reset to iterate all packages that require a certain tag. More...
 
bool findByConflicts (const std::string &tag_r)
 Reset to iterate all packages that conflict with a certain tag. More...
 
bool findByName (const std::string &name_r)
 Reset to iterate all packages with a certain name. More...
 
bool findPackage (const std::string &name_r)
 Find package by name. More...
 
bool findPackage (const std::string &name_r, const Edition &ed_r)
 Find package by name and edition. More...
 
bool findPackage (const Package::constPtr &which_r)
 Abbr. More...
 

Private Member Functions

db_const_iteratoroperator= (const db_const_iterator &)
 
 db_const_iterator (const db_const_iterator &)
 

Private Attributes

D_d
 

Friends

class librpmDb
 
std::ostream & operator<< (std::ostream &str, const db_const_iterator &obj)
 

Detailed Description

Subclass to retrieve database content.

Definition at line 322 of file librpmDb.h.

Constructor & Destructor Documentation

◆ db_const_iterator() [1/2]

zypp::target::rpm::librpmDb::db_const_iterator::db_const_iterator ( const db_const_iterator )
private

◆ db_const_iterator() [2/2]

zypp::target::rpm::librpmDb::db_const_iterator::db_const_iterator ( librpmDb::constPtr  dbptr_r = 0)

Constructor.

Iterator is initialized to findAll. The default form accesses librpmDb's default database. Explicitly providing a database handle should not be neccesary, except for testing.

Definition at line 625 of file librpmDb.cc.

◆ ~db_const_iterator()

zypp::target::rpm::librpmDb::db_const_iterator::~db_const_iterator ( )

Destructor.

Definition at line 637 of file librpmDb.cc.

Member Function Documentation

◆ operator=()

db_const_iterator& zypp::target::rpm::librpmDb::db_const_iterator::operator= ( const db_const_iterator )
private

◆ dbError()

shared_ptr< RpmException > zypp::target::rpm::librpmDb::db_const_iterator::dbError ( ) const

Return any database error.

NOTE: If the database gets blocked (see dbRelease) dbError will immediately report this, but an already running iteration will proceed to its end. Then the database is dropped.

Definition at line 681 of file librpmDb.cc.

◆ operator++()

void zypp::target::rpm::librpmDb::db_const_iterator::operator++ ( )

Advance to next RpmHeader::constPtr.

Definition at line 648 of file librpmDb.cc.

◆ dbHdrNum()

unsigned zypp::target::rpm::librpmDb::db_const_iterator::dbHdrNum ( ) const

Returns the current headers index in database, 0 if no header.

Definition at line 659 of file librpmDb.cc.

◆ operator*()

const RpmHeader::constPtr & zypp::target::rpm::librpmDb::db_const_iterator::operator* ( ) const

Returns the current RpmHeader::constPtr or NULL, if no more entries available.

Definition at line 670 of file librpmDb.cc.

◆ operator->()

const RpmHeader::constPtr& zypp::target::rpm::librpmDb::db_const_iterator::operator-> ( ) const
inline

Forwards to the current RpmHeader::constPtr.

Definition at line 381 of file librpmDb.h.

◆ findAll()

bool zypp::target::rpm::librpmDb::db_const_iterator::findAll ( )

Reset to iterate all packages.

Returns true if iterator contains at least one entry.

NOTE: No entry (false) migt be returned due to a meanwhile blocked database (see dbRelease). Use dbError to check this.

Definition at line 709 of file librpmDb.cc.

◆ findByFile()

bool zypp::target::rpm::librpmDb::db_const_iterator::findByFile ( const std::string &  file_r)

Reset to iterate all packages that own a certain file.

Definition at line 720 of file librpmDb.cc.

◆ findByProvides()

bool zypp::target::rpm::librpmDb::db_const_iterator::findByProvides ( const std::string &  tag_r)

Reset to iterate all packages that provide a certain tag.

Definition at line 731 of file librpmDb.cc.

◆ findByRequiredBy()

bool zypp::target::rpm::librpmDb::db_const_iterator::findByRequiredBy ( const std::string &  tag_r)

Reset to iterate all packages that require a certain tag.

Definition at line 742 of file librpmDb.cc.

◆ findByConflicts()

bool zypp::target::rpm::librpmDb::db_const_iterator::findByConflicts ( const std::string &  tag_r)

Reset to iterate all packages that conflict with a certain tag.

Definition at line 753 of file librpmDb.cc.

◆ findByName()

bool zypp::target::rpm::librpmDb::db_const_iterator::findByName ( const std::string &  name_r)

Reset to iterate all packages with a certain name.

NOTE: Multiple entries for one package installed in different versions are possible but not desired. Usually you'll want to use findPackage instead.

findByName is needed to retrieve pseudo packages like 'gpg-pubkey', which in fact exist in multiple instances.

Definition at line 764 of file librpmDb.cc.

◆ findPackage() [1/3]

bool zypp::target::rpm::librpmDb::db_const_iterator::findPackage ( const std::string &  name_r)

Find package by name.

Multiple entries for one package installed in different versions are possible but not desired. If so, the last package installed is returned.

Definition at line 775 of file librpmDb.cc.

◆ findPackage() [2/3]

bool zypp::target::rpm::librpmDb::db_const_iterator::findPackage ( const std::string &  name_r,
const Edition ed_r 
)

Find package by name and edition.

Commonly used by PMRpmPackageDataProvider.

Definition at line 804 of file librpmDb.cc.

◆ findPackage() [3/3]

bool zypp::target::rpm::librpmDb::db_const_iterator::findPackage ( const Package::constPtr which_r)

Abbr.

for findPackage( which_r->name(), which_r->edition() );

Definition at line 827 of file librpmDb.cc.

Friends And Related Function Documentation

◆ librpmDb

friend class librpmDb
friend

Definition at line 327 of file librpmDb.h.

◆ operator<<

std::ostream& operator<< ( std::ostream &  str,
const db_const_iterator obj 
)
friend

Definition at line 694 of file librpmDb.cc.

Member Data Documentation

◆ _d

D& zypp::target::rpm::librpmDb::db_const_iterator::_d
private

Definition at line 334 of file librpmDb.h.


The documentation for this class was generated from the following files: