Result iterator. More...

#include <zypp/ng/sat/lookupattr.h>

Public Types
using	iterator_category = std::forward_iterator_tag
using	value_type = detail::IdType
using	difference_type = std::ptrdiff_t
using	pointer = void
using	reference = detail::IdType

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; } for_ #define for_(IT, BEG, END) Convenient for-loops using iterator. Definition Easy.h:27 zyppng::sat::LookupAttr::iterator Result iterator. Definition lookupattr.h:348 zyppng::sat::LookupAttr Lightweight attribute value lookup. Definition lookupattr.h:112 zyppng::sat::SolvAttr::updateReferenceHref static const SolvAttr updateReferenceHref Definition SolvAttr.h:143 zyppng::sat::SolvAttr::updateReference static const SolvAttr updateReference Definition SolvAttr.h:141
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 zypp::C_Str &attrname_r) const

Retrieving attribute values.
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 IdString.
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).
reference	operator* () const
iterator &	operator++ ()
iterator	operator++ (int)
bool	operator== (const iterator &rhs) const
bool	operator!= (const iterator &rhs) const
detail::CDataiterator *	get () const
	Expert backdoor.
bool	dip_equal (const detail::CDataiterator &lhs, const detail::CDataiterator &rhs) const
void	increment ()

Detailed Description

Result iterator.

Extended iterator methods valid only if not @end.

Definition at line 347 of file lookupattr.h.

Member Typedef Documentation

◆ iterator_category

using zyppng::sat::LookupAttr::iterator::iterator_category = std::forward_iterator_tag

Definition at line 350 of file lookupattr.h.

◆ value_type

using zyppng::sat::LookupAttr::iterator::value_type = detail::IdType

Definition at line 351 of file lookupattr.h.

◆ difference_type

using zyppng::sat::LookupAttr::iterator::difference_type = std::ptrdiff_t

Definition at line 352 of file lookupattr.h.

◆ pointer

using zyppng::sat::LookupAttr::iterator::pointer = void

Definition at line 353 of file lookupattr.h.

◆ reference

using zyppng::sat::LookupAttr::iterator::reference = detail::IdType

Definition at line 354 of file lookupattr.h.

Constructor & Destructor Documentation

◆ iterator() [1/3]

zyppng::sat::LookupAttr::iterator::iterator ( )

Definition at line 670 of file lookupattr.cc.

◆ iterator() [2/3]

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

Definition at line 673 of file lookupattr.cc.

◆ ~iterator()

zyppng::sat::LookupAttr::iterator::~iterator ( )

Definition at line 683 of file lookupattr.cc.

◆ iterator() [3/3]

zyppng::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 677 of file lookupattr.cc.

Member Function Documentation

◆ nextSkipSolvAttr()

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

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

Definition at line 330 of file lookupattr.cc.

◆ nextSkipSolvable()

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

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

Definition at line 333 of file lookupattr.cc.

◆ nextSkipRepo()

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

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

Definition at line 336 of file lookupattr.cc.

◆ skipSolvAttr()

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

inline

Immediately advance to the next SolvAttr.

Definition at line 368 of file lookupattr.h.

◆ skipSolvable()

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

inline

Immediately advance to the next Solvable.

Definition at line 372 of file lookupattr.h.

◆ skipRepo()

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

inline

Immediately advance to the next Repository.

Definition at line 376 of file lookupattr.h.

◆ stayInThisSolvable()

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

Stop after all matches in the current Solvable are processed.

Definition at line 339 of file lookupattr.cc.

◆ stayInThisRepo()

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

Stop after all matches in the current Repository are processed.

Definition at line 342 of file lookupattr.cc.

◆ inRepo()

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

The current Repository.

CLASS NAME : LookupAttr::iterator.

Definition at line 321 of file lookupattr.cc.

◆ inSolvable()

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

The current Solvable.

Definition at line 324 of file lookupattr.cc.

◆ inSolvAttr()

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

The current SolvAttr.

Definition at line 327 of file lookupattr.cc.

◆ atEnd()

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

inline

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

Definition at line 398 of file lookupattr.h.

◆ solvAttrType()

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

The current SolvAttr type.

Definition at line 345 of file lookupattr.cc.

◆ solvAttrNumeric()

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

Whether this is a numeric attribute (incl.

boolean).

Definition at line 348 of file lookupattr.cc.

◆ solvAttrString()

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

Whether this is a string attribute.

Definition at line 360 of file lookupattr.cc.

◆ solvAttrIdString()

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

Whether this string attribute is available as IdString.

Definition at line 375 of file lookupattr.cc.

◆ solvAttrCheckSum()

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

Whether this is a CheckSum attribute.

Definition at line 388 of file lookupattr.cc.

◆ solvAttrSubEntry()

bool zyppng::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 416 of file lookupattr.cc.

◆ subEmpty()

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

Whether the sub-structure is empty.

Definition at line 419 of file lookupattr.cc.

◆ subSize()

LookupAttr::size_type zyppng::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 422 of file lookupattr.cc.

◆ subBegin()

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

Iterator to the begin of a sub-structure.

See also: solvAttrSubEntry

Definition at line 430 of file lookupattr.cc.

◆ subEnd()

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

Iterator behind the end of a sub-structure.

See also: solvAttrSubEntry

Definition at line 452 of file lookupattr.cc.

◆ subFind() [1/2]

LookupAttr::iterator zyppng::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 457 of file lookupattr.cc.

◆ subFind() [2/2]

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

Definition at line 468 of file lookupattr.cc.

◆ asInt()

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

Conversion to numeric types.

Definition at line 499 of file lookupattr.cc.

◆ asUnsigned()

unsigned zyppng::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 514 of file lookupattr.cc.

◆ asBool()

bool zyppng::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 532 of file lookupattr.cc.

◆ asUnsignedLL()

unsigned long long zyppng::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 517 of file lookupattr.cc.

◆ c_str()

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

Conversion to string types.

Definition at line 536 of file lookupattr.cc.

◆ asString()

std::string zyppng::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 566 of file lookupattr.cc.

◆ idStr()

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

As IdString.

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

Definition at line 620 of file lookupattr.cc.

◆ id()

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

inline

Definition at line 514 of file lookupattr.h.

◆ asCheckSum()

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

As CheckSum.

Definition at line 636 of file lookupattr.cc.

◆ asType()

template<class Tp>

Tp zyppng::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 526 of file lookupattr.h.

◆ operator=()

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

Definition at line 686 of file lookupattr.cc.

◆ operator*()

detail::IdType zyppng::sat::LookupAttr::iterator::operator* ( ) const

Definition at line 702 of file lookupattr.cc.

◆ operator++() [1/2]

LookupAttr::iterator & zyppng::sat::LookupAttr::iterator::operator++ ( )

Definition at line 708 of file lookupattr.cc.

◆ operator++() [2/2]

LookupAttr::iterator zyppng::sat::LookupAttr::iterator::operator++ ( int )

Definition at line 714 of file lookupattr.cc.

◆ operator==()

bool zyppng::sat::LookupAttr::iterator::operator== ( const iterator & rhs ) const

Definition at line 721 of file lookupattr.cc.

◆ operator!=()

bool zyppng::sat::LookupAttr::iterator::operator!= ( const iterator & rhs ) const

inline

Definition at line 550 of file lookupattr.h.

◆ dip_equal()

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

private

Definition at line 695 of file lookupattr.cc.

◆ increment()

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

private

Definition at line 727 of file lookupattr.cc.

◆ get()

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

inline

Expert backdoor.

Definition at line 559 of file lookupattr.h.

Member Data Documentation

◆ _dip

detail::DIWrap zyppng::sat::LookupAttr::iterator::_dip

private

Definition at line 562 of file lookupattr.h.

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

zypp/ng/sat/lookupattr.h
zypp/ng/sat/lookupattr.cc

Public Types

Public Member Functions

Retrieving attribute values.

Detailed Description

Member Typedef Documentation

◆ iterator_category

◆ value_type

◆ difference_type

◆ pointer

◆ reference

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()

◆ operator=()

◆ operator*()

◆ operator++() [1/2]

◆ operator++() [2/2]

◆ operator==()

◆ operator!=()

◆ dip_equal()

◆ increment()

◆ get()

Member Data Documentation

◆ _dip