X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/c801d85f158c4cba50b588807daabdcbd0ed3853..4d91c1d1aebe7872e50c2e35b0a436cac9cee53c:/include/wx/file.h?ds=sidebyside diff --git a/include/wx/file.h b/include/wx/file.h index ece4086f95..50074970d3 100644 --- a/include/wx/file.h +++ b/include/wx/file.h @@ -7,7 +7,7 @@ // Created: 29/01/98 // RCS-ID: $Id$ // Copyright: (c) 1998 Vadim Zeitlin -// Licence: wxWindows license +// Licence: wxWindows license ///////////////////////////////////////////////////////////////////////////// #ifndef __FILEH__ @@ -17,25 +17,32 @@ #pragma interface "file.h" #endif -// ---------------------------------------------------------------------------- -// simple types -// ---------------------------------------------------------------------------- - -#include - -// define off_t -#include - -#ifdef _MSC_VER - #define off_t _off_t +#ifndef WX_PRECOMP + #include "wx/string.h" + #include "wx/filefn.h" #endif // ---------------------------------------------------------------------------- // constants // ---------------------------------------------------------------------------- -// error return value for Seek() functions -const off_t ofsInvalid = (off_t)-1; +// we redefine these constants here because S_IREAD &c are _not_ standard +// however, we do assume that the values correspond to the Unix umask bits +#define wxS_IRUSR 00400 +#define wxS_IWUSR 00200 +#define wxS_IXUSR 00100 + +#define wxS_IRGRP 00040 +#define wxS_IWGRP 00020 +#define wxS_IXGRP 00010 + +#define wxS_IROTH 00004 +#define wxS_IWOTH 00002 +#define wxS_IXOTH 00001 + +// default mode for the new files: corresponds to umask 022 +#define wxS_DEFAULT (wxS_IRUSR | wxS_IWUSR | wxS_IRGRP | wxS_IWGRP |\ + wxS_IROTH | wxS_IWOTH) // ---------------------------------------------------------------------------- // class wxFile: raw file IO @@ -48,17 +55,18 @@ class WXDLLEXPORT wxFile public: // more file constants // ------------------- - // opening mode - enum OpenMode { read, write, read_write }; + enum OpenMode { read, write, read_write, write_append }; // standard values for file descriptor enum { fd_invalid = -1, fd_stdin, fd_stdout, fd_stderr }; - // seek type - enum SeekMode { FromStart, FromEnd, FromCurrent }; // static functions // ---------------- - static bool Exists(const char *sz); // also checks it's a regular file + // check whether a regular file by this name exists + static bool Exists(const char *name); + // check whetther we can access the given file in given mode + // (only read and write make sense here) + static bool Access(const char *name, OpenMode mode); // ctors // ----- @@ -70,26 +78,34 @@ public: wxFile(int fd) { m_fd = fd; } // open/close - bool Create(const char *szFileName, bool bOverwrite = FALSE); - bool Open(const char *szFileName, OpenMode mode = read); + // create a new file (with the default value of bOverwrite, it will fail if + // the file already exists, otherwise it will overwrite it and succeed) + bool Create(const char *szFileName, bool bOverwrite = FALSE, + int access = wxS_DEFAULT); + bool Open(const char *szFileName, OpenMode mode = read, + int access = wxS_DEFAULT); + bool Close(); // Close is a NOP if not opened + + // assign an existing file descriptor and get it back from wxFile object void Attach(int fd) { Close(); m_fd = fd; } - inline void Close(); // Close is a NOP if not opened + void Detach() { m_fd = fd_invalid; } + int fd() const { return m_fd; } // read/write (unbuffered) // returns number of bytes read or ofsInvalid on error off_t Read(void *pBuf, off_t nCount); // returns true on success - bool Write(const void *pBuf, uint nCount); + size_t Write(const void *pBuf, size_t nCount); // returns true on success - bool Write(const wxString& str) { return Write(str.c_str(), str.Len()); } + bool Write(const wxString& s) { return Write(s.c_str(), s.Len()) != 0; } // flush data not yet written bool Flush(); // file pointer operations (return ofsInvalid on failure) // move ptr ofs bytes related to start/current off_t/end of file - off_t Seek(off_t ofs, SeekMode mode = FromStart); + off_t Seek(off_t ofs, wxSeekMode mode = wxFromStart); // move ptr to ofs bytes before the end - off_t SeekEnd(off_t ofs = 0) { return Seek(ofs, FromEnd); } + off_t SeekEnd(off_t ofs = 0) { return Seek(ofs, wxFromEnd); } // get current off_t off_t Tell() const; // get current file length @@ -100,9 +116,11 @@ public: bool IsOpened() const { return m_fd != fd_invalid; } // is end of file reached? bool Eof() const; - + // is an error occured? + bool Error() const { return m_error; } + // dtor closes the file if opened - ~wxFile(); + ~wxFile(); private: // copy ctor and assignment operator are private because @@ -112,6 +130,7 @@ private: wxFile& operator=(const wxFile&); int m_fd; // file descriptor or INVALID_FD if not opened + bool m_error; // error memory }; // ---------------------------------------------------------------------------- @@ -121,7 +140,7 @@ private: // file (and close this one) or call Discard() to cancel the modification. If // you call neither of them, dtor will call Discard(). // ---------------------------------------------------------------------------- -class wxTempFile +class WXDLLEXPORT wxTempFile { public: // ctors @@ -137,8 +156,8 @@ public: bool IsOpened() const { return m_file.IsOpened(); } // I/O (both functions return true on success, false on failure) - bool Write(const void *p, uint n) { return m_file.Write(p, n); } - bool Write(const wxString& str) { return m_file.Write(str); } + bool Write(const void *p, size_t n) { return m_file.Write(p, n) != 0; } + bool Write(const wxString& str) { return m_file.Write(str); } // different ways to close the file // validate changes and delete the old file of name m_strName @@ -150,10 +169,14 @@ public: ~wxTempFile(); private: + // no copy ctor/assignment operator + wxTempFile(const wxTempFile&); + wxTempFile& operator=(const wxTempFile&); + wxString m_strName, // name of the file to replace in Commit() m_strTemp; // temporary file name wxFile m_file; // the temporary file }; #endif - // __FILEH__ + // _WX_FILEH__