zipios::ZipInputStream(3) Library Functions Manual zipios::ZipInputStream(3)NAME
zipios::ZipInputStream -
SYNOPSIS
#include <zipinputstream.h>
Inherits istream.
Public Member Functions
ZipInputStream (istream &is, streampos pos=0)
ZipInputStream constructor.
ZipInputStream (const string &filename, streampos pos=0)
ZipInputStream constructor.
int available ()
void closeEntry ()
Closes the current entry, and positions the stream read pointer at the beginning of the next entry (if there is one).
void close ()
Closes the istream.
ConstEntryPointer getNextEntry ()
virtual ~ZipInputStream ()
Destructor.
Detailed Description
ZipInputStream is an istream that gets it's input from a zip file. The interface approximates the interface of the Java ZipInputStream.
Definition at line 20 of file zipinputstream.h.
Constructor &; Destructor Documentation
zipios::ZipInputStream::ZipInputStream (istream &is, streampospos = 0) [explicit]
ZipInputStream constructor. Parameters:
is istream from which the compressed zip archive can be read.
pos position to reposition the istream to before reading.
zipios::ZipInputStream::ZipInputStream (const string &filename, streampospos = 0) [explicit]
ZipInputStream constructor. filename of a valid zip file.
Parameters:
pos position to reposition the istream to before reading.
zipios::ZipInputStream::~ZipInputStream () [virtual]
Destructor.
Definition at line 53 of file zipinputstream.cpp.
Member Function Documentation
void zipios::ZipInputStream::close ()
Closes the istream.
Definition at line 41 of file zipinputstream.cpp.
void zipios::ZipInputStream::closeEntry ()
Closes the current entry, and positions the stream read pointer at the beginning of the next entry (if there is one).
Definition at line 37 of file zipinputstream.cpp.
ConstEntryPointer zipios::ZipInputStream::getNextEntry () Opens the next entry in the zip archive and returns a const pointer to a FileEntry
object for the entry. For new instances this method has to be called once before you can read from the first entry.
Returns:
a const FileEntry * containing information about the (now) current entry.
Definition at line 48 of file zipinputstream.cpp.
Author
Generated automatically by Doxygen for Zipios++ from the source code.
Zipios++ Mon Oct 10 2011 zipios::ZipInputStream(3)
Check Out this Related Man Page
zipios::CollectionCollection(3) Library Functions Manual zipios::CollectionCollection(3)NAME
zipios::CollectionCollection -
SYNOPSIS
#include <collcoll.h>
Inherits zipios::FileCollection.
Public Member Functions
CollectionCollection ()
Constructor.
CollectionCollection (const CollectionCollection &src)
Copy constructor.
const CollectionCollection & operator= (const CollectionCollection &src)
Copy assignment operator.
bool addCollection (const FileCollection &collection)
bool addCollection (FileCollection *collection)
Adds the collection pointed to by collection.
virtual void close ()
Closes the FileCollection.
virtual ConstEntries entries () const
virtual ConstEntryPointer getEntry (const string &name, MatchPath matchpath=MATCH) const
virtual istream * getInputStream (const ConstEntryPointer &entry)
virtual istream * getInputStream (const string &entry_name, MatchPath matchpath=MATCH)
Returns a pointer to an opened istream for the specified entry name.
virtual int size () const
Returns the number in entries in all collections kept by the CollectionCollection object.
virtual FileCollection * clone () const
Create a heap allocated clone of the object this method is called for.
Static Public Member Functions
static CollectionCollection & inst ()
Protected Member Functions
void getEntry (const string &name, ConstEntryPointer &cep, std::vector< FileCollection * >::const_iterator &it, MatchPath matchpath=MATCH)
const
A protected getEntry member function, that not only finds an entry that match the name, if such an entry exists in the collection, it
also returns, which collection it was found in.
Protected Attributes
vector< FileCollection * > _collections
Detailed Description
CollectionCollection is a FileCollection that consists of an arbitrary number of FileCollections. With a CollectionCollection the user can
use multiple FileCollections transparently, making it easy for a program to keep some of its files in a zip archive and others stored in
ordinary files. CollectionCollection can be used to create a simple virtual filesystem, where all collections are mounted in /. If more
than one collection contain a file with the same path only the one in the first added collection will be accessible.
Definition at line 26 of file collcoll.h.
Constructor &; Destructor Documentation
zipios::CollectionCollection::CollectionCollection () [explicit]
Constructor.
Definition at line 16 of file collcoll.cpp.
zipios::CollectionCollection::CollectionCollection (const CollectionCollection &src) [inline]
Copy constructor.
Definition at line 118 of file collcoll.h.
Member Function Documentation
bool zipios::CollectionCollection::addCollection (const FileCollection &collection) Adds a collection.
Parameters:
collection The collection to add.
Returns:
true if the collection was added succesfully and the added collection is valid.
Definition at line 21 of file collcoll.cpp.
bool zipios::CollectionCollection::addCollection (FileCollection *collection)
Adds the collection pointed to by collection. The CollectionCollection will call delete on the pointer when it is destructed, so the caller
should make absolutely sure to only pass in a collection created with new and be sure to leave it alone after adding it. If the collection
is not added false is returned and the caller remains responsible for the collection pointed to by collection.
Parameters:
collection A pointer to the collection to add.
Returns:
true if the collection was added succesfully and the added collection is valid.
Definition at line 31 of file collcoll.cpp.
FileCollection * zipios::CollectionCollection::clone () const [virtual]
Create a heap allocated clone of the object this method is called for. The caller is responsible for deallocating the clone when he is done
with it.
Returns:
A heap allocated copy of the object this method is called for.
Implements zipios::FileCollection.
Definition at line 108 of file collcoll.cpp.
void zipios::CollectionCollection::close () [virtual]
Closes the FileCollection.
Implements zipios::FileCollection.
Definition at line 41 of file collcoll.cpp.
ConstEntries zipios::CollectionCollection::entries () const [virtual] Returns a vector of const pointers to the entries in the FileCollection.
Returns:
a ConstEntries containing the entries of the FileCollection.
Exceptions:
InvalidStateException Thrown if the collection is invalid.
Reimplemented from zipios::FileCollection.
Definition at line 46 of file collcoll.cpp.
void zipios::CollectionCollection::getEntry (const string &name, ConstEntryPointer &cep, std::vector< FileCollection * >::const_iterator &it,
MatchPathmatchpath = MATCH) const [protected]
A protected getEntry member function, that not only finds an entry that match the name, if such an entry exists in the collection, it also
returns, which collection it was found in.
Definition at line 123 of file collcoll.cpp.
ConstEntryPointer zipios::CollectionCollection::getEntry (const string &name, MatchPathmatchpath = MATCH) const [virtual] Returns a
ConstEntryPointer to a FileEntry object for the entry with the specified name. To ignore the path part of the filename in search of a
match, specify FileCollection::IGNORE as the second argument.
Parameters:
name A string containing the name of the entry to get.
matchpath Speficy MATCH, if the path should match as well, specify IGNORE, if the path should be ignored.
Returns:
A ConstEntryPointer to the found entry. The returned pointer equals zero if no entry is found.
Exceptions:
InvalidStateException Thrown if the collection is invalid.
Reimplemented from zipios::FileCollection.
Definition at line 58 of file collcoll.cpp.
istream * zipios::CollectionCollection::getInputStream (const ConstEntryPointer &entry) [virtual] Returns a pointer to an opened istream for
the specified FileEntry. It is the callers responsibility to delete the stream when he is done with it. Returns 0, if there is no such
FileEntry in the FileCollection.
Parameters:
entry A ConstEntryPointer to the FileEntry to get an istream to.
Returns:
an open istream for the specified entry. The istream is allocated on heap and it is the users responsibility to delete it when he is
done with it.
Exceptions:
InvalidStateException Thrown if the collection is invalid.
Implements zipios::FileCollection.
Definition at line 72 of file collcoll.cpp.
istream * zipios::CollectionCollection::getInputStream (const string &entry_name, MatchPathmatchpath = MATCH) [virtual]
Returns a pointer to an opened istream for the specified entry name. It is the callers responsibility to delete the stream when he is done
with it. Returns 0, if there is no entry with the specified name in the FileCollection.
Parameters:
matchpath Speficy MATCH, if the path should match as well, specify IGNORE, if the path should be ignored.
Returns:
an open istream for the specified entry. The istream is allocated on heap and it is the users responsibility to delete it when he is
done with it.
Exceptions:
InvalidStateException Thrown if the collection is invalid.
Implements zipios::FileCollection.
Definition at line 80 of file collcoll.cpp.
CollectionCollection & zipios::CollectionCollection::inst () [inline, static] This static method provides a singleton instance of a
CollectionCollection. The instance is instantiated the first time the method is called.
Returns:
A pointer to a singleton CollectionCollection instance.
Definition at line 111 of file collcoll.h.
const CollectionCollection & zipios::CollectionCollection::operator= (const CollectionCollection &src) [inline]
Copy assignment operator.
Definition at line 129 of file collcoll.h.
int zipios::CollectionCollection::size () const [virtual]
Returns the number in entries in all collections kept by the CollectionCollection object.
Reimplemented from zipios::FileCollection.
Definition at line 98 of file collcoll.cpp.
Author
Generated automatically by Doxygen for Zipios++ from the source code.
Zipios++ Mon Oct 10 2011 zipios::CollectionCollection(3)