SYNOPSIS

#include <fileentry.h>

Inherited by zipios::BasicEntry, and zipios::ZipLocalEntry.

Classes

class MatchFileName

Function object to be used with the STL find_if algorithm to find a FileEntry in a container, which name (as obtained with FileEntry::getFileName()) is identical to the name specified in the MatchName constructor. class MatchName

Function object to be used with the STL find_if algorithm to find a FileEntry in a container, which name (as obtained with FileEntry::getName()) is identical to the name specified in the MatchName constructor.

Public Member Functions

virtual string getComment () const =0

Returns the comment of the entry, if it has one. virtual uint32 getCompressedSize () const =0

Returns the compressed size of the entry. virtual uint32 getCrc () const =0

Returns the Crc for the entry, if it has one. virtual vector< unsigned char > getExtra () const =0

Returns a vector of bytes of extra data that may be stored with the entry. virtual StorageMethod getMethod () const =0

Returns the method used to store the entry in the FileCollection. virtual string getName () const =0

Returns the full filename of the entry, including a path if the entry is stored in a subfolder. virtual string getFileName () const =0

Returns the filename of the entry. virtual uint32 getSize () const =0

Returns the (uncompressed) size of the entry data. virtual int getTime () const =0

Returns the date and time of FIXME: what? virtual bool isValid () const =0

Any method or operator that initializes a FileEntry may set a flag, that specifies whether the read entry is valid or not. virtual bool isDirectory () const =0

Returns true if the entry is a directory. virtual void setComment (const string &comment)=0

Sets the comment field for the FileEntry. virtual void setCompressedSize (uint32 size)=0

Set the compressed size field of the entry. virtual void setCrc (uint32 crc)=0

Sets the crc field. virtual void setExtra (const vector< unsigned char > &extra)=0

Sets the extra field. virtual void setMethod (StorageMethod method)=0

Sets the storage method field for the entry. virtual void setName (const string &name)=0

Sets the name field for the entry. virtual void setSize (uint32 size)=0

Sets the size field for the entry. virtual void setTime (int time)=0

Sets the time field for the entry. virtual string toString () const =0

Returns a human-readable string representation of the entry. virtual FileEntry * clone () const =0

Create a heap allocated clone of the object this method is called for. virtual ~FileEntry ()

FileEntry destructor.

Protected Member Functions

void ref () const

unsigned int unref () const

Protected Attributes

ReferenceCount< FileEntry > _refcount

Friends

class SimpleSmartPointer< FileEntry >

class SimpleSmartPointer< const FileEntry >

Detailed Description

A FileEntry represents an entry in a FileCollection.

The interface is a copy of the ZipEntry interface from the java.util.zip package. The name has been changed to FileEntry, as FileCollection is a more general abstraction, that covers other types of file collections than just zip files.

Definition at line 52 of file fileentry.h.

Constructor & Destructor Documentation

virtual zipios::FileEntry::~FileEntry ()\fC [inline, virtual]\fP

FileEntry destructor.

Definition at line 163 of file fileentry.h.

Member Function Documentation

virtual \fBFileEntry\fP* zipios::FileEntry::clone () const\fC [pure virtual]\fP

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.

Implemented in zipios::BasicEntry, zipios::ZipLocalEntry, and zipios::ZipCDirEntry.

virtual string zipios::FileEntry::getComment () const\fC [pure virtual]\fP

Returns the comment of the entry, if it has one. Otherwise it returns an empty string.

Returns:

the comment associated with the entry, if there is one.

Implemented in zipios::BasicEntry, zipios::ZipLocalEntry, and zipios::ZipCDirEntry.

virtual uint32 zipios::FileEntry::getCompressedSize () const\fC [pure virtual]\fP

Returns the compressed size of the entry. If the entry is not stored in a compressed format, the uncompressed size is returned.

Returns:

the compressed size of the entry. If the entry is stored without compression the uncompressed size is returned.

Implemented in zipios::BasicEntry, and zipios::ZipLocalEntry.

virtual uint32 zipios::FileEntry::getCrc () const\fC [pure virtual]\fP

Returns the Crc for the entry, if it has one. FIXME: what is returned if it doesn't have one?

Returns:

the Crc for the entry, if it has one.

Implemented in zipios::BasicEntry, and zipios::ZipLocalEntry.

virtual vector< unsigned char > zipios::FileEntry::getExtra () const\fC [pure virtual]\fP

Returns a vector of bytes of extra data that may be stored with the entry. Returns:

A vector< unsigned char > of extra bytes that may potentially be associated with an entry.

Implemented in zipios::BasicEntry, and zipios::ZipLocalEntry.

virtual string zipios::FileEntry::getFileName () const\fC [pure virtual]\fP

Returns the filename of the entry. Returns:

Returns the filename of the entry.

Implemented in zipios::BasicEntry, and zipios::ZipLocalEntry.

virtual StorageMethod zipios::FileEntry::getMethod () const\fC [pure virtual]\fP

Returns the method used to store the entry in the FileCollection. Returns:

the storage method used to store the entry in the collection.

See also:

StorageMethod.

Implemented in zipios::BasicEntry, and zipios::ZipLocalEntry.

virtual string zipios::FileEntry::getName () const\fC [pure virtual]\fP

Returns the full filename of the entry, including a path if the entry is stored in a subfolder. Returns:

the filename of the entry, including path if the entry is stored in a sub-folder.

Implemented in zipios::BasicEntry, and zipios::ZipLocalEntry.

virtual uint32 zipios::FileEntry::getSize () const\fC [pure virtual]\fP

Returns the (uncompressed) size of the entry data. Returns:

Returns the (uncompressed) size of the entry.

Implemented in zipios::BasicEntry, and zipios::ZipLocalEntry.

virtual int zipios::FileEntry::getTime () const\fC [pure virtual]\fP

Returns the date and time of FIXME: what? Returns:

the date and time of the entry.

Implemented in zipios::BasicEntry, and zipios::ZipLocalEntry.

virtual bool zipios::FileEntry::isDirectory () const\fC [pure virtual]\fP

Returns true if the entry is a directory. A directory entry is an entry which name ends with a separator ('/' for Unix systems, '\' for Windows and DOS systems.

Returns:

true if the entry is a directory.

Implemented in zipios::BasicEntry, and zipios::ZipLocalEntry.

virtual bool zipios::FileEntry::isValid () const\fC [pure virtual]\fP

Any method or operator that initializes a FileEntry may set a flag, that specifies whether the read entry is valid or not. If it isn't this method returns false.

Returns:

true if the FileEntry has been parsed succesfully.

Implemented in zipios::BasicEntry, and zipios::ZipLocalEntry.

virtual void zipios::FileEntry::setComment (const string &comment)\fC [pure virtual]\fP

Sets the comment field for the FileEntry. Parameters:

comment string with the new comment.

Implemented in zipios::BasicEntry, zipios::ZipLocalEntry, and zipios::ZipCDirEntry.

virtual void zipios::FileEntry::setCompressedSize (uint32size)\fC [pure virtual]\fP

Set the compressed size field of the entry. Parameters:

size value to set the compressed size field of the entry to.

Implemented in zipios::BasicEntry, and zipios::ZipLocalEntry.

virtual void zipios::FileEntry::setCrc (uint32crc)\fC [pure virtual]\fP

Sets the crc field. Parameters:

crc value to set the crc field to.

Implemented in zipios::BasicEntry, and zipios::ZipLocalEntry.

virtual void zipios::FileEntry::setExtra (const vector< unsigned char > &extra)\fC [pure virtual]\fP

Sets the extra field. Parameters:

extra the extra field is set to this value.

Implemented in zipios::BasicEntry, and zipios::ZipLocalEntry.

virtual void zipios::FileEntry::setMethod (StorageMethodmethod)\fC [pure virtual]\fP

Sets the storage method field for the entry. Parameters:

method the method field is set to the specified value.

Implemented in zipios::BasicEntry, and zipios::ZipLocalEntry.

virtual void zipios::FileEntry::setName (const string &name)\fC [pure virtual]\fP

Sets the name field for the entry. Parameters:

name the name field is set to the specified value.

Implemented in zipios::BasicEntry, and zipios::ZipLocalEntry.

virtual void zipios::FileEntry::setSize (uint32size)\fC [pure virtual]\fP

Sets the size field for the entry. Parameters:

size the size field is set to this value.

Implemented in zipios::BasicEntry, and zipios::ZipLocalEntry.

virtual void zipios::FileEntry::setTime (inttime)\fC [pure virtual]\fP

Sets the time field for the entry. Parameters:

time the time field is set to the specified value.

Implemented in zipios::BasicEntry, and zipios::ZipLocalEntry.

virtual string zipios::FileEntry::toString () const\fC [pure virtual]\fP

Returns a human-readable string representation of the entry. Returns:

a human-readable string representation of the entry.

Implemented in zipios::BasicEntry, zipios::ZipLocalEntry, and zipios::ZipCDirEntry.

Author

Generated automatically by Doxygen for Zipios++ from the source code.