wxFFile

wxFFile implements buffered file I/O. This is a very small class designed to minimize the overhead of using it - in fact, there is hardly any overhead at all, but using it brings you automatic error checking and hides differences between platforms and compilers. It wraps inside it a FILE * handle used by standard C IO library (also known as stdio).

Derived from

None.

Include files

<wx/ffile.h>

wxFromStart Count offset from the start of the file
wxFromCurrent Count offset from the current position of the file pointer
wxFromEnd Count offset from the end of the file (backwards)



wxFFile::wxFFile



wxFFile(void)

Default constructor.



wxFFile(const char* filename, const char* mode = "r")

Opens a file with the given mode. As there is no way to return whether the operation was successful or not from the constructor you should test the return value of IsOpened to check that it didn't fail.



wxFFile(FILE* fp)

Opens a file with the given file pointer, which has already been opened.

Parameters

filename
The filename.

mode
The mode in which to open the file using standard C strings. Note that you should use "b" flag if you use binary files under Windows or the results might be unexpected due to automatic newline conversion done for the text files.

fp
An existing file descriptor, such as stderr.



wxFFile::~wxFFile



~wxFFile(void)

Destructor will close the file.

NB: it is not virtual so you should not derive from wxFFile!



wxFFile::Attach



void Attach(FILE* fp)

Attaches an existing file pointer to the wxFFile object.

The descriptor should be already opened and it will be closed by wxFFile object.



wxFFile::Close



bool Close(void)

Closes the file and returns TRUEon success.



wxFFile::Detach



void Detach(void)

Get back a file pointer from wxFFile object - the caller is responsible for closing the file if this descriptor is opened. IsOpened() will return FALSEafter call to Detach().



wxFFile::fp

FILE * fp(void) const

Returns the file pointer associated with the file.



wxFFile::Eof

bool Eof(void) const

Returns TRUEif the an attempt has been made to read past the end of the file.

Note that the behaviour of the file descriptor based class wxFile is different as wxFile::Eof will return TRUEhere as soon as the last byte of the file has been read.

Also note that this method may only be called for opened files and may crash if the file is not opened.

See also

IsOpened



wxFFile::Error

Returns TRUEif an error has occurred on this file, similar to the standard ferror() function.

Please note that this method may only be called for opened files and may crash if the file is not opened.

See also

IsOpened



wxFFile::Flush



bool Flush(void)

Flushes the file and returns TRUEon success.



wxFFile::GetKind

wxFileKind GetKind(void) const

Returns the type of the file. Possible return values are:

enum wxFileKind
{
  wxFILE_KIND_UNKNOWN,
  wxFILE_KIND_DISK,     // a file supporting seeking to arbitrary offsets
  wxFILE_KIND_TERMINAL, // a tty
  wxFILE_KIND_PIPE      // a pipe
};



wxFFile::IsOpened

bool IsOpened(void) const

Returns TRUEif the file is opened. Most of the methods of this class may only be used for an opened file.



wxFFile::Length

wxFileOffset Length(void) const

Returns the length of the file.



wxFFile::Open



bool Open(const char* filename, const char* mode = "r")

Opens the file, returning TRUEif successful.

Parameters

filename
The filename.

mode
The mode in which to open the file.



wxFFile::Read



size_t Read(void* buffer, size_t count)

Reads the specified number of bytes into a buffer, returning the actual number read.

Parameters

buffer
A buffer to receive the data.

count
The number of bytes to read.

Return value

The number of bytes read.



wxFFile::ReadAll



bool ReadAll(wxString * str, wxMBConv& conv = wxConvUTF8)

Reads the entire contents of the file into a string.

Parameters

str
String to read data into.

conv
Conversion object to use in Unicode build; by default supposes that file contents is encoded in UTF-8.

Return value

TRUEif file was read successfully, FALSEotherwise.



wxFFile::Seek



bool Seek(wxFileOffset ofs, wxSeekMode mode = wxFromStart)

Seeks to the specified position and returns TRUEon success.

Parameters

ofs
Offset to seek to.

mode
One of wxFromStart, wxFromEnd, wxFromCurrent.



wxFFile::SeekEnd



bool SeekEnd(wxFileOffset ofs = 0)

Moves the file pointer to the specified number of bytes before the end of the file and returns TRUEon success.

Parameters

ofs
Number of bytes before the end of the file.



wxFFile::Tell

wxFileOffset Tell(void) const

Returns the current position.



wxFFile::Write



size_t Write(const void* buffer, size_t count)

Writes the specified number of bytes from a buffer.

Parameters

buffer
A buffer containing the data.

count
The number of bytes to write.

Return value

Number of bytes written.



wxFFile::Write



bool Write(const wxString& s, wxMBConv& conv = wxConvUTF8)

Writes the contents of the string to the file, returns TRUEon success.

The second argument is only meaningful in Unicode build of wxWidgets when conv is used to convert s to multibyte representation.

ymasuda 平成17年11月19日