forked from 0ad/0ad
janwas
44901d38b9
FILE_CACHE_BLOCK flag used more safely (copied in afile_read) add file_sector_size (set from sysdep code) documented and organized FileFlags moved publically visible file_buf* decls to file.h; add FileBufFlags file_buf_get: moved to file_io and renamed because it is not a part of the file_buf manager itself FILE_BLOCK_SIZE no longer exposed to users - it's an implementation detail. for alignment purposes, you should use file_sector_size (less wasteful) add page_aligned allocator (mmap) write buffers now allocated via file_buf_alloc(FB_FROM_HEAP) (avoids wasting cache space) append trace runs into the trace file (-> better input data for archive ordering) document lib_errors.h tex_load: add provision for file_flags, used by ogl_tex_load to prevent caching file data simulation, entitymanager: add perf measurements This was SVN commit r3725.
53 lines
1.8 KiB
C
53 lines
1.8 KiB
C
#ifndef VFS_PATH_H__
|
|
#define VFS_PATH_H__
|
|
|
|
#include "lib.h"
|
|
|
|
// internal use only:
|
|
|
|
// if path is invalid (see source for criteria), return a
|
|
// descriptive error code, otherwise ERR_OK.
|
|
extern LibError path_validate(const char* path);
|
|
#define CHECK_PATH(path) CHECK_ERR(path_validate(path))
|
|
|
|
// if name is invalid, (see source for criteria), return a
|
|
// descriptive error code, otherwise ERR_OK.
|
|
extern LibError path_component_validate(const char* name);
|
|
|
|
|
|
// strip <remove> from the start of <src>, prepend <replace>,
|
|
// and write to <dst>.
|
|
// used when converting VFS <--> real paths.
|
|
extern LibError path_replace(char* dst, const char* src, const char* remove, const char* replace);
|
|
|
|
|
|
// fill V_dir_only with the path portion of V_src_fn
|
|
// ("" if root dir, otherwise ending with /)
|
|
extern void path_dir_only(const char* V_src_fn, char* V_dir_only);
|
|
|
|
// return pointer to the name component within V_src_fn
|
|
extern const char* path_name_only(const char* V_src_fn);
|
|
|
|
|
|
struct NextNumberedFilenameInfo
|
|
{
|
|
int next_num;
|
|
};
|
|
|
|
// fill V_next_fn (which must be big enough for VFS_MAX_PATH chars) with
|
|
// the next numbered filename according to the pattern defined by V_fn_fmt.
|
|
// <nfi> must be initially zeroed (e.g. by defining as static) and passed
|
|
// each time.
|
|
// if <use_vfs> (default), the paths are treated as VFS paths; otherwise,
|
|
// file.cpp's functions are used. this is necessary because one of
|
|
// our callers needs a filename for VFS archive files.
|
|
//
|
|
// this function is useful when creating new files which are not to
|
|
// overwrite the previous ones, e.g. screenshots.
|
|
// example for V_fn_fmt: "screenshots/screenshot%04d.png".
|
|
extern void next_numbered_filename(const char* V_fn_fmt,
|
|
NextNumberedFilenameInfo* nfi, char* V_next_fn, bool use_vfs = true);
|
|
|
|
|
|
#endif // #ifndef VFS_PATH_H__
|