APT::PackageContainer< Container > Class Template Reference

Simple wrapper around a container class like std::set to provide a similar interface to a set of packages as to the complete set of all packages in the pkgCache. More...

#include <cacheset.h>

Inheritance diagram for APT::PackageContainer< Container >:

Collaboration diagram for APT::PackageContainer< Container >:

Classes
class	const_iterator
	smell like a pkgCache::PkgIterator More...
class	iterator

Public Types
enum	Constructor {   UNKNOWN,   REGEX,   TASK }

Public Member Functions
	PackageContainer ()
	PackageContainer (Constructor const &by)
const_iterator	begin () const
iterator	begin ()
void	clear ()
bool	empty () const
const_iterator	end () const
iterator	end ()
void	erase (iterator position)
iterator &	erase (iterator &position, bool)
size_t	erase (const pkgCache::PkgIterator x)
void	erase (iterator first, iterator last)
const_iterator	find (pkgCache::PkgIterator const &P) const
Constructor	getConstructor () const
bool	insert (pkgCache::PkgIterator const &P)
template<class Cont >
void	insert (PackageContainer< Cont > const &pkgcont)
void	insert (const_iterator begin, const_iterator end)
template<>
void	insert (PackageContainer< Cont > const &pkgcont)
template<>
bool	insert (pkgCache::PkgIterator const &P)
template<>
void	insert (const_iterator begin, const_iterator end)
void	setConstructor (Constructor const &by)
size_t	size () const

Static Public Member Functions
static bool	FromCommandLine (PackageContainerInterface *const pci, pkgCacheFile &Cache, const char **cmdline, CacheSetHelper &helper)
static PackageContainer	FromCommandLine (pkgCacheFile &Cache, const char **cmdline, CacheSetHelper &helper)
	returns all packages specified on the commandline More...
static PackageContainer	FromCommandLine (pkgCacheFile &Cache, const char **cmdline)
static bool	FromGroup (PackageContainerInterface *const pci, pkgCacheFile &Cache, std::string pattern, CacheSetHelper &helper)
static bool	FromModifierCommandLine (unsigned short &modID, PackageContainerInterface *const pci, pkgCacheFile &Cache, const char *cmdline, std::list< Modifier > const &mods, CacheSetHelper &helper)
static pkgCache::PkgIterator	FromName (pkgCacheFile &Cache, std::string const &pattern, CacheSetHelper &helper)
	returns a package specified by a string More...
static pkgCache::PkgIterator	FromName (pkgCacheFile &Cache, std::string const &pattern)
static bool	FromRegEx (PackageContainerInterface *const pci, pkgCacheFile &Cache, std::string pattern, CacheSetHelper &helper)
static PackageContainer	FromRegEx (pkgCacheFile &Cache, std::string pattern, CacheSetHelper &helper)
	returns all packages in the cache whose name matchs a given pattern More...
static PackageContainer	FromRegEx (pkgCacheFile &Cache, std::string const &pattern)
static bool	FromString (PackageContainerInterface *const pci, pkgCacheFile &Cache, std::string const &pattern, CacheSetHelper &helper)
static PackageContainer	FromString (pkgCacheFile &Cache, std::string const &pattern, CacheSetHelper &helper)
	returns all packages specified by a string More...
static PackageContainer	FromString (pkgCacheFile &Cache, std::string const &pattern)
static bool	FromTask (PackageContainerInterface *const pci, pkgCacheFile &Cache, std::string pattern, CacheSetHelper &helper)
static PackageContainer	FromTask (pkgCacheFile &Cache, std::string const &pattern, CacheSetHelper &helper)
	returns all packages in the cache who belong to the given task More...
static PackageContainer	FromTask (pkgCacheFile &Cache, std::string const &pattern)
static std::map< unsigned short, PackageContainer >	GroupedFromCommandLine (pkgCacheFile &Cache, const char **cmdline, std::list< Modifier > const &mods, unsigned short const &fallback, CacheSetHelper &helper)
	group packages by a action modifiers More...
static std::map< unsigned short, PackageContainer >	GroupedFromCommandLine (pkgCacheFile &Cache, const char **cmdline, std::list< Modifier > const &mods, unsigned short const &fallback)

Private Attributes
Container	_cont
Constructor	ConstructedBy

Detailed Description

template<class Container>
class APT::PackageContainer< Container >

Simple wrapper around a container class like std::set to provide a similar interface to a set of packages as to the complete set of all packages in the pkgCache.

Member Enumeration Documentation

enum APT::PackageContainerInterface::Constructor

inherited

Enumerator
UNKNOWN
REGEX
TASK

Constructor & Destructor Documentation

template<class Container>

APT::PackageContainer< Container >::PackageContainer ( )

inline

template<class Container>

APT::PackageContainer< Container >::PackageContainer ( Constructor const &  by )

inline

Member Function Documentation

template<class Container>

const_iterator APT::PackageContainer< Container >::begin ( ) const

inline

References APT::PackageContainer< Container >::_cont.

Referenced by APT::PackageContainer< Container >::insert().

Here is the caller graph for this function:

template<class Container>

iterator APT::PackageContainer< Container >::begin ( )

inline

References APT::PackageContainer< Container >::_cont.

template<class Container>

void APT::PackageContainer< Container >::clear ( )

inlinevirtual

Implements APT::PackageContainerInterface.

References APT::PackageContainer< Container >::_cont.

template<class Container>

bool APT::PackageContainer< Container >::empty ( ) const

inlinevirtual

Implements APT::PackageContainerInterface.

References APT::PackageContainer< Container >::_cont.

template<class Container>

const_iterator APT::PackageContainer< Container >::end ( ) const

inline

References APT::PackageContainer< Container >::_cont.

Referenced by APT::PackageContainer< Container >::insert().

Here is the caller graph for this function:

template<class Container>

iterator APT::PackageContainer< Container >::end ( )

inline

References APT::PackageContainer< Container >::_cont.

template<class Container>

void APT::PackageContainer< Container >::erase ( iterator  position )

inline

References APT::PackageContainer< Container >::_cont.

template<class Container>

iterator& APT::PackageContainer< Container >::erase ( iterator &  position, bool    )

inline

References APT::PackageContainer< Container >::_cont.

template<class Container>

size_t APT::PackageContainer< Container >::erase ( const pkgCache::PkgIterator  x )

inline

References APT::PackageContainer< Container >::_cont.

template<class Container>

void APT::PackageContainer< Container >::erase ( iterator  first, iterator  last  )

inline

References APT::PackageContainer< Container >::_cont.

template<class Container>

const_iterator APT::PackageContainer< Container >::find ( pkgCache::PkgIterator const &  P ) const

inline

References APT::PackageContainer< Container >::_cont.

static bool APT::PackageContainerInterface::FromCommandLine ( PackageContainerInterface *const  pci, pkgCacheFile &  Cache, const char **  cmdline, CacheSetHelper &  helper  )

staticinherited

Referenced by APT::PackageContainer< Container >::FromCommandLine().

Here is the caller graph for this function:

template<class Container>

static PackageContainer APT::PackageContainer< Container >::FromCommandLine ( pkgCacheFile &  Cache, const char **  cmdline, CacheSetHelper &  helper  )

inlinestatic

returns all packages specified on the commandline

Get all package names from the commandline and executes regex's if needed. No special package command is supported, just plain names.

Parameters

Cache	the packages are in
cmdline	Command line the package names should be extracted from
helper	responsible for error and message handling

References APT::PackageContainerInterface::FromCommandLine().

Referenced by APT::PackageContainer< Container >::FromCommandLine().

Here is the call graph for this function:

Here is the caller graph for this function:

template<class Container>

static PackageContainer APT::PackageContainer< Container >::FromCommandLine ( pkgCacheFile &  Cache, const char **  cmdline  )

inlinestatic

References APT::PackageContainer< Container >::FromCommandLine().

Here is the call graph for this function:

static bool APT::PackageContainerInterface::FromGroup ( PackageContainerInterface *const  pci, pkgCacheFile &  Cache, std::string  pattern, CacheSetHelper &  helper  )

staticinherited

static bool APT::PackageContainerInterface::FromModifierCommandLine ( unsigned short &  modID, PackageContainerInterface *const  pci, pkgCacheFile &  Cache, const char *  cmdline, std::list< Modifier > const &  mods, CacheSetHelper &  helper  )

staticinherited

Referenced by APT::PackageContainer< Container >::GroupedFromCommandLine().

Here is the caller graph for this function:

template<class Container>

static pkgCache::PkgIterator APT::PackageContainer< Container >::FromName ( pkgCacheFile &  Cache, std::string const &  pattern, CacheSetHelper &  helper  )

inlinestatic

returns a package specified by a string

Parameters

Cache	the package is in
pattern	String the package name should be extracted from
helper	responsible for error and message handling

References APT::PackageContainerInterface::FromName().

Here is the call graph for this function:

template<class Container>

static pkgCache::PkgIterator APT::PackageContainer< Container >::FromName ( pkgCacheFile &  Cache, std::string const &  pattern  )

inlinestatic

References APT::PackageContainerInterface::FromName().

Here is the call graph for this function:

static bool APT::PackageContainerInterface::FromRegEx ( PackageContainerInterface *const  pci, pkgCacheFile &  Cache, std::string  pattern, CacheSetHelper &  helper  )

staticinherited

Referenced by APT::PackageContainer< Container >::FromRegEx().

Here is the caller graph for this function:

template<class Container>

static PackageContainer APT::PackageContainer< Container >::FromRegEx ( pkgCacheFile &  Cache, std::string  pattern, CacheSetHelper &  helper  )

inlinestatic

returns all packages in the cache whose name matchs a given pattern

A simple helper responsible for executing a regular expression on all package names in the cache. Optional it prints a a notice about the packages chosen cause of the given package.

Parameters

Cache	the packages are in
pattern	regular expression for package names
helper	responsible for error and message handling

References APT::PackageContainerInterface::FromRegEx(), and APT::PackageContainerInterface::REGEX.

Referenced by APT::PackageContainer< Container >::FromRegEx().

Here is the call graph for this function:

Here is the caller graph for this function:

template<class Container>

static PackageContainer APT::PackageContainer< Container >::FromRegEx ( pkgCacheFile &  Cache, std::string const &  pattern  )

inlinestatic

References APT::PackageContainer< Container >::FromRegEx().

Here is the call graph for this function:

static bool APT::PackageContainerInterface::FromString ( PackageContainerInterface *const  pci, pkgCacheFile &  Cache, std::string const &  pattern, CacheSetHelper &  helper  )

staticinherited

Referenced by APT::PackageContainer< Container >::FromString().

Here is the caller graph for this function:

template<class Container>

static PackageContainer APT::PackageContainer< Container >::FromString ( pkgCacheFile &  Cache, std::string const &  pattern, CacheSetHelper &  helper  )

inlinestatic

returns all packages specified by a string

Parameters

Cache	the packages are in
pattern	String the package name(s) should be extracted from
helper	responsible for error and message handling

References APT::PackageContainerInterface::FromString().

Referenced by APT::PackageContainer< Container >::FromString().

Here is the call graph for this function:

Here is the caller graph for this function:

template<class Container>

static PackageContainer APT::PackageContainer< Container >::FromString ( pkgCacheFile &  Cache, std::string const &  pattern  )

inlinestatic

References APT::PackageContainer< Container >::FromString().

Here is the call graph for this function:

static bool APT::PackageContainerInterface::FromTask ( PackageContainerInterface *const  pci, pkgCacheFile &  Cache, std::string  pattern, CacheSetHelper &  helper  )

staticinherited

Referenced by APT::PackageContainer< Container >::FromTask().

Here is the caller graph for this function:

template<class Container>

static PackageContainer APT::PackageContainer< Container >::FromTask ( pkgCacheFile &  Cache, std::string const &  pattern, CacheSetHelper &  helper  )

inlinestatic

returns all packages in the cache who belong to the given task

A simple helper responsible for search for all members of a task in the cache. Optional it prints a a notice about the packages chosen cause of the given task.

Parameters

Cache	the packages are in
pattern	name of the task
helper	responsible for error and message handling

References APT::PackageContainerInterface::FromTask(), and APT::PackageContainerInterface::TASK.

Referenced by APT::PackageContainer< Container >::FromTask().

Here is the call graph for this function:

Here is the caller graph for this function:

template<class Container>

static PackageContainer APT::PackageContainer< Container >::FromTask ( pkgCacheFile &  Cache, std::string const &  pattern  )

inlinestatic

References APT::PackageContainer< Container >::FromTask().

Here is the call graph for this function:

template<class Container>

Constructor APT::PackageContainer< Container >::getConstructor ( ) const

inlinevirtual

Implements APT::PackageContainerInterface.

References APT::PackageContainer< Container >::ConstructedBy.

template<class Container>

static std::map<unsigned short, PackageContainer> APT::PackageContainer< Container >::GroupedFromCommandLine ( pkgCacheFile &  Cache, const char **  cmdline, std::list< Modifier > const &  mods, unsigned short const &  fallback, CacheSetHelper &  helper  )

inlinestatic

group packages by a action modifiers

At some point it is needed to get from the same commandline different package sets grouped by a modifier. Take apt-get install apt awesome- as an example.

Parameters

Cache	the packages are in
cmdline	Command line the package names should be extracted from
mods	list of modifiers the method should accept
fallback	the default modifier group for a package
helper	responsible for error and message handling

References APT::PackageContainerInterface::FromModifierCommandLine().

Referenced by APT::PackageContainer< Container >::GroupedFromCommandLine().

Here is the call graph for this function:

Here is the caller graph for this function:

template<class Container>

static std::map<unsigned short, PackageContainer> APT::PackageContainer< Container >::GroupedFromCommandLine ( pkgCacheFile &  Cache, const char **  cmdline, std::list< Modifier > const &  mods, unsigned short const &  fallback  )

inlinestatic

References APT::PackageContainer< Container >::GroupedFromCommandLine().

Here is the call graph for this function:

template<class Container>

bool APT::PackageContainer< Container >::insert ( pkgCache::PkgIterator const &  P )

inlinevirtual

Implements APT::PackageContainerInterface.

References APT::PackageContainer< Container >::_cont, and pkgCache::Iterator< Str, Itr >::end().

Here is the call graph for this function:

template<class Container>

template<class Cont >

void APT::PackageContainer< Container >::insert ( PackageContainer< Cont > const &  pkgcont )

inline

References APT::PackageContainer< Container >::_cont, APT::PackageContainer< Container >::begin(), and APT::PackageContainer< Container >::end().

Here is the call graph for this function:

template<class Container>

void APT::PackageContainer< Container >::insert ( const_iterator  begin, const_iterator  end  )

inline

References APT::PackageContainer< Container >::_cont.

template<>

void APT::PackageContainer< std::list< pkgCache::PkgIterator > >::insert

(

PackageContainer< Cont > const &

pkgcont

)

References APT::PackageContainer< Container >::begin(), and APT::PackageContainer< Container >::end().

Here is the call graph for this function:

template<>

bool APT::PackageContainer< std::list< pkgCache::PkgIterator > >::insert ( pkgCache::PkgIterator const &  P )

inlinevirtual

Implements APT::PackageContainerInterface.

References pkgCache::Iterator< Str, Itr >::end().

Here is the call graph for this function:

template<>

void APT::PackageContainer< std::list< pkgCache::PkgIterator > >::insert ( const_iterator  begin, const_iterator  end  )

inline

template<class Container>

void APT::PackageContainer< Container >::setConstructor ( Constructor const &  by )

inlinevirtual

Implements APT::PackageContainerInterface.

References APT::PackageContainer< Container >::ConstructedBy.

template<class Container>

size_t APT::PackageContainer< Container >::size ( ) const

inline

References APT::PackageContainer< Container >::_cont.

Member Data Documentation

template<class Container>

Container APT::PackageContainer< Container >::_cont

private

Referenced by APT::PackageContainer< Container >::begin(), APT::PackageContainer< Container >::clear(), APT::PackageContainer< Container >::empty(), APT::PackageContainer< Container >::end(), APT::PackageContainer< Container >::erase(), APT::PackageContainer< Container >::find(), APT::PackageContainer< Container >::insert(), and APT::PackageContainer< Container >::size().

template<class Container>

Constructor APT::PackageContainer< Container >::ConstructedBy

private

Referenced by APT::PackageContainer< Container >::getConstructor(), and APT::PackageContainer< Container >::setConstructor().

---

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

• /usr/include/apt-pkg/cacheset.h