Result iterator. More...

#include <zypp/sat/LookupAttr.h>

Inheritance diagram for zypp::sat::LookupAttr::iterator:

Public Member Functions
Moving fast forward.
void	nextSkipSolvAttr ()
	On the next call to operator++ advance to the next SolvAttr.
void	nextSkipSolvable ()
	On the next call to operator++ advance to the next Solvable.
void	nextSkipRepo ()
	On the next call to operator++ advance to the next Repository.
void	skipSolvAttr ()
	Immediately advance to the next SolvAttr.
void	skipSolvable ()
	Immediately advance to the next Solvable.
void	skipRepo ()
	Immediately advance to the next Repository.
void	stayInThisSolvable ()
	Stop after all matches in the current Solvable are processed.
void	stayInThisRepo ()
	Stop after all matches in the current Repository are processed.
Current position info.
Repository	inRepo () const
	The current Repository.
Solvable	inSolvable () const
	The current Solvable.
SolvAttr	inSolvAttr () const
	The current SolvAttr.
bool	atEnd () const
	Whether this points to the end of a query (Iterator is invalid).
Test attribute value type.
detail::IdType	solvAttrType () const
	The current SolvAttr type.
bool	solvAttrNumeric () const
	Whether this is a numeric attribute (incl.
bool	solvAttrString () const
	Whether this is a string attribute.
bool	solvAttrIdString () const
	Whether this string attribute is available as IdString.
bool	solvAttrCheckSum () const
	Whether this is a CheckSum attribute.
bool	solvAttrSubEntry () const
	Whether this is the entry to a sub-structure (flexarray).
Iterate sub-structures.
These are usable iff solvAttrSubEntry is `true`. Note Unfortunately the underlying libsolv dataiterator as returned by subBegin and subFind loses some context when being created. Thus, it's not possible to invoke subBegin and subFind on an iterator that was previously returned by one of those methods. The result will be an `end` iterator. For the same reason, it is not possible for an iterator to leave the sub-structure again. // Lookup all "update:reference" entries for a specific solvable sat::LookupAttr q( sat::SolvAttr::updateReference, p->satSolvable() ); for_( res, q.begin(), q.end() ) { // List all sub values for_( sub, res.subBegin(), res.subEnd() ) { cout << sub.asString() << endl; } // Directly access c specific value: sat::LookupAttr::iterator it( res.subFind( sat::SolvAttr::updateReferenceHref ) ); if ( it != res.subEnd() ) cout << it.asString() << endl; } zypp::sat::LookupAttr::iterator Result iterator. Definition LookupAttr.h:364 zypp::sat::LookupAttr Lightweight attribute value lookup. Definition LookupAttr.h:110 zypp::sat::SolvAttr::updateReferenceHref static const SolvAttr updateReferenceHref Definition SolvAttr.h:143 zypp::sat::SolvAttr::updateReference static const SolvAttr updateReference Definition SolvAttr.h:141 for_ #define for_(IT, BEG, END) Convenient for-loops using iterator. Definition Easy.h:27
bool	subEmpty () const
	Whether the sub-structure is empty.
size_type	subSize () const
	Ammount of attributes in the sub-structure.
iterator	subBegin () const
	Iterator to the begin of a sub-structure.
iterator	subEnd () const
	Iterator behind the end of a sub-structure.
iterator	subFind (const SolvAttr &attr_r) const
	Iterator pointing to the first occurance of SolvAttr attr_r in sub-structure.
iterator	subFind (const C_Str &attrname_r) const
Helpers and forward declarations from LookupAttrTools.h
template<>
CheckSum	asType () const

Related Symbols
(Note that these are not member symbols.)
std::ostream &	operator<< (std::ostream &str, const LookupAttr::iterator &obj) ZYPP_API
	Stream output.
template<class TResult, class TAttr>
std::ostream &	operator<< (std::ostream &str, const ArrayAttr< TResult, TAttr > &obj)
	Stream output.

Retrieving attribute values.
class	boost::iterator_core_access
detail::DIWrap	_dip
int	asInt () const
	Conversion to numeric types.
unsigned	asUnsigned () const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
bool	asBool () const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
unsigned long long	asUnsignedLL () const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
const char *	c_str () const
	Conversion to string types.
std::string	asString () const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. If used with non-string types, this method tries to create some appropriate string representation.
IdString	idStr () const
	As IdStr.
detail::IdType	id () const
CheckSum	asCheckSum () const
	As CheckSum.
template<class Tp>
Tp	asType () const
	Templated return type.
	iterator ()
	iterator (const iterator &rhs)
iterator &	operator= (const iterator &rhs)
	~iterator ()
	iterator (detail::DIWrap &dip_r)
	C-tor taking over ownership of the passed `detail::CDataiterator` and doing its first iteration (::dataiterator_step)
detail::CDataiterator *	get () const
	Expert backdoor.
template<class OtherDerived, class OtherIterator, class V, class C, class R, class D>
bool	equal (const boost::iterator_adaptor< OtherDerived, OtherIterator, V, C, R, D > &rhs) const
bool	dip_equal (const detail::CDataiterator &lhs, const detail::CDataiterator &rhs) const
detail::IdType	dereference () const
void	increment ()

Detailed Description

Result iterator.

Extended iterator methods valid only if not @end.

Note: Implementation: Keep iterator_adaptor base and _dip in sync!

Definition at line 357 of file LookupAttr.h.

Constructor & Destructor Documentation

◆ iterator() [1/3]

zypp::sat::LookupAttr::iterator::iterator ( )

Definition at line 719 of file LookupAttr.cc.

◆ iterator() [2/3]

zypp::sat::LookupAttr::iterator::iterator ( const iterator & rhs )

Definition at line 723 of file LookupAttr.cc.

◆ ~iterator()

zypp::sat::LookupAttr::iterator::~iterator ( )

Definition at line 738 of file LookupAttr.cc.

◆ iterator() [3/3]

zypp::sat::LookupAttr::iterator::iterator ( detail::DIWrap & dip_r )

C-tor taking over ownership of the passed detail::CDataiterator and doing its first iteration (::dataiterator_step)

Definition at line 730 of file LookupAttr.cc.

Member Function Documentation

◆ nextSkipSolvAttr()

void zypp::sat::LookupAttr::iterator::nextSkipSolvAttr ( )

On the next call to operator++ advance to the next SolvAttr.

Definition at line 361 of file LookupAttr.cc.

◆ nextSkipSolvable()

void zypp::sat::LookupAttr::iterator::nextSkipSolvable ( )

On the next call to operator++ advance to the next Solvable.

Definition at line 364 of file LookupAttr.cc.

◆ nextSkipRepo()

void zypp::sat::LookupAttr::iterator::nextSkipRepo ( )

On the next call to operator++ advance to the next Repository.

Definition at line 367 of file LookupAttr.cc.

◆ skipSolvAttr()

void zypp::sat::LookupAttr::iterator::skipSolvAttr ( )

inline

Immediately advance to the next SolvAttr.

Definition at line 378 of file LookupAttr.h.

◆ skipSolvable()

void zypp::sat::LookupAttr::iterator::skipSolvable ( )

inline

Immediately advance to the next Solvable.

Definition at line 382 of file LookupAttr.h.

◆ skipRepo()

void zypp::sat::LookupAttr::iterator::skipRepo ( )

inline

Immediately advance to the next Repository.

Definition at line 386 of file LookupAttr.h.

◆ stayInThisSolvable()

void zypp::sat::LookupAttr::iterator::stayInThisSolvable ( )

Stop after all matches in the current Solvable are processed.

Definition at line 370 of file LookupAttr.cc.

◆ stayInThisRepo()

void zypp::sat::LookupAttr::iterator::stayInThisRepo ( )

Stop after all matches in the current Repository are processed.

Definition at line 373 of file LookupAttr.cc.

◆ inRepo()

Repository zypp::sat::LookupAttr::iterator::inRepo ( ) const

The current Repository.

Definition at line 352 of file LookupAttr.cc.

◆ inSolvable()

Solvable zypp::sat::LookupAttr::iterator::inSolvable ( ) const

The current Solvable.

Definition at line 355 of file LookupAttr.cc.

◆ inSolvAttr()

SolvAttr zypp::sat::LookupAttr::iterator::inSolvAttr ( ) const

The current SolvAttr.

Definition at line 358 of file LookupAttr.cc.

◆ atEnd()

bool zypp::sat::LookupAttr::iterator::atEnd ( ) const

inline

Whether this points to the end of a query (Iterator is invalid).

Definition at line 408 of file LookupAttr.h.

◆ solvAttrType()

detail::IdType zypp::sat::LookupAttr::iterator::solvAttrType ( ) const

The current SolvAttr type.

Definition at line 380 of file LookupAttr.cc.

◆ solvAttrNumeric()

bool zypp::sat::LookupAttr::iterator::solvAttrNumeric ( ) const

Whether this is a numeric attribute (incl.

boolean).

Definition at line 383 of file LookupAttr.cc.

◆ solvAttrString()

bool zypp::sat::LookupAttr::iterator::solvAttrString ( ) const

Whether this is a string attribute.

Definition at line 395 of file LookupAttr.cc.

◆ solvAttrIdString()

bool zypp::sat::LookupAttr::iterator::solvAttrIdString ( ) const

Whether this string attribute is available as IdString.

Definition at line 410 of file LookupAttr.cc.

◆ solvAttrCheckSum()

bool zypp::sat::LookupAttr::iterator::solvAttrCheckSum ( ) const

Whether this is a CheckSum attribute.

Definition at line 423 of file LookupAttr.cc.

◆ solvAttrSubEntry()

bool zypp::sat::LookupAttr::iterator::solvAttrSubEntry ( ) const

Whether this is the entry to a sub-structure (flexarray).

This is the entry to a sequence of attributes. To acces them use subBegin and subEnd.

Definition at line 453 of file LookupAttr.cc.

◆ subEmpty()

bool zypp::sat::LookupAttr::iterator::subEmpty ( ) const

Whether the sub-structure is empty.

Definition at line 460 of file LookupAttr.cc.

◆ subSize()

LookupAttr::size_type zypp::sat::LookupAttr::iterator::subSize ( ) const

Ammount of attributes in the sub-structure.

Note: This is not a cheap call. It runs the query.

Definition at line 463 of file LookupAttr.cc.

◆ subBegin()

LookupAttr::iterator zypp::sat::LookupAttr::iterator::subBegin ( ) const

Iterator to the begin of a sub-structure.

See also: solvAttrSubEntry

Definition at line 471 of file LookupAttr.cc.

◆ subEnd()

LookupAttr::iterator zypp::sat::LookupAttr::iterator::subEnd ( ) const

Iterator behind the end of a sub-structure.

See also: solvAttrSubEntry

Definition at line 493 of file LookupAttr.cc.

◆ subFind() [1/2]

LookupAttr::iterator zypp::sat::LookupAttr::iterator::subFind ( const SolvAttr & attr_r ) const

Iterator pointing to the first occurance of SolvAttr attr_r in sub-structure.

If sat::SolvAttr::allAttr is passed, subBegin is returned.

See also: solvAttrSubEntry

Definition at line 498 of file LookupAttr.cc.

◆ subFind() [2/2]

LookupAttr::iterator zypp::sat::LookupAttr::iterator::subFind ( const C_Str & attrname_r ) const

Definition at line 509 of file LookupAttr.cc.

◆ asInt()

int zypp::sat::LookupAttr::iterator::asInt ( ) const

Conversion to numeric types.

Definition at line 544 of file LookupAttr.cc.

◆ asUnsigned()

unsigned zypp::sat::LookupAttr::iterator::asUnsigned ( ) const

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 559 of file LookupAttr.cc.

◆ asBool()

bool zypp::sat::LookupAttr::iterator::asBool ( ) const

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 577 of file LookupAttr.cc.

◆ asUnsignedLL()

unsigned long long zypp::sat::LookupAttr::iterator::asUnsignedLL ( ) const

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 562 of file LookupAttr.cc.

◆ c_str()

const char * zypp::sat::LookupAttr::iterator::c_str ( ) const

Conversion to string types.

Definition at line 581 of file LookupAttr.cc.

◆ asString()

std::string zypp::sat::LookupAttr::iterator::asString ( ) const

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. If used with non-string types, this method tries to create some appropriate string representation.

Definition at line 611 of file LookupAttr.cc.

◆ idStr()

IdString zypp::sat::LookupAttr::iterator::idStr ( ) const

As IdStr.

This is only done for poolized string types. Large strings like summary or descriptions are not available via IdStr, only via c_str and asString.

Definition at line 665 of file LookupAttr.cc.

◆ id()

detail::IdType zypp::sat::LookupAttr::iterator::id ( ) const

inline

Definition at line 523 of file LookupAttr.h.

◆ asCheckSum()

CheckSum zypp::sat::LookupAttr::iterator::asCheckSum ( ) const

As CheckSum.

Definition at line 681 of file LookupAttr.cc.

◆ asType() [1/2]

template<class Tp>

Tp zypp::sat::LookupAttr::iterator::asType ( ) const

inline

Templated return type.

Per default assumes an Id based type, so try to construct it from the Id.

Should be specialized for supported types above.

Definition at line 535 of file LookupAttr.h.

◆ operator=()

LookupAttr::iterator & zypp::sat::LookupAttr::iterator::operator= ( const iterator & rhs )

Definition at line 741 of file LookupAttr.cc.

◆ equal()

template<class OtherDerived, class OtherIterator, class V, class C, class R, class D>

bool zypp::sat::LookupAttr::iterator::equal ( const boost::iterator_adaptor< OtherDerived, OtherIterator, V, C, R, D > & rhs ) const

inlineprivate

Definition at line 561 of file LookupAttr.h.

◆ dip_equal()

bool zypp::sat::LookupAttr::iterator::dip_equal	(	const detail::CDataiterator &	lhs,
		const detail::CDataiterator &	rhs ) const

private

Definition at line 753 of file LookupAttr.cc.

◆ dereference()

detail::IdType zypp::sat::LookupAttr::iterator::dereference ( ) const

private

Definition at line 760 of file LookupAttr.cc.

◆ increment()

void zypp::sat::LookupAttr::iterator::increment ( )

private

Definition at line 766 of file LookupAttr.cc.

◆ get()

detail::CDataiterator * zypp::sat::LookupAttr::iterator::get ( ) const

inline

Expert backdoor.

Definition at line 575 of file LookupAttr.h.

◆ asType() [2/2]

CheckSum zypp::sat::LookupAttr::iterator::asType< CheckSum > ( ) const

inline

Definition at line 798 of file LookupAttr.cc.

◆ boost::iterator_core_access

friend class boost::iterator_core_access

friend

Definition at line 558 of file LookupAttr.h.

◆ operator<<() [1/2]

std::ostream & operator<<	(	std::ostream &	str,
		const LookupAttr::iterator &	obj )

Stream output.

Definition at line 782 of file LookupAttr.cc.

◆ operator<<() [2/2]

template<class TResult, class TAttr>

std::ostream & operator<<	(	std::ostream &	str,
		const ArrayAttr< TResult, TAttr > &	obj )

Stream output.

Definition at line 216 of file LookupAttrTools.h.

Member Data Documentation

◆ _dip

detail::DIWrap zypp::sat::LookupAttr::iterator::_dip

private

Definition at line 578 of file LookupAttr.h.

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

zypp/sat/LookupAttr.h
zypp/sat/LookupAttr.cc
zypp/sat/LookupAttrTools.h

Public Member Functions

Related Symbols

Retrieving attribute values.

Detailed Description

Constructor & Destructor Documentation

◆ iterator() [1/3]

◆ iterator() [2/3]

◆ ~iterator()

◆ iterator() [3/3]

Member Function Documentation

◆ nextSkipSolvAttr()

◆ nextSkipSolvable()

◆ nextSkipRepo()

◆ skipSolvAttr()

◆ skipSolvable()

◆ skipRepo()

◆ stayInThisSolvable()

◆ stayInThisRepo()

◆ inRepo()

◆ inSolvable()

◆ inSolvAttr()

◆ atEnd()

◆ solvAttrType()

◆ solvAttrNumeric()

◆ solvAttrString()

◆ solvAttrIdString()

◆ solvAttrCheckSum()

◆ solvAttrSubEntry()

◆ subEmpty()

◆ subSize()

◆ subBegin()

◆ subEnd()

◆ subFind() [1/2]

◆ subFind() [2/2]

◆ asInt()

◆ asUnsigned()

◆ asBool()

◆ asUnsignedLL()

◆ c_str()

◆ asString()

◆ idStr()

◆ id()

◆ asCheckSum()

◆ asType() [1/2]

◆ operator=()

◆ equal()

◆ dip_equal()

◆ dereference()

◆ increment()

◆ get()

◆ asType() [2/2]

Friends And Related Symbol Documentation

◆ boost::iterator_core_access

◆ operator<<() [1/2]

◆ operator<<() [2/2]

Member Data Documentation

◆ _dip