Library: Foundation
Package: Streams
Header: Poco/FileStream.h
Description
The base class for FileInputStream and FileOutputStream.
This class is needed to ensure the correct initialization order of the stream buffer and base classes.
Files are always opened in binary mode, a text mode with CR-LF translation is not supported. Thus, the file is always opened as if the std::ios::binary flag was specified. Use an InputLineEndingConverter or OutputLineEndingConverter if you require CR-LF translation.
On Windows platforms, if POCO_WIN32_UTF8 is #define'd, UTF-8 encoded Unicode paths are correctly handled.
Inheritance
Direct Base Classes: std::ios
All Base Classes: std::ios
Known Derived Classes: FileInputStream, FileOutputStream, FileStream
Member Summary
Member Functions: close, open, rdbuf
Constructors
FileIOS
FileIOS(
std::ios::openmode defaultMode
);
Creates the basic stream.
Destructor
~FileIOS
~FileIOS();
Destroys the stream.
Member Functions
close
void close();
Closes the file stream.
open
void open(
const std::string & path,
std::ios::openmode mode
);
Opens the file specified by path, using the given mode.
Throws a FileException (or a similar exception) if the file does not exist or is not accessible for other reasons and a new file cannot be created.
rdbuf
FileStreamBuf * rdbuf();
Returns a pointer to the underlying streambuf.
Variables
_buf 
FileStreamBuf _buf;
_defaultMode
std::ios::openmode _defaultMode;