Ogre::FileSystemArchive Class Reference

Specialisation of the Archive class to allow reading of files from filesystem folders / directories. More...

#include <OgreFileSystem.h>

Inheritance diagram for Ogre::FileSystemArchive:

Public Member Functions
	FileSystemArchive (const String &name, const String &archType, bool readOnly)
	~FileSystemArchive ()
DataStreamPtr	create (const String &filename)
	Create a new file (or overwrite one already there).
bool	exists (const String &filename)
	Find out if the named file exists (note: fully qualified filename required)
StringVectorPtr	find (const String &pattern, bool recursive=true, bool dirs=false)
	Find all file or directory names matching a given pattern in this archive.
FileInfoListPtr	findFileInfo (const String &pattern, bool recursive=true, bool dirs=false)
	Find all files or directories matching a given pattern in this archive and get some detailed information about them.
time_t	getModifiedTime (const String &filename)
	Retrieve the modification time of a given file.
const String &	getName (void) const
	Get the name of this archive.
const String &	getType (void) const
	Return the type code of this Archive.
bool	isCaseSensitive (void) const
	Returns whether this archive is case sensitive in the way it matches files.
virtual bool	isReadOnly () const
	Reports whether this Archive is read-only, or whether the contents can be updated.
StringVectorPtr	list (bool recursive=true, bool dirs=false)
	List all file names in the archive.
FileInfoListPtr	listFileInfo (bool recursive=true, bool dirs=false)
	List all files in the archive with accompanying information.
void	load ()
	Loads the archive.
DataStreamPtr	open (const String &filename, bool readOnly=true)
	Open a stream on a given file.
void	operator delete (void *ptr)
void	operator delete (void *ptr, const char *, int, const char *)
void	operator delete (void *ptr, void *)
void	operator delete[] (void *ptr)
void	operator delete[] (void *ptr, const char *, int, const char *)
void *	operator new (size_t sz)
void *	operator new (size_t sz, const char *file, int line, const char *func)
	operator new, with debug line info
void *	operator new (size_t sz, void *ptr)
	placement operator new
void *	operator new[] (size_t sz)
void *	operator new[] (size_t sz, const char *file, int line, const char *func)
	array operator new, with debug line info
void	remove (const String &filename)
	Delete a named file.
void	unload ()
	Unloads the archive.

Static Public Member Functions
static bool	getIgnoreHidden ()
	Get whether hidden files are ignored during filesystem enumeration.
static void	setIgnoreHidden (bool ignore)
	Set whether filesystem enumeration will include hidden files or not.

Static Public Attributes
static bool	msIgnoreHidden

Detailed Description

Specialisation of the Archive class to allow reading of files from filesystem folders / directories.

Constructor & Destructor Documentation

FileSystemArchive()

Ogre::FileSystemArchive::FileSystemArchive	(	const String &	name,
		const String &	archType,
		bool	readOnly
	)

~FileSystemArchive()

Ogre::FileSystemArchive::~FileSystemArchive

(

)

Member Function Documentation

create()

DataStreamPtr Ogre::FileSystemArchive::create ( const String &  filename )

virtual

Create a new file (or overwrite one already there).

Note

If the archive is read-only then this method will fail.

Parameters

filename

The fully qualified name of the file

Returns

A shared pointer to a DataStream which can be used to read / write the file.

Reimplemented from Ogre::Archive.

exists()

bool Ogre::FileSystemArchive::exists ( const String &  filename )

virtual

Find out if the named file exists (note: fully qualified filename required)

Implements Ogre::Archive.

find()

StringVectorPtr Ogre::FileSystemArchive::find ( const String &  pattern, bool  recursive = true, bool  dirs = false  )

virtual

Find all file or directory names matching a given pattern in this archive.

Note

This method only returns filenames, you can also retrieve other information using findFileInfo.

Parameters

pattern	The pattern to search for; wildcards (*) are allowed
recursive	Whether all paths of the archive are searched (if the archive has a concept of that)
dirs	Set to true if you want the directories to be listed instead of files

Returns

A list of filenames matching the criteria, all are fully qualified

Implements Ogre::Archive.

findFileInfo()

FileInfoListPtr Ogre::FileSystemArchive::findFileInfo ( const String &  pattern, bool  recursive = true, bool  dirs = false  )

virtual

Find all files or directories matching a given pattern in this archive and get some detailed information about them.

Parameters

pattern	The pattern to search for; wildcards (*) are allowed
recursive	Whether all paths of the archive are searched (if the archive has a concept of that)
dirs	Set to true if you want the directories to be listed instead of files

Returns

A list of file information structures for all files matching the criteria.

Implements Ogre::Archive.

getIgnoreHidden()

static bool Ogre::FileSystemArchive::getIgnoreHidden ( )

inlinestatic

Get whether hidden files are ignored during filesystem enumeration.

getModifiedTime()

time_t Ogre::FileSystemArchive::getModifiedTime ( const String &  filename )

virtual

Retrieve the modification time of a given file.

Implements Ogre::Archive.

getName()

const String & Ogre::Archive::getName ( void  ) const

inlineinherited

Get the name of this archive.

getType()

const String & Ogre::Archive::getType ( void  ) const

inlineinherited

Return the type code of this Archive.

isCaseSensitive()

bool Ogre::FileSystemArchive::isCaseSensitive ( void  ) const

virtual

Returns whether this archive is case sensitive in the way it matches files.

Implements Ogre::Archive.

isReadOnly()

virtual bool Ogre::Archive::isReadOnly ( ) const

inlinevirtualinherited

Reports whether this Archive is read-only, or whether the contents can be updated.

list()

StringVectorPtr Ogre::FileSystemArchive::list ( bool  recursive = true, bool  dirs = false  )

virtual

List all file names in the archive.

Note

This method only returns filenames, you can also retrieve other information using listFileInfo.

Parameters

recursive	Whether all paths of the archive are searched (if the archive has a concept of that)
dirs	Set to true if you want the directories to be listed instead of files

Returns

A list of filenames matching the criteria, all are fully qualified

Implements Ogre::Archive.

listFileInfo()

FileInfoListPtr Ogre::FileSystemArchive::listFileInfo ( bool  recursive = true, bool  dirs = false  )

virtual

List all files in the archive with accompanying information.

Parameters

recursive	Whether all paths of the archive are searched (if the archive has a concept of that)
dirs	Set to true if you want the directories to be listed instead of files

Returns

A list of structures detailing quite a lot of information about all the files in the archive.

Implements Ogre::Archive.

load()

void Ogre::FileSystemArchive::load ( )

virtual

Loads the archive.

Remarks

This initializes all the internal data of the class.

Warning

Do not call this function directly, it is meant to be used only by the ArchiveManager class.

Implements Ogre::Archive.

open()

DataStreamPtr Ogre::FileSystemArchive::open ( const String &  filename, bool  readOnly = true  )

virtual

Open a stream on a given file.

Note

There is no equivalent 'close' method; the returned stream controls the lifecycle of this file operation.

Parameters

filename	The fully qualified name of the file
readOnly	Whether to open the file in read-only mode or not (note, if the archive is read-only then this cannot be set to false)

Returns

A shared pointer to a DataStream which can be used to read / write the file. If the file is not present, returns a null shared pointer.

Implements Ogre::Archive.

operator delete() [1/3]

template<class Alloc >

void Ogre::AllocatedObject< Alloc >::operator delete ( void *  ptr )

inlineinherited

operator delete() [2/3]

template<class Alloc >

void Ogre::AllocatedObject< Alloc >::operator delete ( void *  ptr, const char *  , int  , const char *    )

inlineinherited

operator delete() [3/3]

template<class Alloc >

void Ogre::AllocatedObject< Alloc >::operator delete ( void *  ptr, void *    )

inlineinherited

operator delete[]() [1/2]

template<class Alloc >

void Ogre::AllocatedObject< Alloc >::operator delete[] ( void *  ptr )

inlineinherited

operator delete[]() [2/2]

template<class Alloc >

void Ogre::AllocatedObject< Alloc >::operator delete[] ( void *  ptr, const char *  , int  , const char *    )

inlineinherited

operator new() [1/3]

template<class Alloc >

void * Ogre::AllocatedObject< Alloc >::operator new ( size_t  sz )

inlineinherited

operator new() [2/3]

template<class Alloc >

void * Ogre::AllocatedObject< Alloc >::operator new ( size_t  sz, const char *  file, int  line, const char *  func  )

inlineinherited

operator new, with debug line info

operator new() [3/3]

template<class Alloc >

void * Ogre::AllocatedObject< Alloc >::operator new ( size_t  sz, void *  ptr  )

inlineinherited

placement operator new

operator new[]() [1/2]

template<class Alloc >

void * Ogre::AllocatedObject< Alloc >::operator new[] ( size_t  sz )

inlineinherited

operator new[]() [2/2]

template<class Alloc >

void * Ogre::AllocatedObject< Alloc >::operator new[] ( size_t  sz, const char *  file, int  line, const char *  func  )

inlineinherited

array operator new, with debug line info

remove()

void Ogre::FileSystemArchive::remove ( const String &  filename )

virtual

Delete a named file.

Remarks

Not possible on read-only archives

Parameters

filename

The fully qualified name of the file

Reimplemented from Ogre::Archive.

setIgnoreHidden()

static void Ogre::FileSystemArchive::setIgnoreHidden ( bool  ignore )

inlinestatic

Set whether filesystem enumeration will include hidden files or not.

This should be called prior to declaring and/or initializing filesystem resource locations. The default is true (ignore hidden files).

unload()

void Ogre::FileSystemArchive::unload ( )

virtual

Unloads the archive.

Warning

Do not call this function directly, it is meant to be used only by the ArchiveManager class.

Implements Ogre::Archive.

Member Data Documentation

msIgnoreHidden

bool Ogre::FileSystemArchive::msIgnoreHidden

static

---

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

• OgreFileSystem.h