dcpp::io::IFileList Class Reference

Provides a list of files and folders. More...

#include <duckcpp/core/engine/IFileList.hpp>

Inheritance diagram for dcpp::io::IFileList:

Collaboration diagram for dcpp::io::IFileList:

Public Member Functions
virtual dcpp::uint32_kt	getFileCount () const =0
	Get the number of files in the filelist.
virtual const dcpp::io::path &	getFileName (dcpp::uint32_kt index) const =0
	Gets the name of a file in the list, based on an index.
virtual const dcpp::io::path &	getFullFileName (dcpp::uint32_kt index) const =0
	Gets the full name of a file in the list including the path, based on an index.
virtual dcpp::uint32_kt	getFileSize (dcpp::uint32_kt index) const =0
	Returns the size of a file in the file list, based on an index.
virtual dcpp::uint32_kt	getFileOffset (dcpp::uint32_kt index) const =0
	Returns the file offset of a file in the file list, based on an index.
virtual dcpp::uint32_kt	getID (dcpp::uint32_kt index) const =0
	Returns the ID of a file in the file list, based on an index.
virtual bool	isDirectory (dcpp::uint32_kt index) const =0
	Check if the file is a directory.
virtual dcpp::int32_kt	findFile (const dcpp::io::path &filename, bool isFolder=false) const =0
	Searches for a file or folder in the list.
virtual const dcpp::io::path &	getPath () const =0
	Returns the base path of the file list.
virtual dcpp::uint32_kt	addItem (const dcpp::io::path &fullPath, dcpp::uint32_kt offset, dcpp::uint32_kt size, bool isDirectory, dcpp::uint32_kt id=0)=0
	Add as a file or folder to the list.
virtual void	sort ()=0
	Sorts the file list. You should call this after adding any items to the file list.
Public Member Functions inherited from dcpp::IReferenceCounted
	IReferenceCounted ()
	Constructor.
virtual	~IReferenceCounted ()
	Destructor.
void	grab () const
	Grabs the object. Increments the reference counter by one.
bool	drop () const
	Drops the object. Decrements the reference counter by one.
dcpp::int32_kt	getReferenceCount () const
	Get the reference count.
const dcpp::char_kt *	getDebugName () const
	Returns the debug name of the object.

Additional Inherited Members
Protected Member Functions inherited from dcpp::IReferenceCounted
void	setDebugName (const dcpp::char_kt *newName)
	Sets the debug name of the object.

Detailed Description

Provides a list of files and folders.

File lists usually contain a list of all files in a given folder, but can also contain a complete directory class.

Member Function Documentation

addItem()

virtual dcpp::uint32_kt dcpp::io::IFileList::addItem ( const dcpp::io::path &  fullPath, dcpp::uint32_kt  offset, dcpp::uint32_kt  size, bool  isDirectory, dcpp::uint32_kt  id = 0  )

pure virtual

Add as a file or folder to the list.

Parameters

fullPath	The file name including path, from the root of the file list.
isDirectory	True if this is a directory rather than a file.
offset	The file offset inside an archive
size	The size of the file in bytes.
id	The ID of the file in the archive which owns it

findFile()

virtual dcpp::int32_kt dcpp::io::IFileList::findFile ( const dcpp::io::path &  filename, bool  isFolder = false  ) const

pure virtual

Searches for a file or folder in the list.

Searches for a file by name

Parameters

filename	The name of the file to search for.
isFolder	True if you are searching for a directory path, false if you are searching for a file

Returns

Returns the index of the file in the file list, or -1 if no matching name name was found.

getFileCount()

virtual dcpp::uint32_kt dcpp::io::IFileList::getFileCount ( ) const

pure virtual

Get the number of files in the filelist.

Returns

Amount of files and directories in the file list.

getFileName()

virtual const dcpp::io::path & dcpp::io::IFileList::getFileName ( dcpp::uint32_kt  index ) const

pure virtual

Gets the name of a file in the list, based on an index.

The path is not included in this name. Use getFullFileName for this.

Parameters

index

is the zero based index of the file which name should be returned. The index must be less than the amount getFileCount() returns.

Returns

File name of the file. Returns 0, if an error occurred.

getFileOffset()

virtual dcpp::uint32_kt dcpp::io::IFileList::getFileOffset ( dcpp::uint32_kt  index ) const

pure virtual

Returns the file offset of a file in the file list, based on an index.

Parameters

index

is the zero based index of the file which should be returned. The index must be less than the amount getFileCount() returns.

Returns

The offset of the file in bytes.

getFileSize()

virtual dcpp::uint32_kt dcpp::io::IFileList::getFileSize ( dcpp::uint32_kt  index ) const

pure virtual

Returns the size of a file in the file list, based on an index.

Parameters

index

is the zero based index of the file which should be returned. The index must be less than the amount getFileCount() returns.

Returns

The size of the file in bytes.

getFullFileName()

virtual const dcpp::io::path & dcpp::io::IFileList::getFullFileName ( dcpp::uint32_kt  index ) const

pure virtual

Gets the full name of a file in the list including the path, based on an index.

Parameters

index

is the zero based index of the file which name should be returned. The index must be less than the amount getFileCount() returns.

Returns

File name of the file. Returns 0 if an error occurred.

getID()

virtual dcpp::uint32_kt dcpp::io::IFileList::getID ( dcpp::uint32_kt  index ) const

pure virtual

Returns the ID of a file in the file list, based on an index.

This optional ID can be used to link the file list entry to information held elsewhere. For example this could be an index in an IFileArchive, linking the entry to its data offset, uncompressed size and CRC.

Parameters

index

is the zero based index of the file which should be returned. The index must be less than the amount getFileCount() returns.

Returns

The ID of the file.

isDirectory()

virtual bool dcpp::io::IFileList::isDirectory ( dcpp::uint32_kt  index ) const

pure virtual

Check if the file is a directory.

Parameters

index

The zero based index which will be checked. The index must be less than the amount getFileCount() returns.

Returns

True if the file is a directory, else false.

---

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

• include/duckcpp/core/engine/IFileList.hpp