fileio.cpp File Reference

Standard In/Out file operations. More...

#include "stdafx.h"
#include "fileio_func.h"
#include "variables.h"
#include "debug.h"
#include "fios.h"
#include "string_func.h"
#include "tar_type.h"
#include <pwd.h>
#include <sys/stat.h>
#include <algorithm>

Go to the source code of this file.

Data Structures

struct  Fio

Defines

#define FIO_BUFFER_SIZE   512

Typedefs

typedef std::map< std::string,
std::string > 
TarLinkList

Functions

size_t FioGetPos ()
const char * FioGetFilename (uint8 slot)
void FioSeekTo (size_t pos, int mode)
void FioSeekToFile (uint8 slot, size_t pos)
byte FioReadByte ()
void FioSkipBytes (int n)
uint16 FioReadWord ()
uint32 FioReadDword ()
void FioReadBlock (void *ptr, size_t size)
static void FioCloseFile (int slot)
void FioCloseAll ()
void FioOpenFile (int slot, const char *filename)
bool FioCheckFileExists (const char *filename, Subdirectory subdir)
 Check whether the given file exists.
void FioFCloseFile (FILE *f)
 Close a file in a safe way.
char * FioGetFullPath (char *buf, size_t buflen, Searchpath sp, Subdirectory subdir, const char *filename)
char * FioFindFullPath (char *buf, size_t buflen, Subdirectory subdir, const char *filename)
char * FioAppendDirectory (char *buf, size_t buflen, Searchpath sp, Subdirectory subdir)
char * FioGetDirectory (char *buf, size_t buflen, Subdirectory subdir)
FILE * FioFOpenFileSp (const char *filename, const char *mode, Searchpath sp, Subdirectory subdir, size_t *filesize)
FILE * FioFOpenFileTar (TarFileListEntry *entry, size_t *filesize)
FILE * FioFOpenFile (const char *filename, const char *mode, Subdirectory subdir, size_t *filesize)
 Opens OpenTTD files somewhere in a personal or global directory.
void FioCreateDirectory (const char *name)
 Create a directory with the given name.
void AppendPathSeparator (char *buf, size_t buflen)
 Appends, if necessary, the path separator character to the end of the string.
char * BuildWithFullPath (const char *dir)
 Allocates and files a variable with the full path based on the given directory.
const char * FioTarFirstDir (const char *tarname)
static void TarAddLink (const std::string &srcParam, const std::string &destParam)
void FioTarAddLink (const char *src, const char *dest)
static void SimplifyFileName (char *name)
 Simplify filenames from tars.
bool TarListAddFile (const char *filename)
static int ScanPathForTarFiles (const char *path, size_t basepath_length)
void ScanForTarFiles ()
void ChangeWorkingDirectory (const char *exe)
 Changes the working directory to the path of the give executable.
void DetermineBasePaths (const char *exe)
 Determine the base (personal dir and game data dir) paths.
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.
void SanitizeFilename (char *filename)
 Sanitizes a filename, i.e.
void * ReadFileToMem (const char *filename, size_t *lenp, size_t maxsize)
static uint ScanPath (FileScanner *fs, const char *extension, const char *path, size_t basepath_length)
 Scan a single directory (and recursively it's children) and add any graphics sets that are found.
static uint ScanTar (FileScanner *fs, const char *extension, TarFileList::iterator tar)
 Scan the given tar and add graphics sets when it finds one.

Variables

static Fio _fio
const char * _subdirs [NUM_SUBDIRS]
const char * _searchpaths [NUM_SEARCHPATHS]
 The searchpaths OpenTTD could search through.
TarList _tar_list
TarFileList _tar_filelist
static TarLinkList _tar_linklist
 List of directory links.
char * _personal_dir
 custom directory for personal settings, saves, newgrf, etc.


Detailed Description

Standard In/Out file operations.

Definition in file fileio.cpp.


Function Documentation

void AppendPathSeparator ( char *  buf,
size_t  buflen 
)

Appends, if necessary, the path separator character to the end of the string.

It does not add the path separator to zero-sized strings.

Parameters:
buf string to append the separator to
buflen the length of the buf

Definition at line 432 of file fileio.cpp.

Referenced by BuildWithFullPath(), DetermineBasePaths(), FileScanner::Scan(), and ScanPath().

char* BuildWithFullPath ( const char *  dir  ) 

Allocates and files a variable with the full path based on the given directory.

Parameters:
dir the directory to base the path on
Returns:
the malloced full path

Definition at line 449 of file fileio.cpp.

References AppendPathSeparator(), ttd_strlcat(), and ttd_strlcpy().

void ChangeWorkingDirectory ( const char *  exe  ) 

Changes the working directory to the path of the give executable.

For OSX application bundles '.app' is the required extension of the bundle, so when we crop the path to there, when can remove the name of the bundle in the same way we remove the name from the executable name.

Parameters:
exe the path to the executable

Definition at line 800 of file fileio.cpp.

Referenced by DetermineBasePaths().

void DetermineBasePaths ( const char *  exe  ) 

Determine the base (personal dir and game data dir) paths.

Parameters:
exe the path to the executable

Definition at line 827 of file fileio.cpp.

References AppendPathSeparator(), ChangeWorkingDirectory(), SP_APPLICATION_BUNDLE_DIR, SP_BINARY_DIR, SP_INSTALLATION_DIR, SP_PERSONAL_DIR, SP_SHARED_DIR, and SP_WORKING_DIR.

Referenced by DeterminePaths().

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.

Parameters:
exe the path from the current path to the executable

Definition at line 892 of file fileio.cpp.

References AI_DIR, AI_LIBRARY_DIR, AUTOSAVE_DIR, BASE_DIR, DATA_DIR, DetermineBasePaths(), FioCreateDirectory(), FOR_ALL_SEARCHPATHS, HEIGHTMAP_DIR, IsValidSearchPath(), lengthof, SAVE_DIR, SCENARIO_DIR, SP_AUTODOWNLOAD_DIR, SP_BINARY_DIR, SP_INSTALLATION_DIR, SP_PERSONAL_DIR, SP_SHARED_DIR, and SP_WORKING_DIR.

bool FioCheckFileExists ( const char *  filename,
Subdirectory  subdir 
)

Check whether the given file exists.

Parameters:
filename the file to try for existance
subdir the subdirectory to look in
Returns:
true if and only if the file can be opened

Definition at line 234 of file fileio.cpp.

References FioFCloseFile(), and FioFOpenFile().

void FioCreateDirectory ( const char *  name  ) 

Create a directory with the given name.

Parameters:
name the new name of the directory

Definition at line 405 of file fileio.cpp.

References OTTD2FS(), and ttd_strlcpy().

Referenced by DeterminePaths().

void SanitizeFilename ( char *  filename  ) 

Sanitizes a filename, i.e.

removes all illegal characters from it.

Parameters:
filename the "\0" terminated filename

Definition at line 978 of file fileio.cpp.

Referenced by GenerateDefaultSaveName().

static uint ScanPath ( FileScanner fs,
const char *  extension,
const char *  path,
size_t  basepath_length 
) [static]

Scan a single directory (and recursively it's children) and add any graphics sets that are found.

Parameters:
extension the extension of files to search for.
path full path we're currently at
basepath_length from where in the path are we 'based' on the search path

Definition at line 1028 of file fileio.cpp.

References FileScanner::AddFile(), AppendPathSeparator(), FS2OTTD(), lengthof, and ttd_opendir().

Referenced by FileScanner::Scan().

static uint ScanTar ( FileScanner fs,
const char *  extension,
TarFileList::iterator  tar 
) [static]

Scan the given tar and add graphics sets when it finds one.

Parameters:
extension the extension of files to search for.
tar the tar to search in.

Definition at line 1074 of file fileio.cpp.

References FileScanner::AddFile().

Referenced by FileScanner::Scan().

static void SimplifyFileName ( char *  name  )  [static]

Simplify filenames from tars.

Replace '/' by PATHSEPCHAR, and force 'name' to lowercase.

Parameters:
name Filename to process.

Definition at line 506 of file fileio.cpp.

References strtolower().

Referenced by TarListAddFile().

bool TarListAddFile ( const char *  filename  ) 

< Name of the file

< Size of the file, in ASCII

< Path of the file

< Temporary list to collect links

Definition at line 517 of file fileio.cpp.

References Align(), and SimplifyFileName().


Variable Documentation

const char* _searchpaths[NUM_SEARCHPATHS]

The searchpaths 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 221 of file fileio.cpp.

Referenced by IsValidSearchPath().

const char* _subdirs[NUM_SUBDIRS]

Initial value:

 {
  "",
  "save" PATHSEP,
  "save" PATHSEP "autosave" PATHSEP,
  "scenario" PATHSEP,
  "scenario" PATHSEP "heightmap" PATHSEP,
  "gm" PATHSEP,
  "data" PATHSEP,
  "lang" PATHSEP,
  "ai" PATHSEP,
  "ai" PATHSEP "library" PATHSEP,
}

Definition at line 208 of file fileio.cpp.


Generated on Mon Feb 16 23:12:15 2009 for openttd by  doxygen 1.5.6