cocos2d-x  3.0Beta0
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
FileUtilsWin32 Class Reference

Helper class to handle file operations. More...

#include <CCFileUtilsWin32.h>

Inheritance diagram for FileUtilsWin32:
FileUtils

Public Member Functions

bool init ()
 Initializes the instance of FileUtils. More...
 
virtual std::string getWritablePath () const
 Gets the writable path. More...
 
virtual bool isFileExist (const std::string &strFilePath) const
 Checks whether a file exists. More...
 
local isFileExist ( local strFilePath)
 Checks whether a file exists. More...
 
virtual bool isAbsolutePath (const std::string &strPath) const
 Checks whether the path is an absolute path. More...
 
local isAbsolutePath ( local strPath)
 Checks whether the path is an absolute path. More...
 
- Public Member Functions inherited from FileUtils
virtual ~FileUtils ()
 The destructor of FileUtils. More...
 
virtual void purgeCachedEntries ()
 Purges the file searching cache. More...
 
var purgeCachedEntries ()
 Purges the file searching cache. More...
 
local purgeCachedEntries ()
 Purges the file searching cache. More...
 
virtual unsigned char * getFileDataFromZip (const std::string &zipFilePath, const std::string &filename, ssize_t *size)
 Gets resource file data from a zip file. More...
 
virtual std::string fullPathForFilename (const std::string &filename)
 Returns the fullpath for a given filename. More...
 
local fullPathForFilename ( local filename)
 Returns the fullpath for a given filename. More...
 
virtual void loadFilenameLookupDictionaryFromFile (const std::string &filename)
 Loads the filenameLookup dictionary from the contents of a filename. More...
 
virtual void setFilenameLookupDictionary (const ValueMap &filenameLookupDict)
 Sets the filenameLookup dictionary. More...
 
virtual std::string fullPathFromRelativeFile (const std::string &filename, const std::string &relativeFile)
 Gets full path from a file name and the path of the reletive file. More...
 
local fullPathFromRelativeFile ( local filename, local relativeFile)
 Gets full path from a file name and the path of the reletive file. More...
 
virtual void setSearchResolutionsOrder (const std::vector< std::string > &searchResolutionsOrder)
 Sets the array that contains the search order of the resources. More...
 
virtual void addSearchResolutionsOrder (const std::string &order)
 Append search order of the resources. More...
 
virtual const std::vector
< std::string > & 
getSearchResolutionsOrder ()
 Gets the array that contains the search order of the resources. More...
 
virtual void setSearchPaths (const std::vector< std::string > &searchPaths)
 Sets the array of search paths. More...
 
var setSearchPaths ( var searchPaths)
 Sets the array of search paths. More...
 
void addSearchPath (const std::string &path)
 Add search path. More...
 
virtual const std::vector
< std::string > & 
getSearchPaths () const
 Gets the array of search paths. More...
 
virtual void setPopupNotify (bool notify)
 Sets/Gets whether to pop-up a message box when failed to load an image. More...
 
virtual bool isPopupNotify ()
virtual ValueMap getValueMapFromFile (const std::string &filename)
 Converts the contents of a file to a ValueMap. More...
 
local getValueMapFromFile ( local filename)
 Converts the contents of a file to a ValueMap. More...
 
virtual bool writeToFile (ValueMap &dict, const std::string &fullPath)
 Write a ValueMap to a plist file. More...
 
local writeToFile ( local dict, local fullPath)
 Write a ValueMap to a plist file. More...
 
virtual ValueVector getValueVectorFromFile (const std::string &filename)
 Converts the contents of a file to a ValueVector. More...
 

Protected Member Functions

virtual
CC_DEPRECATED_ATTRIBUTE
unsigned char * 
getFileData (const std::string &filename, const char *mode, ssize_t *size) override
 Gets resource file data. More...
 
virtual std::string getStringFromFile (const std::string &filename) override
 Gets string from a file. More...
 
virtual Data getDataFromFile (const std::string &filename) override
 Creates binary data from a file. More...
 
virtual std::string getPathForFilename (const std::string &filename, const std::string &resolutionDirectory, const std::string &searchPath) override
 Gets full path for filename, resolution directory and search path. More...
 
virtual std::string getFullPathForDirectoryAndFilename (const std::string &directory, const std::string &filename) override
 Gets full path for the directory and the filename. More...
 
- Protected Member Functions inherited from FileUtils
 FileUtils ()
 The default constructor. More...
 
virtual std::string getNewFilename (const std::string &filename)
 Gets the new filename from the filename lookup dictionary. More...
 

Friends

class FileUtils

Additional Inherited Members

- Static Public Member Functions inherited from FileUtils
static FileUtilsgetInstance ()
 Gets the instance of FileUtils. More...
 
local getInstance ()
 Gets the instance of FileUtils. More...
 
static void destroyInstance ()
 Destroys the instance of FileUtils. More...
 
var destroyInstance ()
 Destroys the instance of FileUtils. More...
 
local destroyInstance ()
 Destroys the instance of FileUtils. More...
 
static CC_DEPRECATED_ATTRIBUTE
FileUtils
sharedFileUtils ()
local sharedFileUtils ()
static CC_DEPRECATED_ATTRIBUTE void purgeFileUtils ()
local purgeFileUtils ()
- Protected Attributes inherited from FileUtils
ValueMap _filenameLookupDict
 Dictionary used to lookup filenames based on a key. More...
 
std::vector< std::string > _searchResolutionsOrderArray
 The vector contains resolution folders. More...
 
std::vector< std::string > _searchPathArray
 The vector contains search paths. More...
 
std::string _defaultResRootPath
 The default root path of resources. More...
 
std::unordered_map
< std::string, std::string > 
_fullPathCache
 The full path cache. More...
 
var _fullPathCache
 The full path cache. More...
 
local _fullPathCache
 The full path cache. More...
 
- Static Protected Attributes inherited from FileUtils
static FileUtilss_sharedFileUtils
 The singleton pointer of FileUtils. More...
 
var s_sharedFileUtils
 The singleton pointer of FileUtils. More...
 
local s_sharedFileUtils
 The singleton pointer of FileUtils. More...
 

Detailed Description

Helper class to handle file operations.

Member Function Documentation

virtual Data getDataFromFile ( const std::string &  filename)
overrideprotectedvirtual

Creates binary data from a file.

Returns
A data object.

Reimplemented from FileUtils.

var getDataFromFile ( var  filename)
overrideprotectedvirtual

Creates binary data from a file.

Returns
A data object.

Reimplemented from FileUtils.

local getDataFromFile ( local  filename)
overrideprotectedvirtual

Creates binary data from a file.

Returns
A data object.

Reimplemented from FileUtils.

virtual
CC_DEPRECATED_ATTRIBUTE
unsigned char* getFileData
( const std::string &  filename,
const char *  mode,
ssize_t size 
)
overrideprotectedvirtual

Gets resource file data.

Parameters
[in]filenameThe resource file name which contains the path.
[in]modeThe read mode of the file.
[out]sizeIf the file read operation succeeds, it will be the data size, otherwise 0.
Returns
Upon success, a pointer to the data is returned, otherwise NULL.
Warning
Recall: you are responsible for calling delete[] on any Non-NULL pointer returned.

Reimplemented from FileUtils.

var getFileData ( var  filename,
var  mode,
var  size 
)
overrideprotectedvirtual

Gets resource file data.

Parameters
[in]filenameThe resource file name which contains the path.
[in]modeThe read mode of the file.
[out]sizeIf the file read operation succeeds, it will be the data size, otherwise 0.
Returns
Upon success, a pointer to the data is returned, otherwise NULL.
Warning
Recall: you are responsible for calling delete[] on any Non-NULL pointer returned.

Reimplemented from FileUtils.

local getFileData ( local  filename,
local  mode,
local  size 
)
overrideprotectedvirtual

Gets resource file data.

Parameters
[in]filenameThe resource file name which contains the path.
[in]modeThe read mode of the file.
[out]sizeIf the file read operation succeeds, it will be the data size, otherwise 0.
Returns
Upon success, a pointer to the data is returned, otherwise NULL.
Warning
Recall: you are responsible for calling delete[] on any Non-NULL pointer returned.

Reimplemented from FileUtils.

virtual std::string
getFullPathForDirectoryAndFilename
( const std::string &  directory,
const std::string &  filename 
)
overrideprotectedvirtual

Gets full path for the directory and the filename.

Note
Only iOS and Mac need to override this method since they are using [[NSBundle mainBundle] pathForResource: ofType: inDirectory:] to make a full path. Other platforms will use the default implementation of this method.
Parameters
directoryThe directory contains the file we are looking for.
filenameThe name of the file.
Returns
The full path of the file, if the file can't be found, it will return an empty string.

Reimplemented from FileUtils.

var
getFullPathForDirectoryAndFilename
( var  directory,
var  filename 
)
overrideprotectedvirtual

Gets full path for the directory and the filename.

Note
Only iOS and Mac need to override this method since they are using [[NSBundle mainBundle] pathForResource: ofType: inDirectory:] to make a full path. Other platforms will use the default implementation of this method.
Parameters
directoryThe directory contains the file we are looking for.
filenameThe name of the file.
Returns
The full path of the file, if the file can't be found, it will return an empty string.

Reimplemented from FileUtils.

local
getFullPathForDirectoryAndFilename
( local  directory,
local  filename 
)
overrideprotectedvirtual

Gets full path for the directory and the filename.

Note
Only iOS and Mac need to override this method since they are using [[NSBundle mainBundle] pathForResource: ofType: inDirectory:] to make a full path. Other platforms will use the default implementation of this method.
Parameters
directoryThe directory contains the file we are looking for.
filenameThe name of the file.
Returns
The full path of the file, if the file can't be found, it will return an empty string.

Reimplemented from FileUtils.

virtual std::string
getPathForFilename
( const std::string &  filename,
const std::string &  resolutionDirectory,
const std::string &  searchPath 
)
overrideprotectedvirtual

Gets full path for filename, resolution directory and search path.

Parameters
filenameThe file name.
resolutionDirectoryThe resolution directory.
searchPathThe search path.
Returns
The full path of the file. It will return an empty string if the full path of the file doesn't exist.

Reimplemented from FileUtils.

var getPathForFilename ( var  filename,
var  resolutionDirectory,
var  searchPath 
)
overrideprotectedvirtual

Gets full path for filename, resolution directory and search path.

Parameters
filenameThe file name.
resolutionDirectoryThe resolution directory.
searchPathThe search path.
Returns
The full path of the file. It will return an empty string if the full path of the file doesn't exist.

Reimplemented from FileUtils.

local getPathForFilename ( local  filename,
local  resolutionDirectory,
local  searchPath 
)
overrideprotectedvirtual

Gets full path for filename, resolution directory and search path.

Parameters
filenameThe file name.
resolutionDirectoryThe resolution directory.
searchPathThe search path.
Returns
The full path of the file. It will return an empty string if the full path of the file doesn't exist.

Reimplemented from FileUtils.

virtual std::string
getStringFromFile
( const std::string &  filename)
overrideprotectedvirtual

Gets string from a file.

Reimplemented from FileUtils.

var getStringFromFile ( var  filename)
overrideprotectedvirtual

Gets string from a file.

Reimplemented from FileUtils.

local getStringFromFile ( local  filename)
overrideprotectedvirtual

Gets string from a file.

Reimplemented from FileUtils.

virtual std::string getWritablePath ( ) const
virtual

Gets the writable path.

Returns
The path that can be write/read a file in

Implements FileUtils.

var getWritablePath ( )
virtual

Gets the writable path.

Returns
The path that can be write/read a file in

Implements FileUtils.

local getWritablePath ( )
virtual

Gets the writable path.

Returns
The path that can be write/read a file in

Implements FileUtils.

bool init ( )
virtual

Initializes the instance of FileUtils.

It will set _searchPathArray and _searchResolutionsOrderArray to default values.

Note
When you are porting Cocos2d-x to a new platform, you may need to take care of this method. You could assign a default value to _defaultResRootPath in the subclass of FileUtils(e.g. FileUtilsAndroid). Then invoke the FileUtils::init().
Returns
true if successed, otherwise it returns false.

Reimplemented from FileUtils.

var init ( )
virtual

Initializes the instance of FileUtils.

It will set _searchPathArray and _searchResolutionsOrderArray to default values.

Note
When you are porting Cocos2d-x to a new platform, you may need to take care of this method. You could assign a default value to _defaultResRootPath in the subclass of FileUtils(e.g. FileUtilsAndroid). Then invoke the FileUtils::init().
Returns
true if successed, otherwise it returns false.

Reimplemented from FileUtils.

local init ( )
virtual

Initializes the instance of FileUtils.

It will set _searchPathArray and _searchResolutionsOrderArray to default values.

Note
When you are porting Cocos2d-x to a new platform, you may need to take care of this method. You could assign a default value to _defaultResRootPath in the subclass of FileUtils(e.g. FileUtilsAndroid). Then invoke the FileUtils::init().
Returns
true if successed, otherwise it returns false.

Reimplemented from FileUtils.

virtual bool isAbsolutePath ( const std::string &  path) const
virtual

Checks whether the path is an absolute path.

Note
On Android, if the parameter passed in is relative to "assets/", this method will treat it as an absolute path. Also on Blackberry, path starts with "app/native/Resources/" is treated as an absolute path.
Parameters
strPathThe path that needs to be checked.
Returns
true if it's an absolute path, otherwise it will return false.

Reimplemented from FileUtils.

var isAbsolutePath ( var  path)
virtual

Checks whether the path is an absolute path.

Note
On Android, if the parameter passed in is relative to "assets/", this method will treat it as an absolute path. Also on Blackberry, path starts with "app/native/Resources/" is treated as an absolute path.
Parameters
strPathThe path that needs to be checked.
Returns
true if it's an absolute path, otherwise it will return false.

Reimplemented from FileUtils.

local isAbsolutePath ( local  path)
virtual

Checks whether the path is an absolute path.

Note
On Android, if the parameter passed in is relative to "assets/", this method will treat it as an absolute path. Also on Blackberry, path starts with "app/native/Resources/" is treated as an absolute path.
Parameters
strPathThe path that needs to be checked.
Returns
true if it's an absolute path, otherwise it will return false.

Reimplemented from FileUtils.

virtual bool isFileExist ( const std::string &  filePath) const
virtual

Checks whether a file exists.

Note
If a relative path was passed in, it will be inserted a default root path at the beginning.
Parameters
strFilePathThe path of the file, it could be a relative or absolute path.
Returns
true if the file exists, otherwise it will return false.

Implements FileUtils.

var isFileExist ( var  filePath)
virtual

Checks whether a file exists.

Note
If a relative path was passed in, it will be inserted a default root path at the beginning.
Parameters
strFilePathThe path of the file, it could be a relative or absolute path.
Returns
true if the file exists, otherwise it will return false.

Implements FileUtils.

local isFileExist ( local  filePath)
virtual

Checks whether a file exists.

Note
If a relative path was passed in, it will be inserted a default root path at the beginning.
Parameters
strFilePathThe path of the file, it could be a relative or absolute path.
Returns
true if the file exists, otherwise it will return false.

Implements FileUtils.

Friends And Related Function Documentation

friend class FileUtils
friend
var FileUtils
friend
local FileUtils
friend

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