The purpose of this class is to define a base class for low level random file access that is portable between Win32 and Posix systems.
More...
#include <file.h>
Public Member Functions |
off_t | getCapacity (void) |
| Get current file capacity.
|
Error | getErrorNumber (void) |
| Return current error id.
|
char * | getErrorString (void) |
| Return current error string.
|
bool | initial (void) |
| This method should be called right after a RandomFile derived object has been created.
|
bool | operator! (void) |
virtual Error | restart (void) |
| This method is commonly used to close and re-open an existing database.
|
virtual | ~RandomFile () |
| Destroy a random access file or it's derived class.
|
Protected Member Functions |
Error | error (Error errid, char *errstr=((void *) 0)) |
| Post an error event.
|
Error | error (char *err) |
| Post an extended string error message.
|
void | final (void) |
| Close the file.
|
virtual Attr | initialize (void) |
| This method is used to initialize a newly created file as indicated by the "initial" flag.
|
| RandomFile (char *name=((void *) 0)) |
| Create an unopened random access file.
|
| RandomFile (RandomFile &rf) |
| Default copy constructor.
|
Error | setCompletion (Complete mode) |
| Used to set file completion modes.
|
void | setError (bool enable) |
| Used to enable or disable throwing of exceptions on errors.
|
void | setTemporary (bool enable) |
| Used to set the temporary attribute for the file.
|
void | enter (void) |
void | enterMutex (void) |
void | leave (void) |
void | leaveMutex (void) |
bool | test (void) |
bool | tryEnterMutex (void) |
Protected Attributes |
Access | access |
int | fd |
struct { |
unsigned count: 16 |
bool immediate: 1 |
bool initial: 1 |
bool temp: 1 |
bool thrown: 1 |
} | flags |
char * | pathname |
Additional Inherited Members |
enum | Access { accessReadOnly = 00,
accessWriteOnly = 01,
accessReadWrite = 02
} |
typedef enum Access | Access |
enum | Attr { attrInvalid = 0,
attrPrivate = 0400 | 0200,
attrGroup = attrPrivate | ( 0400 >> 3) | ( 0200 >> 3),
attrPublic = attrGroup | ( ( 0400 >> 3) >> 3) | ( ( 0200 >> 3) >> 3)
} |
typedef enum Attr | Attr |
enum | Complete { completionImmediate,
completionDelayed,
completionDeferred
} |
typedef enum Complete | Complete |
enum | Error {
errSuccess = 0,
errNotOpened,
errMapFailed,
errInitFailed,
errOpenDenied,
errOpenFailed,
errOpenInUse,
errReadInterrupted,
errReadIncomplete,
errReadFailure,
errWriteInterrupted,
errWriteIncomplete,
errWriteFailure,
errLockFailure,
errExtended
} |
typedef enum Error | Error |
enum | Mapping { mappedRead = accessReadOnly,
mappedWrite = accessWriteOnly,
mappedReadWrite = accessReadWrite
} |
typedef enum Mapping | Mapping |
enum | Open {
openReadOnly = 00,
openWriteOnly = 01,
openReadWrite = 02,
openAppend = 01 | 02000,
openSync = 02 | 04010000,
openTruncate = 02 | 01000
} |
typedef enum Open | Open |
static char * | getDirname (char *path, char *buffer, size_t size=4096) |
static char * | getExtension (char *path) |
static char * | getFilename (char *path) |
static char * | getFilename (char *path, char *buffer, size_t size=255) |
static char * | getRealpath (char *path, char *buffer, size_t size=4096) |
typedef struct ost::File::_fcb | fcb_t |
Detailed Description
The purpose of this class is to define a base class for low level random file access that is portable between Win32 and Posix systems.
This class is a foundation both for optimized thread shared and traditional locked file access that is commonly used to build database services, rather than the standard C++ streaming file classes.
- Author
- David Sugar dyfet.nosp@m.@ost.nosp@m.el.co.nosp@m.m Portable random disk file access.
Definition at line 377 of file file.h.
Member Function Documentation
Error ost::RandomFile::error |
( |
Error |
errid, |
|
|
char * |
errstr = ((void *) 0) |
|
) |
| |
|
protected |
Post an error event.
- Returns
- error code.
- Parameters
-
errid | error code. |
errstr | error message string. |
Error ost::RandomFile::error |
( |
char * |
err | ) |
|
|
inlineprotected |
Post an extended string error message.
- Returns
- errExtended.
- Parameters
-
Definition at line 428 of file file.h.
off_t ost::RandomFile::getCapacity |
( |
void |
| ) |
|
Get current file capacity.
- Returns
- total file size.
Error ost::RandomFile::getErrorNumber |
( |
void |
| ) |
|
|
inline |
Return current error id.
- Returns
- last error identifier set.
Definition at line 513 of file file.h.
char* ost::RandomFile::getErrorString |
( |
void |
| ) |
|
|
inline |
Return current error string.
- Returns
- last error string set.
Definition at line 521 of file file.h.
bool ost::RandomFile::initial |
( |
void |
| ) |
|
This method should be called right after a RandomFile derived object has been created.
This method will invoke initialize if the object is newly created, and set file access permissions appropriately.
- Returns
- true if file had to be initialized.
virtual Attr ost::RandomFile::initialize |
( |
void |
| ) |
|
|
protectedvirtual |
This method is used to initialize a newly created file as indicated by the "initial" flag.
This method also returns the file access permissions that should be associated with the file. This method should never be called directly, but is instead used to impliment the "Initial" method. Typically one would use this to build an empty database shell when a previously empty database file is created.
- Returns
- access, or attrInvalid if should be removed.
virtual Error ost::RandomFile::restart |
( |
void |
| ) |
|
|
virtual |
This method is commonly used to close and re-open an existing database.
This may be used when the database has been unlinked and an external process provides a new one to use.
Reimplemented in ost::SharedFile.
Error ost::RandomFile::setCompletion |
( |
Complete |
mode | ) |
|
|
protected |
Used to set file completion modes.
- Returns
- errSuccess if okay.
- Parameters
-
- Todo:
- implement in win32
void ost::RandomFile::setError |
( |
bool |
enable | ) |
|
|
inlineprotected |
Used to enable or disable throwing of exceptions on errors.
- Parameters
-
enable | true if errors will be thrown. |
Definition at line 437 of file file.h.
void ost::RandomFile::setTemporary |
( |
bool |
enable | ) |
|
|
inlineprotected |
Used to set the temporary attribute for the file.
Temporary files are automatically deleted when closed.
- Parameters
-
enable | true for marking as temporary. |
Definition at line 457 of file file.h.
Friends And Related Function Documentation
bool canAccess |
( |
char * |
path | ) |
|
|
related |
bool canModify |
( |
char * |
path | ) |
|
|
related |
bool isDevice |
( |
char * |
path | ) |
|
|
related |
bool isDir |
( |
char * |
path | ) |
|
|
related |
bool isFile |
( |
char * |
path | ) |
|
|
related |
time_t lastAccessed |
( |
char * |
path | ) |
|
|
related |
time_t lastModified |
( |
char * |
path | ) |
|
|
related |
The documentation for this class was generated from the following file: