|
OpenTTD
|
Functions for Standard In/Out file operations. More...
Go to the source code of this file.
Data Structures | |
| class | FileScanner |
| Helper for scanning for files with a given name. More... | |
| class | TarScanner |
| Helper for scanning for files with tar as extension. More... | |
Macros | |
| #define | FOR_ALL_SEARCHPATHS(sp) for (sp = SP_FIRST_DIR; sp < NUM_SEARCHPATHS; sp++) if (IsValidSearchPath(sp)) |
| Iterator for all the search paths. | |
Functions | |
| void | FioSeekTo (size_t pos, int mode) |
| Seek in the current file. More... | |
| void | FioSeekToFile (uint8 slot, size_t pos) |
| Switch to a different file and seek to a position. More... | |
| size_t | FioGetPos () |
| Get position in the current file. More... | |
| const char * | FioGetFilename (uint8 slot) |
| Get the filename associated with a slot. More... | |
| byte | FioReadByte () |
| Read a byte from the file. More... | |
| uint16 | FioReadWord () |
| Read a word (16 bits) from the file (in low endian format). More... | |
| uint32 | FioReadDword () |
| Read a double word (32 bits) from the file (in low endian format). More... | |
| void | FioCloseAll () |
| Close all slotted open files. More... | |
| void | FioOpenFile (int slot, const char *filename, Subdirectory subdir) |
| Open a slotted file. More... | |
| void | FioReadBlock (void *ptr, size_t size) |
| Read a block. More... | |
| void | FioSkipBytes (int n) |
| Skip n bytes ahead in the file. More... | |
| static bool | IsValidSearchPath (Searchpath sp) |
| Checks whether the given search path is a valid search path. More... | |
| void | FioFCloseFile (FILE *f) |
| Close a file in a safe way. | |
| FILE * | FioFOpenFile (const char *filename, const char *mode, Subdirectory subdir, size_t *filesize=NULL) |
| Opens a OpenTTD file somewhere in a personal or global directory. More... | |
| bool | FioCheckFileExists (const char *filename, Subdirectory subdir) |
| Check whether the given file exists. More... | |
| char * | FioGetFullPath (char *buf, const char *last, Searchpath sp, Subdirectory subdir, const char *filename) |
| char * | FioFindFullPath (char *buf, const char *last, Subdirectory subdir, const char *filename) |
| Find a path to the filename in one of the search directories. More... | |
| char * | FioAppendDirectory (char *buf, const char *last, Searchpath sp, Subdirectory subdir) |
| char * | FioGetDirectory (char *buf, const char *last, Subdirectory subdir) |
| const char * | FiosGetScreenshotDir () |
| Get the directory for screenshots. More... | |
| void | SanitizeFilename (char *filename) |
| Sanitizes a filename, i.e. More... | |
| bool | AppendPathSeparator (char *buf, const char *last) |
| Appends, if necessary, the path separator character to the end of the string. More... | |
| void | DeterminePaths (const char *exe) |
| Acquire the base paths (personal dir and game data dir), fill all other paths (save dir, autosave dir etc) and make the save and scenario directories. More... | |
| void * | ReadFileToMem (const char *filename, size_t *lenp, size_t maxsize) |
| Load a file into memory. More... | |
| bool | FileExists (const char *filename) |
| Test whether the given filename exists. More... | |
| const char * | FioTarFirstDir (const char *tarname, Subdirectory subdir) |
| Find the first directory in a tar archive. More... | |
| void | FioTarAddLink (const char *src, const char *dest, Subdirectory subdir) |
| bool | ExtractTar (const char *tar_filename, Subdirectory subdir) |
| Extract the tar with the given filename in the directory where the tar resides. More... | |
| static DIR * | ttd_opendir (const char *path) |
| A wrapper around opendir() which will convert the string from OPENTTD encoding to that of the filesystem. More... | |
Variables | |
| const char * | _searchpaths [NUM_SEARCHPATHS] |
| The search paths OpenTTD could search through. More... | |
| const char * | _personal_dir |
| custom directory for personal settings, saves, newgrf, etc. | |
Functions for Standard In/Out file operations.
Definition in file fileio_func.h.
| bool AppendPathSeparator | ( | char * | buf, |
| const char * | last | ||
| ) |
Appends, if necessary, the path separator character to the end of the string.
It does not add the path separator to zero-sized strings.
| buf | string to append the separator to |
| last | the last element of buf. |
Definition at line 573 of file fileio.cpp.
| void DeterminePaths | ( | const char * | exe | ) |
Acquire the base paths (personal dir and game data dir), fill all other paths (save dir, autosave dir etc) and make the save and scenario directories.
| exe | the path from the current path to the executable |
Definition at line 1171 of file fileio.cpp.
References DetermineBasePaths().
| bool ExtractTar | ( | const char * | tar_filename, |
| Subdirectory | subdir | ||
| ) |
Extract the tar with the given filename in the directory where the tar resides.
| tar_filename | the name of the tar to extract. |
| subdir | The sub directory the tar is in. |
Definition at line 924 of file fileio.cpp.
| bool FileExists | ( | const char * | filename | ) |
Test whether the given filename exists.
| filename | the file to test. |
Definition at line 326 of file fileio.cpp.
References OTTD2FS().
| bool FioCheckFileExists | ( | const char * | filename, |
| Subdirectory | subdir | ||
| ) |
Check whether the given file exists.
| filename | the file to try for existence. |
| subdir | the subdirectory to look in |
Definition at line 312 of file fileio.cpp.
References FioFCloseFile(), and FioFOpenFile().
Referenced by FillGRFDetails(), and GRFLoadConfig().
| void FioCloseAll | ( | ) |
Close all slotted open files.
Definition at line 213 of file fileio.cpp.
References FioCloseFile(), Fio::handles, and lengthof.
| char* FioFindFullPath | ( | char * | buf, |
| const char * | last, | ||
| Subdirectory | subdir, | ||
| const char * | filename | ||
| ) |
Find a path to the filename in one of the search directories.
| buf | [out] Destination buffer for the path. |
| last | End of the destination buffer. |
| subdir | Subdirectory to try. |
| filename | Filename to look for. |
NULL. Definition at line 364 of file fileio.cpp.
| FILE* FioFOpenFile | ( | const char * | filename, |
| const char * | mode, | ||
| Subdirectory | subdir, | ||
| size_t * | filesize | ||
| ) |
Opens a OpenTTD file somewhere in a personal or global directory.
| filename | Name of the file to open. |
| subdir | Subdirectory to open. |
| filename | Name of the file to open. |
NULL if the file is not available. Definition at line 474 of file fileio.cpp.
Referenced by ScriptFileChecksumCreator::AddFile(), ScenarioScanner::AddFile(), CalcGRFMD5Sum(), MD5File::CheckMD5(), GraphicsSet::CheckMD5(), DisplaySplashImage(), FioCheckFileExists(), FioOpenFile(), Squirrel::LoadFile(), TextfileWindow::LoadTextfile(), IniFile::OpenFile(), ReadRawLanguageStrings(), and CrashLog::WriteCrashLog().
| const char* FioGetFilename | ( | uint8 | slot | ) |
Get the filename associated with a slot.
| slot | Index of queried file. |
Definition at line 78 of file fileio.cpp.
References Fio::shortnames.
Referenced by WarnCorruptSprite().
| size_t FioGetPos | ( | ) |
Get position in the current file.
Definition at line 68 of file fileio.cpp.
References Fio::buffer_end, and Fio::pos.
Referenced by DefineGotoLabel(), FioReadBlock(), FioSeekTo(), GetGRFContainerVersion(), LoadNextSprite(), and ReadGRFSpriteOffsets().
| void FioOpenFile | ( | int | slot, |
| const char * | filename, | ||
| Subdirectory | subdir | ||
| ) |
Open a slotted file.
| slot | Index to assign. |
| filename | Name of the file at the disk. |
| subdir | The sub directory to search this file in. |
Definition at line 250 of file fileio.cpp.
References Fio::filename, Fio::filenames, FioCloseFile(), FioFOpenFile(), Fio::handles, Fio::pos, and usererror().
Referenced by FioSeekTo(), LoadGrfFile(), and LoadGrfFileIndexed().
| void FioReadBlock | ( | void * | ptr, |
| size_t | size | ||
| ) |
Read a block.
| ptr | Destination buffer. |
| size | Number of bytes to read. |
Definition at line 187 of file fileio.cpp.
References Fio::cur_fh, FioGetPos(), FioSeekTo(), and Fio::pos.
| byte FioReadByte | ( | ) |
Read a byte from the file.
Definition at line 133 of file fileio.cpp.
References Fio::buffer_end, Fio::buffer_start, Fio::cur_fh, FIO_BUFFER_SIZE, and Fio::pos.
Referenced by DecodeSingleSprite(), FioReadWord(), FioSkipBytes(), GetGRFContainerVersion(), LoadGrfFile(), LoadGrfFileIndexed(), LoadNextSprite(), and SkipSpriteData().
| uint32 FioReadDword | ( | ) |
Read a double word (32 bits) from the file (in low endian format).
Definition at line 176 of file fileio.cpp.
References FioReadWord().
Referenced by ImportGRFSound(), LoadNextSprite(), and ReadGRFSpriteOffsets().
| uint16 FioReadWord | ( | ) |
Read a word (16 bits) from the file (in low endian format).
Definition at line 166 of file fileio.cpp.
References FioReadByte().
Referenced by FioReadDword(), GetGRFContainerVersion(), ImportGRFSound(), and LoadNextSprite().
| void FioSeekTo | ( | size_t | pos, |
| int | mode | ||
| ) |
Seek in the current file.
| pos | New position. |
| mode | Type of seek (SEEK_CUR means pos is relative to current position, SEEK_SET means pos is absolute). |
Definition at line 88 of file fileio.cpp.
References Fio::buffer_end, Fio::buffer_start, Fio::cur_fh, DEBUG, Fio::filename, Fio::filenames, FIO_BUFFER_SIZE, FioGetPos(), FioOpenFile(), Fio::handles, and Fio::pos.
Referenced by FioReadBlock(), GetGRFContainerVersion(), and ReadGRFSpriteOffsets().
| void FioSeekToFile | ( | uint8 | slot, |
| size_t | pos | ||
| ) |
Switch to a different file and seek to a position.
| slot | Slot number of the new file. |
| pos | New absolute position in the new file. |
Definition at line 115 of file fileio.cpp.
References Fio::handles.
| const char* FiosGetScreenshotDir | ( | ) |
| void FioSkipBytes | ( | int | n | ) |
Skip n bytes ahead in the file.
| n | Number of bytes to skip reading. |
Definition at line 150 of file fileio.cpp.
References Fio::buffer_end, FioReadByte(), and min().
Referenced by LoadNextSprite(), ReadGRFSpriteOffsets(), and SkipSpriteData().
| const char* FioTarFirstDir | ( | const char * | tarname, |
| Subdirectory | subdir | ||
| ) |
Find the first directory in a tar archive.
| tarname | the name of the tar archive to look in. |
| subdir | the subdirectory to look in. |
Definition at line 592 of file fileio.cpp.
|
inlinestatic |
Checks whether the given search path is a valid search path.
| sp | the search path to check |
Definition at line 43 of file fileio_func.h.
| void* ReadFileToMem | ( | const char * | filename, |
| size_t * | lenp, | ||
| size_t | maxsize | ||
| ) |
Load a file into memory.
| filename | Name of the file to load. |
| lenp | [out] Length of loaded data. |
| maxsize | Maximum size to load. |
NULL if loading failed. Definition at line 1319 of file fileio.cpp.
Referenced by ReadLanguagePack().
| void SanitizeFilename | ( | char * | filename | ) |
Sanitizes a filename, i.e.
removes all illegal characters from it.
| filename | the "\0" terminated filename |
Definition at line 1297 of file fileio.cpp.
|
inlinestatic |
A wrapper around opendir() which will convert the string from OPENTTD encoding to that of the filesystem.
For all purposes this function behaves the same as the original opendir function
| path | string to open directory of |
Definition at line 147 of file fileio_func.h.
Referenced by GetLanguageList().
| const char* _searchpaths[NUM_SEARCHPATHS] |
The search paths OpenTTD could search through.
At least one of the slots has to be filled with a path. NULL paths tell that there is no such path for the current operating system.
Definition at line 299 of file fileio.cpp.
Referenced by DoScanWorkingDirectory().
1.8.13