X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/e25cd7750c571191ce69438de5f7c0293d1b5270..5b88a837ba75928cd3835a6b97ae2bf5ad983a6e:/interface/wx/wfstream.h?ds=inline diff --git a/interface/wx/wfstream.h b/interface/wx/wfstream.h index c93e57b7be..d5c03564e4 100644 --- a/interface/wx/wfstream.h +++ b/interface/wx/wfstream.h @@ -23,6 +23,8 @@ class wxTempFileOutputStream : public wxOutputStream public: /** Associates wxTempFileOutputStream with the file to be replaced and opens it. + + @warning You should use wxStreamBase::IsOk() to verify if the constructor succeeded. Call Commit() or wxOutputStream::Close() to replace the old file and close @@ -39,13 +41,13 @@ public: either the old file couldn't be deleted or that the new file couldn't be renamed to the old name. */ - bool Commit(); + virtual bool Commit(); /** Discard changes: the old file contents are not changed, the temporary file is deleted. */ - void Discard(); + virtual void Discard(); }; @@ -69,10 +71,13 @@ class wxFFileOutputStream : public wxOutputStream { public: /** - Initializes a file stream in write-only mode using the file descriptor @e fp. + Open the given file @a filename with mode @a mode. + + @warning + You should use wxStreamBase::IsOk() to verify if the constructor succeeded. */ wxFFileOutputStream(const wxString& filename, - const wxString& mode = "w+b"); + const wxString& mode = "wb"); /** Initializes a file stream in write-only mode using the file I/O object file. @@ -87,7 +92,7 @@ public: /** Destructor. */ - ~wxFFileOutputStream(); + virtual ~wxFFileOutputStream(); /** Returns @true if the stream is initialized and ready. @@ -116,7 +121,10 @@ class wxFileOutputStream : public wxOutputStream { public: /** - Creates a new file with ofilename name and initializes the stream in write-only mode. + Creates a new file with @a ofileName name and initializes the stream in write-only mode. + + @warning + You should use wxStreamBase::IsOk() to verify if the constructor succeeded. */ wxFileOutputStream(const wxString& ofileName); @@ -133,7 +141,7 @@ public: /** Destructor. */ - ~wxFileOutputStream(); + virtual ~wxFileOutputStream(); /** Returns @true if the stream is initialized and ready. @@ -162,7 +170,10 @@ class wxFileInputStream : public wxInputStream { public: /** - Opens the specified file using its ifilename name in read-only mode. + Opens the specified file using its @a ifileName name in read-only mode. + + @warning + You should use wxStreamBase::IsOk() to verify if the constructor succeeded. */ wxFileInputStream(const wxString& ifileName); @@ -179,7 +190,7 @@ public: /** Destructor. */ - ~wxFileInputStream(); + virtual ~wxFileInputStream(); /** Returns @true if the stream is initialized and ready. @@ -208,7 +219,10 @@ class wxFFileInputStream : public wxInputStream { public: /** - Opens the specified file using its filename name using the specified mode. + Opens the specified file using its @a filename name using the specified @a mode. + + @warning + You should use wxStreamBase::IsOk() to verify if the constructor succeeded. */ wxFFileInputStream(const wxString& filename, const wxString& mode = "rb"); @@ -226,7 +240,7 @@ public: /** Destructor. */ - ~wxFFileInputStream(); + virtual ~wxFFileInputStream(); /** Returns @true if the stream is initialized and ready. @@ -250,8 +264,11 @@ class wxFFileStream : public wxFFileOutputStream { public: /** - Initializes a new file stream in read-write mode using the specified - @a iofilename name. + Initializes a new file stream in the given @a mode using the specified + @a iofileName name. + + @warning + You should use wxStreamBase::IsOk() to verify if the constructor succeeded. */ wxFFileStream(const wxString& iofileName, const wxString& mode = "w+b"); }; @@ -273,7 +290,10 @@ class wxFileStream : public wxFileOutputStream public: /** Initializes a new file stream in read-write mode using the specified - @a iofilename name. + @a iofileName name. + + @warning + You should use wxStreamBase::IsOk() to verify if the constructor succeeded. */ wxFileStream(const wxString& iofileName); };