An ISstream with internal List storage. Always UNCOMPRESSED. More...
Public Member Functions | |
ICharStream (IOstreamOption streamOpt=IOstreamOption()) | |
Default construct (empty), optionally with specified stream option. More... | |
ICharStream (const std::string &buffer, IOstreamOption streamOpt=IOstreamOption()) | |
Copy construct from string content. More... | |
ICharStream (List< char > &&buffer, IOstreamOption streamOpt=IOstreamOption()) | |
Move construct from List. More... | |
template<int SizeMin> | |
ICharStream (DynamicList< char, SizeMin > &&buffer, IOstreamOption streamOpt=IOstreamOption()) | |
Move construct from DynamicList (uses current size) More... | |
std::streampos | tellg () const |
Position of the get buffer. More... | |
std::streampos | input_pos () const |
The current get position within the buffer (tellg) More... | |
label | size () const |
The input list size. Same as capacity() More... | |
std::streamsize | capacity () const |
The get buffer capacity. More... | |
std::streamsize | remaining () const |
The number of characters remaining in the get area. Same as (capacity() - input_pos()) More... | |
UList< char > | list () const |
Span of the input characters (is modifiable!) More... | |
auto | view () const -> decltype(stream_.view()) |
A string_view (c++17) or span view (older c++) of buffer contents. More... | |
auto | str () const -> decltype(stream_.str()) |
For IStringStream compatibility, return the buffer as string copy. More... | |
void | reset (const char *buffer, size_t nbytes) |
Reset content (copy) More... | |
void | swap (List< char > &other) |
Exchange stream content and parameter contents, reset positions. More... | |
template<int SizeMin> | |
void | swap (DynamicList< char, SizeMin > &other) |
Exchange stream content and parameter contents, reset positions. More... | |
DynamicList< char > | release () |
Reset stream and return contents as a List. More... | |
virtual void | rewind () override |
Rewind the stream, clearing any old errors. More... | |
virtual void | print (Ostream &os) const override |
Print stream description to Ostream. More... | |
Istream & | operator() () const |
A non-const reference to const Istream. More... | |
Public Member Functions inherited from ISstream | |
ISstream (std::istream &is, const string &streamName, IOstreamOption streamOpt=IOstreamOption()) | |
Construct wrapper around std::istream, set stream status. More... | |
ISstream (std::istream &is, const string &streamName, IOstreamOption::streamFormat fmt, IOstreamOption::compressionType cmp=IOstreamOption::UNCOMPRESSED) | |
Construct wrapper around std::istream, set stream status. More... | |
ISstream (std::istream &is, const string &streamName, IOstreamOption::streamFormat fmt, IOstreamOption::versionNumber ver, IOstreamOption::compressionType cmp=IOstreamOption::UNCOMPRESSED) | |
Construct wrapper around std::istream, set stream status. More... | |
virtual | ~ISstream ()=default |
Destructor. More... | |
virtual const fileName & | name () const override |
The name of the input serial stream. (eg, the name of the Fstream file name) More... | |
virtual fileName & | name () |
The name of the input serial stream, for modification. More... | |
virtual const std::istream & | stdStream () const |
Const access to underlying std::istream. More... | |
virtual std::istream & | stdStream () |
Access to underlying std::istream. More... | |
virtual std::ios_base::fmtflags | flags () const override |
Return current stream flags. More... | |
virtual std::ios_base::fmtflags | flags (std::ios_base::fmtflags f) override |
Set stream flags, return old stream flags. More... | |
void | syncState () |
Set stream state to match that of the std::istream. More... | |
**return False if stream exhausted before finding the comment end *bool | seekCommentEnd_Cstyle () |
Discard until end of C-style comment '. More... | |
bool | continueReadUntilRightBrace (std::string &str, const bool stripComments=true) |
Raw, low-level get into a string. Continues reading after an initial left-brace until it finds the matching closing right-brace. 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 (until delimiter) into a string. More... | |
std::streamsize | getLine (std::nullptr_t, char delim='\n') |
Low-level discard until delimiter. More... | |
ISstream & | putback (const char c) |
Raw, low-level putback character function. More... | |
virtual Istream & | read (token &t) override |
Return next token from stream. More... | |
virtual Istream & | read (char &c) override |
Read a character. More... | |
virtual Istream & | read (word &str) override |
Read a word. More... | |
virtual Istream & | read (string &str) override |
Read a string (including enclosing double-quotes). More... | |
virtual Istream & | read (label &val) override |
Read a label. More... | |
virtual Istream & | read (float &val) override |
Read a float. More... | |
virtual Istream & | read (double &val) override |
Read a double. More... | |
virtual Istream & | read (char *data, std::streamsize count) override |
Read binary block (with any possible block delimiters). Reading into a null pointer behaves like a forward seek of count characters. More... | |
virtual Istream & | readRaw (char *data, std::streamsize count) override |
Low-level raw binary read (without possible block delimiters). Reading into a null pointer behaves like a forward seek of count characters. More... | |
virtual bool | beginRawRead () override |
Start of low-level raw binary read. More... | |
virtual bool | endRawRead () override |
End of low-level raw binary read. More... | |
Public Member Functions inherited from Istream | |
Istream (const Istream &)=default | |
Copy construct. More... | |
virtual | ~Istream ()=default |
Destructor. More... | |
Istream (IOstreamOption streamOpt=IOstreamOption()) | |
Default construct (ASCII, uncompressed), construct with specified stream option. More... | |
Istream (IOstreamOption::streamFormat fmt, IOstreamOption::compressionType cmp=IOstreamOption::UNCOMPRESSED) | |
Construct with format (uncompressed) More... | |
const token & | peekBack () const noexcept |
Examine putback token without removing it. More... | |
void | putBackClear () |
Drop the putback token. More... | |
void | putBack (const token &tok) |
Put back a token (copy). Only a single put back is permitted. More... | |
void | putBack (token &&tok) |
Put back a token (move). Only a single put back is permitted. More... | |
bool | getBack (token &tok) |
Retrieve the put-back token if there is one. 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 IOstream &)=default | |
Copy construct. More... | |
virtual | ~IOstream ()=default |
Destructor. More... | |
IOstream (IOstreamOption streamOpt=IOstreamOption()) | |
Default construct (ASCII, uncompressed), construct with specified stream option. More... | |
IOstream (IOstreamOption::streamFormat fmt, IOstreamOption::versionNumber ver, IOstreamOption::compressionType cmp=IOstreamOption::UNCOMPRESSED) | |
Construct with format, version (compression) More... | |
fileName | relativeName () const |
Return the name of the stream relative to the current case. More... | |
virtual bool | check (const char *operation) const |
Check IOstream status for given operation. More... | |
bool | fatalCheck (const char *operation) const |
Check IOstream status for given operation. More... | |
bool | opened () const noexcept |
True if stream has been opened. More... | |
bool | closed () const noexcept |
True if stream is closed. More... | |
bool | good () const noexcept |
True if next operation might succeed. More... | |
bool | eof () const noexcept |
True if end of input seen. More... | |
bool | fail () const noexcept |
True if next operation will fail. More... | |
bool | bad () const noexcept |
True if stream is corrupted. More... | |
operator bool () const noexcept | |
Return true if the stream has not failed. More... | |
bool | operator! () const noexcept |
Return true if the stream has failed. More... | |
unsigned | labelByteSize () const noexcept |
The sizeof (label) in bytes associated with the stream. More... | |
unsigned | scalarByteSize () const noexcept |
The sizeof (scalar) in bytes associated with the stream. More... | |
void | setLabelByteSize (unsigned nbytes) noexcept |
Set the sizeof (label) in bytes associated with the stream. More... | |
void | setScalarByteSize (unsigned nbytes) noexcept |
Set the sizeof (scalar) in bytes associated with the stream. More... | |
template<class T = label> | |
std::enable_if< std::is_integral< T >::value, bool >::type | checkLabelSize () const noexcept |
Check if the label byte-size associated with the stream is the same as the given type. More... | |
template<class T = scalar> | |
std::enable_if< std::is_floating_point< T >::value, bool >::type | checkScalarSize () const noexcept |
Check if the scalar byte-size associated with the stream is the same as the given type. More... | |
label | lineNumber () const noexcept |
Const access to the current stream line number. More... | |
label & | lineNumber () noexcept |
Non-const access to the current stream line number. More... | |
label | lineNumber (const label num) noexcept |
Set the stream line number. More... | |
void | setEof () noexcept |
Set stream state as reached 'eof'. More... | |
void | setFail () noexcept |
Set stream state as 'failed'. More... | |
void | setBad () noexcept |
Set stream state to be 'bad'. More... | |
std::ios_base::fmtflags | setf (std::ios_base::fmtflags f) |
Set stream flag(s), return old stream flags. More... | |
std::ios_base::fmtflags | setf (const std::ios_base::fmtflags f, const std::ios_base::fmtflags mask) |
Set stream flag(s) with mask, return old stream flags. More... | |
void | unsetf (std::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 noexcept |
Return info proxy, used to print IOstream information to a stream. More... | |
Public Member Functions inherited from IOstreamOption | |
constexpr | IOstreamOption (streamFormat fmt=streamFormat::ASCII, compressionType comp=compressionType::UNCOMPRESSED) noexcept |
Default construct (ASCII, UNCOMPRESSED, currentVersion) or construct with format, compression. More... | |
constexpr | IOstreamOption (streamFormat fmt, compressionType comp, versionNumber ver) noexcept |
Construct from components (format, compression, version) More... | |
constexpr | IOstreamOption (streamFormat fmt, versionNumber ver, compressionType comp=compressionType::UNCOMPRESSED) noexcept |
Construct from components (format, version, compression) More... | |
IOstreamOption (const IOstreamOption &opt, streamFormat fmt) noexcept | |
Copy construct with change of format. More... | |
streamFormat | format () const noexcept |
Get the current stream format. More... | |
streamFormat | format (const streamFormat fmt) 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 &compName) |
Set the stream compression from string value. More... | |
versionNumber | version () const noexcept |
Get the stream version. More... | |
versionNumber | version (const versionNumber ver) noexcept |
Set the stream version. More... | |
versionNumber | version (const token &tok) |
Set the stream version from token. 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 = 0, BINARY } |
Data format (ascii | binary) More... | |
enum | compressionType : char { UNCOMPRESSED = 0, COMPRESSED } |
Compression treatment (UNCOMPRESSED | COMPRESSED) More... | |
enum | appendType : char { NO_APPEND = 0, APPEND_APP, APPEND_ATE, NON_APPEND = NO_APPEND, APPEND = APPEND_APP } |
File appending (NO_APPEND | APPEND_APP | APPEND_ATE) More... | |
enum | atomicType : char { NON_ATOMIC = 0, ATOMIC } |
Atomic operations (output) More... | |
enum | floatFormat : unsigned { general = unsigned(0), fixed = unsigned(std::ios_base::fixed), scientific = unsigned(std::ios_base::scientific) } |
Float formats (eg, time directory name formats) More... | |
Static Public Member Functions inherited from IOstream | |
static unsigned int | defaultPrecision () noexcept |
Return the default precision. More... | |
static unsigned int | defaultPrecision (unsigned int prec) noexcept |
Reset the default precision. More... | |
static unsigned int | minPrecision (unsigned int prec) noexcept |
Set the minimum default precision. More... | |
Static Public Member Functions inherited from IOstreamOption | |
static floatFormat | floatFormatEnum (const word &fmtName, const floatFormat deflt=floatFormat::general) |
Lookup floatFormat enum corresponding to the string (general | fixed | scientific). More... | |
static floatFormat | floatFormatEnum (const word &key, const dictionary &dict, const floatFormat deflt=floatFormat::general) |
getOrDefault floatFormat from dictionary, warn only on bad enumeration. More... | |
static streamFormat | formatEnum (const word &fmtName, const streamFormat deflt=streamFormat::ASCII) |
Lookup streamFormat enum corresponding to the string (ascii | binary). More... | |
static streamFormat | formatEnum (const word &key, const dictionary &dict, const streamFormat deflt=streamFormat::ASCII) |
getOrDefault streamFormat from dictionary, warn only on bad enumeration. More... | |
static compressionType | compressionEnum (const word &compName, const compressionType deflt=compressionType::UNCOMPRESSED) |
The compression enum corresponding to the string. More... | |
static compressionType | compressionEnum (const word &key, const dictionary &dict, const compressionType deflt=compressionType::UNCOMPRESSED) |
getOrDefault compressionType from dictionary, warn only on bad enumeration. More... | |
Static Public Attributes inherited from IOstream | |
static unsigned int | precision_ |
Default precision. More... | |
Static Public Attributes inherited from IOstreamOption | |
static const Enum< floatFormat > | floatFormatNames |
Names for float formats (general, fixed, scientific) More... | |
static const Enum< streamFormat > | formatNames |
Stream format names (ascii, binary) More... | |
static const versionNumber | currentVersion |
The current version number (2.0) More... | |
Protected Member Functions inherited from StreamAllocator< Foam::icharstream > | |
StreamAllocator ()=default | |
Default construct (empty) More... | |
Protected Member Functions inherited from Istream | |
bool | hasPutback () const noexcept |
True if putback token is in use. More... | |
Protected Member Functions inherited from IOstream | |
void | setOpened () noexcept |
Set stream opened. More... | |
void | setClosed () noexcept |
Set stream closed. More... | |
void | setState (std::ios_base::iostate state) noexcept |
Set stream state. More... | |
void | setGood () noexcept |
Set stream state to be good. More... | |
Protected Attributes inherited from StreamAllocator< Foam::icharstream > | |
Foam::icharstream | stream_ |
The std::stream. More... | |
Protected Attributes inherited from IOstream | |
std::ios_base::iostate | ioState_ |
Mirror of internal stream io state. More... | |
streamAccess | openClosed_ |
The stream open/closed state. More... | |
unsigned char | sizeofLabel_ |
The sizeof (label), possibly read from the header. More... | |
unsigned char | sizeofScalar_ |
The sizeof (scalar), possibly read from the header. 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... | |
An ISstream with internal List storage. Always UNCOMPRESSED.
An input stream that reads from a List and manages the List storage. Similar to IStringStream but with a List for its storage instead of as string to allow reuse of List contents without copying.
Definition at line 241 of file ICharStream.H.
|
inlineexplicit |
Default construct (empty), optionally with specified stream option.
Definition at line 258 of file ICharStream.H.
|
inlineexplicit |
Copy construct from string content.
Definition at line 270 of file ICharStream.H.
References icharstream::reset(), and StreamAllocator< Foam::icharstream >::stream_.
|
inlineexplicit |
Move construct from List.
Definition at line 284 of file ICharStream.H.
References StreamAllocator< Foam::icharstream >::stream_, and icharstream::swap().
|
inlineexplicit |
Move construct from DynamicList (uses current size)
Definition at line 299 of file ICharStream.H.
References StreamAllocator< Foam::icharstream >::stream_, and icharstream::swap().
|
inline |
Position of the get buffer.
Definition at line 315 of file ICharStream.H.
References icharstream::input_pos(), and StreamAllocator< Foam::icharstream >::stream_.
|
inline |
The current get position within the buffer (tellg)
Definition at line 320 of file ICharStream.H.
References icharstream::input_pos(), and StreamAllocator< Foam::icharstream >::stream_.
|
inline |
The input list size. Same as capacity()
Definition at line 325 of file ICharStream.H.
References icharstream::capacity(), and StreamAllocator< Foam::icharstream >::stream_.
|
inline |
The get buffer capacity.
Definition at line 330 of file ICharStream.H.
References icharstream::capacity(), and StreamAllocator< Foam::icharstream >::stream_.
|
inline |
The number of characters remaining in the get area. Same as (capacity() - input_pos())
Definition at line 336 of file ICharStream.H.
References icharstream::remaining(), and StreamAllocator< Foam::icharstream >::stream_.
|
inline |
Span of the input characters (is modifiable!)
Definition at line 341 of file ICharStream.H.
References icharstream::list(), and StreamAllocator< Foam::icharstream >::stream_.
|
inline |
A string_view (c++17) or span view (older c++) of buffer contents.
Definition at line 346 of file ICharStream.H.
References StreamAllocator< Foam::icharstream >::stream_, and icharstream::view().
|
inline |
For IStringStream compatibility, return the buffer as string copy.
Use sparingly - it creates a full copy!!
Definition at line 356 of file ICharStream.H.
References icharstream::str(), and StreamAllocator< Foam::icharstream >::stream_.
|
inline |
Reset content (copy)
Definition at line 364 of file ICharStream.H.
References icharstream::reset(), StreamAllocator< Foam::icharstream >::stream_, and ISstream::syncState().
|
inline |
Exchange stream content and parameter contents, reset positions.
Definition at line 373 of file ICharStream.H.
References StreamAllocator< Foam::icharstream >::stream_, icharstream::swap(), and ISstream::syncState().
|
inline |
Exchange stream content and parameter contents, reset positions.
Definition at line 383 of file ICharStream.H.
References StreamAllocator< Foam::icharstream >::stream_, icharstream::swap(), and ISstream::syncState().
|
inline |
Reset stream and return contents as a List.
Definition at line 392 of file ICharStream.H.
References icharstream::release(), StreamAllocator< Foam::icharstream >::stream_, and ISstream::syncState().
|
inlineoverridevirtual |
Rewind the stream, clearing any old errors.
Reimplemented from ISstream.
Definition at line 402 of file ICharStream.H.
References icharstream::rewind(), StreamAllocator< Foam::icharstream >::stream_, and ISstream::syncState().
|
overridevirtual |
Print stream description to Ostream.
Reimplemented from ISstream.
Definition at line 42 of file SpanStreams.C.
References Foam::endl(), and os().
|
inline |
A non-const reference to const Istream.
Needed for read-constructors where the stream argument is temporary
Definition at line 421 of file ICharStream.H.