Similar to IStringStream but using an externally managed buffer for its input. This allows the input buffer to be filled (and refilled) from various sources. More...
Public Member Functions | |
UIListStream (const char *buffer, size_t nbytes, streamFormat format=ASCII, versionNumber version=currentVersion, const Foam::string &name="input") | |
Construct using specified buffer and number of bytes. More... | |
template<unsigned N> | |
UIListStream (const FixedList< char, N > &buffer, streamFormat format=ASCII, versionNumber version=currentVersion, const Foam::string &name="input") | |
Construct using data area from a FixedList. More... | |
UIListStream (const UList< char > &buffer, label size, streamFormat format=ASCII, versionNumber version=currentVersion, const Foam::string &name="input") | |
Construct using data area from a List and number of bytes. More... | |
UIListStream (const UList< char > &buffer, streamFormat format=ASCII, versionNumber version=currentVersion, const Foam::string &name="input") | |
Construct using data area from a List and its inherent storage size. More... | |
std::streampos | pos () const |
Return the current get position in the buffer. More... | |
virtual void | rewind () |
Rewind the stream, clearing any old errors. More... | |
virtual void | print (Ostream &os) const |
Print description to Ostream. More... | |
Istream & | operator() () const |
A non-const reference to const Istream. More... | |
Public Member Functions inherited from UIListStreamAllocator | |
const UList< char > | list () const |
Const UList access to the input characters (shallow copy). More... | |
UList< char > | list () |
Non-const UList access to the input characters (shallow copy). More... | |
label | size () const |
The list size. More... | |
std::streampos | tellg () const |
Position of the get buffer. More... | |
void | rewind () |
Move to buffer start, clear errors. More... | |
Public Member Functions inherited from ISstream | |
ISstream (std::istream &is, const string &name, streamFormat format=ASCII, versionNumber version=currentVersion, compressionType compression=UNCOMPRESSED) | |
Construct as wrapper around std::istream. More... | |
virtual | ~ISstream ()=default |
Destructor. More... | |
virtual const fileName & | name () const |
Return the name of the stream. More... | |
virtual fileName & | name () |
Return non-const access to the name of the stream. More... | |
virtual ios_base::fmtflags | flags () const |
Return flags of output stream. More... | |
ISstream & | get (char &c) |
Raw, low-level get character function. More... | |
int | peek () |
Raw, low-level peek function. More... | |
ISstream & | getLine (std::string &str, char delim='\n') |
Raw, low-level getline into a string function. More... | |
ISstream & | putback (const char c) |
Raw, low-level putback character function. More... | |
virtual Istream & | read (token &t) |
Return next token from stream. More... | |
virtual Istream & | read (char &c) |
Read a character. More... | |
virtual Istream & | read (word &str) |
Read a word. More... | |
virtual Istream & | read (string &str) |
Read a string (including enclosing double-quotes). More... | |
virtual Istream & | read (label &val) |
Read a label. More... | |
virtual Istream & | read (floatScalar &val) |
Read a floatScalar. More... | |
virtual Istream & | read (doubleScalar &val) |
Read a doubleScalar. More... | |
virtual Istream & | read (char *buf, std::streamsize count) |
Read binary block. More... | |
virtual Istream & | readRaw (char *data, std::streamsize count) |
Low-level raw binary read. More... | |
virtual bool | beginRawRead () |
Start of low-level raw binary read. More... | |
virtual bool | endRawRead () |
End of low-level raw binary read. More... | |
virtual ios_base::fmtflags | flags (const ios_base::fmtflags flags) |
Set stream flags. More... | |
virtual std::istream & | stdStream () |
Access to underlying std::istream. More... | |
virtual const std::istream & | stdStream () const |
Const access to underlying std::istream. More... | |
Public Member Functions inherited from Istream | |
Istream (streamFormat format=ASCII, versionNumber version=currentVersion, compressionType compression=UNCOMPRESSED) | |
Construct and set stream status. More... | |
virtual | ~Istream ()=default |
Destructor. More... | |
void | putBack (const token &tok) |
Put back token. More... | |
bool | getBack (token &tok) |
Get the put back token if there is one and return true. More... | |
bool | peekBack (token &tok) |
Peek at the put back token without removing it. More... | |
bool | readBegin (const char *funcName) |
Begin read of data chunk, starts with '('. More... | |
bool | readEnd (const char *funcName) |
End read of data chunk, ends with ')'. More... | |
char | readBeginList (const char *funcName) |
Begin read of list data, starts with '(' or '{'. More... | |
char | readEndList (const char *funcName) |
End read of list data, ends with ')' or '}'. More... | |
Istream & | operator() () const |
Return a non-const reference to const Istream. More... | |
Public Member Functions inherited from IOstream | |
IOstream (const IOstreamOption option) | |
Construct with specified stream option. More... | |
IOstream (streamFormat format, versionNumber version, compressionType compression=UNCOMPRESSED) | |
Construct with format, version. More... | |
virtual | ~IOstream ()=default |
Destructor. More... | |
virtual bool | check (const char *operation) const |
Check IOstream status for given operation. More... | |
void | fatalCheck (const char *operation) const |
Check IOstream status for given operation. More... | |
bool | opened () const |
Return true if stream has been opened. More... | |
bool | closed () const |
Return true if stream is closed. More... | |
bool | good () const |
Return true if next operation might succeed. More... | |
bool | eof () const |
Return true if end of input seen. More... | |
bool | fail () const |
Return true if next operation will fail. More... | |
bool | bad () const |
Return true if stream is corrupted. More... | |
operator bool () const | |
Return true if the stream has not failed. More... | |
bool | operator! () const |
Return true if the stream has failed. More... | |
unsigned | labelByteSize () const |
The label byte-size associated with the stream. More... | |
unsigned | scalarByteSize () const |
The scalar byte-size associated with the stream. More... | |
void | setLabelByteSize (unsigned nbytes) |
Set the label byte-size associated with the stream. More... | |
void | setScalarByteSize (unsigned nbytes) |
Set the scalar byte-size associated with the stream. More... | |
template<class T = label> | |
std::enable_if< std::is_integral< T >::value, bool >::type | checkLabelSize () const |
template<class T = scalar> | |
std::enable_if< std::is_floating_point< T >::value, bool >::type | checkScalarSize () const |
label | lineNumber () const |
Const access to the current stream line number. More... | |
label & | lineNumber () |
Non-const access to the current stream line number. More... | |
label | lineNumber (const label num) |
Set the stream line number. More... | |
void | setEof () |
Set stream to have reached eof. More... | |
void | setFail () |
Set stream to have failed. More... | |
void | setBad () |
Set stream to be bad. More... | |
ios_base::fmtflags | setf (const ios_base::fmtflags f) |
Set flags of stream. More... | |
ios_base::fmtflags | setf (const ios_base::fmtflags f, const ios_base::fmtflags mask) |
Set flags of given field of stream. More... | |
void | unsetf (const ios_base::fmtflags f) |
Unset flags of stream. More... | |
void | print (Ostream &os, const int streamState) const |
Print information about the stream state bits. More... | |
InfoProxy< IOstream > | info () const |
Return info proxy. More... | |
Public Member Functions inherited from IOstreamOption | |
IOstreamOption () noexcept | |
Construct null. (default: ASCII, uncompressed, currentVersion) More... | |
IOstreamOption (streamFormat format) noexcept | |
Construct with format. (default: uncompressed, currentVersion) More... | |
IOstreamOption (streamFormat format, compressionType compression, versionNumber version=currentVersion) noexcept | |
Construct with format and compression, optionally with version. More... | |
IOstreamOption (streamFormat format, versionNumber version, compressionType compression) noexcept | |
Construct with format, version, compression. More... | |
streamFormat | format () const noexcept |
Get the current stream format. More... | |
streamFormat | format (const streamFormat format) noexcept |
Set the stream format. More... | |
streamFormat | format (const word &formatName) |
Set the stream format, from string value. More... | |
compressionType | compression () const noexcept |
Get the stream compression. More... | |
compressionType | compression (const compressionType comp) noexcept |
Set the stream compression. More... | |
compressionType | compression (const word &compressionName) |
Set the stream compression, from string value. More... | |
versionNumber | version () const noexcept |
Get the stream version. More... | |
versionNumber | version (const versionNumber verNum) noexcept |
Set the stream version. More... | |
Additional Inherited Members | |
Public Types inherited from IOstream | |
enum | streamAccess : char { CLOSED = 0, OPENED } |
Enumeration for stream open/closed state. More... | |
Public Types inherited from IOstreamOption | |
enum | streamFormat : char { ASCII, BINARY } |
Data format (ascii | binary) More... | |
enum | compressionType : char { UNCOMPRESSED = 0, COMPRESSED } |
Compression treatment (UNCOMPRESSED | COMPRESSED) More... | |
Static Public Member Functions inherited from IOstream | |
static unsigned int | defaultPrecision () |
Return the default precision. More... | |
static unsigned int | defaultPrecision (unsigned int prec) |
Reset the default precision. More... | |
Static Public Member Functions inherited from IOstreamOption | |
static streamFormat | formatEnum (const word &formatName) |
The stream format enum corresponding to the string. More... | |
static compressionType | compressionEnum (const word &compName) |
The compression enum corresponding to the string. More... | |
Static Public Attributes inherited from IOstream | |
static unsigned int | precision_ |
Default precision. More... | |
Static Public Attributes inherited from IOstreamOption | |
static const Enum< streamFormat > | formatNames |
Stream format names (ascii, binary) More... | |
static const versionNumber | originalVersion |
The original version number. More... | |
static const versionNumber | currentVersion |
The current version number. More... | |
Protected Types inherited from UIListStreamAllocator | |
typedef std::istream | stream_type |
Protected Member Functions inherited from UIListStreamAllocator | |
UIListStreamAllocator (char *buffer, size_t nbytes) | |
Construct for character array and number of bytes. More... | |
void | reset (char *buffer, size_t nbytes) |
Reset buffer pointers. More... | |
void | printBufInfo (Ostream &os) const |
Protected Member Functions inherited from IOstream | |
void | setOpened () |
Set stream opened. More... | |
void | setClosed () |
Set stream closed. More... | |
void | setState (ios_base::iostate state) |
Set stream state. More... | |
void | setGood () |
Set stream to be good. More... | |
Protected Attributes inherited from UIListStreamAllocator | |
memorybuf::in | buf_ |
The stream buffer. More... | |
stream_type | stream_ |
The stream. More... | |
Protected Attributes inherited from IOstream | |
streamAccess | openClosed_ |
ios_base::iostate | ioState_ |
unsigned short | labelByteSize_ |
The label byte-size (could also be stored as byte) More... | |
unsigned short | scalarByteSize_ |
The scalar byte-size (could also be stored as byte) More... | |
label | lineNumber_ |
The file line. More... | |
Static Protected Attributes inherited from IOstream | |
static fileName | staticName_ |
Name for any generic stream - normally treat as readonly. More... | |
Similar to IStringStream but using an externally managed buffer for its input. This allows the input buffer to be filled (and refilled) from various sources.
Note that this stream will normally be used as a "one-shot" reader. Caution must be exercised that the referenced buffer remains valid and without any intermediate resizing for the duration of the stream's use.
An example of possible use:
Definition at line 202 of file UIListStream.H.
|
inline |
Construct using specified buffer and number of bytes.
Definition at line 215 of file UIListStream.H.
|
inline |
Construct using data area from a FixedList.
Definition at line 231 of file UIListStream.H.
|
inline |
Construct using data area from a List and number of bytes.
Definition at line 243 of file UIListStream.H.
|
inline |
Construct using data area from a List and its inherent storage size.
Uses addressed size, thus no special treatment for a DynamicList
Definition at line 258 of file UIListStream.H.
|
inline |
Return the current get position in the buffer.
Definition at line 272 of file UIListStream.H.
References UIListStreamAllocator::tellg().
|
inlinevirtual |
Rewind the stream, clearing any old errors.
Reimplemented from ISstream.
Definition at line 278 of file UIListStream.H.
References UIListStreamAllocator::rewind(), and IOstream::setGood().
|
virtual |
Print description to Ostream.
Reimplemented from ISstream.
Definition at line 42 of file ListStream.C.
References Foam::endl().
|
inline |
A non-const reference to const Istream.
Needed for read-constructors where the stream argument is temporary
Definition at line 292 of file UIListStream.H.