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().