An Ostream is an abstract base class for all output systems (streams, files, token lists, etc). More...
#include <Ostream.H>


Public Member Functions | |
| Ostream (const Ostream &)=default | |
| Copy construct. | |
| virtual | ~Ostream ()=default |
| Destructor. | |
| Ostream (IOstreamOption streamOpt=IOstreamOption()) | |
| Default construct (ASCII, uncompressed), construct with specified stream option. | |
| Ostream (IOstreamOption::streamFormat fmt, IOstreamOption::compressionType cmp=IOstreamOption::UNCOMPRESSED) | |
| Construct with format (uncompressed). | |
| virtual bool | write (const token &tok)=0 |
| Write token to stream or otherwise handle it. | |
| virtual Ostream & | write (const char c)=0 |
| Write character. | |
| virtual Ostream & | writeQuoted (const char *str, std::streamsize len, const bool quoted=true)=0 |
| Write character/string content, with/without surrounding quotes. | |
| virtual Ostream & | writeQuoted (const std::string &str, const bool quoted=true) |
| Write string content, with/without surrounding quotes. | |
| virtual Ostream & | write (const char *str)=0 |
| Write character string. | |
| virtual Ostream & | write (const word &str)=0 |
| Write word (unquoted). | |
| virtual Ostream & | write (const std::string &str)=0 |
| Write string content (usually quoted). | |
| virtual Ostream & | write (const keyType &kw) |
| Write keyType. | |
| virtual Ostream & | write (const int32_t val)=0 |
| Write int32_t. | |
| virtual Ostream & | write (const int64_t val)=0 |
| Write int64_t. | |
| virtual Ostream & | write (const uint32_t val)=0 |
| Write uint32_t. | |
| virtual Ostream & | write (const uint64_t val)=0 |
| Write uint64_t. | |
| virtual Ostream & | write (const float val)=0 |
| Write float. | |
| virtual Ostream & | write (const double val)=0 |
| Write double. | |
| virtual Ostream & | write (const char *data, std::streamsize count)=0 |
| Write binary block. | |
| virtual Ostream & | writeRaw (const char *data, std::streamsize count)=0 |
| Low-level raw binary output. | |
| virtual bool | beginRawWrite (std::streamsize count)=0 |
| Emit begin marker for low-level raw binary output. | |
| virtual bool | endRawWrite ()=0 |
| Emit end marker for low-level raw binary output. | |
| virtual void | indent ()=0 |
| Add indentation characters. | |
| unsigned short | indentSize () const noexcept |
| Return indent size (spaces per level). | |
| unsigned short | indentSize (unsigned short val) noexcept |
| Change indent size (spaces per level), return old value. | |
| unsigned short | indentLevel () const noexcept |
| Return the indent level. | |
| unsigned short | indentLevel (unsigned short val) noexcept |
| Change the indent level, return old value. | |
| void | incrIndent () noexcept |
| Increment the indent level. | |
| void | decrIndent () |
| Decrement the indent level. | |
| virtual Ostream & | writeKeyword (const keyType &kw) |
| Write the keyword followed by an appropriate indentation. | |
| virtual Ostream & | beginBlock (const keyType &kw) |
| Write begin block group with the given name. | |
| virtual Ostream & | beginBlock () |
| Write begin block group without a name. | |
| virtual Ostream & | endBlock () |
| Write end block group. | |
| virtual Ostream & | endEntry () |
| Write end entry (';') followed by newline. | |
| template<class T> | |
| Ostream & | writeEntry (const keyType &key, const T &value) |
| Write a keyword/value entry. | |
| template<class T> | |
| Ostream & | writeEntryIfDifferent (const word &key, const T &value1, const T &value2) |
| Write a keyword/value entry only when the two values differ. | |
| virtual void | flush ()=0 |
| Flush stream. | |
| virtual void | endl ()=0 |
| Add newline and flush stream. | |
| virtual char | fill () const =0 |
| Get padding character. | |
| virtual char | fill (const char fillch)=0 |
| Set padding character for formatted field up to field width. | |
| virtual int | width () const =0 |
| Get width of output field. | |
| virtual int | width (const int w)=0 |
| Set width of output field (and return old width). | |
| virtual int | precision () const =0 |
| Get precision of output field. | |
| virtual int | precision (const int p)=0 |
| Set precision of output field (and return old precision). | |
| Ostream & | operator() () const |
| Return a non-const reference to const Ostream. | |
| unsigned short & | indentLevel () noexcept |
| Access to indent level. | |
| unsigned short & | indentSize () noexcept |
| Access to indent size. | |
| Public Member Functions inherited from IOstream | |
| IOstream (const IOstream &)=default | |
| Copy construct. | |
| virtual | ~IOstream ()=default |
| Destructor. | |
| IOstream (IOstreamOption streamOpt=IOstreamOption()) | |
| Default construct (ASCII, uncompressed), construct with specified stream option. | |
| IOstream (IOstreamOption::streamFormat fmt, IOstreamOption::versionNumber ver, IOstreamOption::compressionType cmp=IOstreamOption::UNCOMPRESSED) | |
| Construct with format, version (compression). | |
| virtual const fileName & | name () const |
| The name of the stream. | |
| fileName | relativeName () const |
| Return the name of the stream relative to the current case. | |
| virtual bool | check (const char *operation) const |
| Check IOstream status for given operation. | |
| bool | fatalCheck (const char *operation) const |
| Check IOstream status for given operation. | |
| bool | opened () const noexcept |
| True if stream has been opened. | |
| bool | closed () const noexcept |
| True if stream is closed. | |
| bool | good () const noexcept |
| True if next operation might succeed. | |
| bool | eof () const noexcept |
| True if end of input seen. | |
| bool | fail () const noexcept |
| True if next operation will fail. | |
| bool | bad () const noexcept |
| True if stream is corrupted. | |
| operator bool () const noexcept | |
| True if the stream has not failed. | |
| bool | operator! () const noexcept |
| True if the stream has failed. | |
| unsigned | labelByteSize () const noexcept |
| The sizeof (label) in bytes associated with the stream. | |
| unsigned | scalarByteSize () const noexcept |
| The sizeof (scalar) in bytes associated with the stream. | |
| void | setLabelByteSize (unsigned nbytes) noexcept |
| Set the sizeof (label) in bytes associated with the stream. | |
| void | setScalarByteSize (unsigned nbytes) noexcept |
| Set the sizeof (scalar) in bytes associated with the stream. | |
| template<class T, class = std::enable_if_t<std::is_integral_v<T>>> | |
| bool | checkLabelSize () const noexcept |
| Test if the label byte-size associated with the stream is the same as the given type. | |
| template<class T, class = std::enable_if_t<std::is_floating_point_v<T>>> | |
| bool | checkScalarSize () const noexcept |
| Test if the scalar byte-size associated with the stream is the same as the given type. | |
| bool | checkNativeSizes () const noexcept |
| Test if the label/scalar byte-size associated with the stream are the native label/scalar sizes. | |
| bool | fatalCheckNativeSizes (const char *operation) const |
| Assert that the label/scalar byte-size associated with the stream are the native label/scalar sizes. | |
| label | lineNumber () const noexcept |
| Const access to the current stream line number. | |
| label & | lineNumber () noexcept |
| Non-const access to the current stream line number. | |
| label | lineNumber (const label num) noexcept |
| Set the stream line number. | |
| void | setEof () noexcept |
| Set stream state as reached 'eof'. | |
| void | setFail () noexcept |
| Set stream state as 'failed'. | |
| void | setBad () noexcept |
| Set stream state to be 'bad'. | |
| virtual std::ios_base::fmtflags | flags () const =0 |
| Return current stream flags. | |
| virtual std::ios_base::fmtflags | flags (std::ios_base::fmtflags)=0 |
| Set stream flags, return old stream flags. | |
| std::ios_base::fmtflags | setf (std::ios_base::fmtflags f) |
| Set stream flag(s), return old stream flags. | |
| 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. | |
| std::ios_base::fmtflags | unsetf (std::ios_base::fmtflags f) |
| Unset stream flags, return old stream flags. | |
| virtual void | print (Ostream &os) const |
| Print stream description to Ostream. | |
| void | print (Ostream &os, const int streamState) const |
| Print information about the stream state bits. | |
| InfoProxy< IOstream > | info () const noexcept |
| Return info proxy, used to print IOstream information to a stream. | |
| 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. | |
| constexpr | IOstreamOption (streamFormat fmt, compressionType comp, versionNumber ver) noexcept |
| Construct from components (format, compression, version). | |
| constexpr | IOstreamOption (streamFormat fmt, versionNumber ver, compressionType comp=compressionType::UNCOMPRESSED) noexcept |
| Construct from components (format, version, compression). | |
| IOstreamOption (const IOstreamOption &opt, streamFormat fmt) noexcept | |
| Copy construct with change of format. | |
| streamFormat | format () const noexcept |
| Get the current stream format. | |
| streamFormat | format (const streamFormat fmt) noexcept |
| Set the stream format. | |
| streamFormat | format (const word &formatName) |
| Set the stream format from string value. | |
| compressionType | compression () const noexcept |
| Get the stream compression. | |
| compressionType | compression (const compressionType comp) noexcept |
| Set the stream compression. | |
| compressionType | compression (const word &compName) |
| Set the stream compression from string value. | |
| versionNumber | version () const noexcept |
| Get the stream version. | |
| versionNumber | version (const versionNumber ver) noexcept |
| Set the stream version. | |
| versionNumber | version (const token &tok) |
| Set the stream version from token. | |
Protected Attributes | |
| unsigned short | indentSize_ = 4 |
| Number of spaces per indent level. | |
| unsigned short | indentLevel_ = 0 |
| Current indent level. | |
| Protected Attributes inherited from IOstream | |
| std::ios_base::iostate | ioState_ |
| Mirror of internal stream io state. | |
| streamAccess | openClosed_ |
| The stream open/closed state. | |
| unsigned char | sizeofLabel_ |
| The sizeof (label), possibly read from the header. | |
| unsigned char | sizeofScalar_ |
| The sizeof (scalar), possibly read from the header. | |
| label | lineNumber_ |
| The file line. | |
Static Protected Attributes | |
| static constexpr const unsigned short | entryIndentation_ = 16 |
| Indentation of the entry from the start of the keyword. | |
| Static Protected Attributes inherited from IOstream | |
| static fileName | staticName_ |
| Name for any generic stream - normally treat as readonly. | |
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 , COHERENT , UNKNOWN_FORMAT } |
| Data format (ascii | binary | coherent). 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 class | 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. | |
| static unsigned int | defaultPrecision (unsigned int prec) noexcept |
| Reset the default precision. | |
| static unsigned int | minPrecision (unsigned int prec) noexcept |
| Set the minimum default precision. | |
| 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). | |
| static floatFormat | floatFormatEnum (const word &key, const dictionary &dict, const floatFormat deflt=floatFormat::general) |
| getOrDefault floatFormat from dictionary, warn only on bad enumeration. | |
| static streamFormat | formatEnum (const word &fmtName, const streamFormat deflt=streamFormat::ASCII) |
| Lookup streamFormat enum corresponding to the string (ascii | binary). | |
| static streamFormat | formatEnum (const word &key, const dictionary &dict, const streamFormat deflt=streamFormat::ASCII) |
| getOrDefault streamFormat from dictionary, warn only on bad enumeration. | |
| static compressionType | compressionEnum (const word &compName, const compressionType deflt=compressionType::UNCOMPRESSED) |
| The compression enum corresponding to the string. | |
| static compressionType | compressionEnum (const word &key, const dictionary &dict, const compressionType deflt=compressionType::UNCOMPRESSED) |
| getOrDefault compressionType from dictionary, warn only on bad enumeration. | |
| Static Public Attributes inherited from IOstream | |
| static unsigned int | precision_ |
| Default precision. | |
| Static Public Attributes inherited from IOstreamOption | |
| static const Enum< floatFormat > | floatFormatNames |
| Names for float formats (general, fixed, scientific). | |
| static const Enum< streamFormat > | formatNames |
| Stream format names (ascii, binary). | |
| static const versionNumber | currentVersion |
| The current version number (2.0). | |
| Protected Member Functions inherited from IOstream | |
| void | setOpened () noexcept |
| Set stream opened. | |
| void | setClosed () noexcept |
| Set stream closed. | |
| void | setState (std::ios_base::iostate state) noexcept |
| Set stream state. | |
| void | setGood () noexcept |
| Set stream state to be good. | |
An Ostream is an abstract base class for all output systems (streams, files, token lists, etc).
|
default |
Copy construct.
References Ostream().
Referenced by operator()(), OSstream::OSstream(), Ostream(), Ostream(), OTstream::OTstream(), OTstream::OTstream(), OTstream::OTstream(), OSstream::print(), OTstream::print(), UOPstreamBase::print(), UOPstreamBase::UOPstreamBase(), UOPstreamBase::UOPstreamBase(), UOPstreamBase::UOPstreamBase(), write(), write(), write(), write(), write(), write(), write(), write(), write(), write(), write(), writeEntry(), writeEntryIfDifferent(), writeQuoted(), and writeRaw().


|
virtualdefault |
Destructor.
|
inlineexplicit |
Default construct (ASCII, uncompressed), construct with specified stream option.
Definition at line 101 of file Ostream.H.
References IOstream::IOstream().

|
inlineexplicit |
Construct with format (uncompressed).
Definition at line 110 of file Ostream.H.
References Ostream(), and IOstreamOption::UNCOMPRESSED.

|
pure virtual |
Write token to stream or otherwise handle it.
Implemented in ensightFile, OSstream, OTstream, prefixOSstream, UOPstream, and UOPstreamBase.
Referenced by if(), ensightFile::newline(), OBJstream::write(), OBJstream::write(), OBJstream::write(), OBJstream::writeComment(), and OSstream::writeRaw().

|
pure virtual |
Write character.
Implemented in ensightFile, OBJstream, OSstream, OTstream, prefixOSstream, UOPstream, and UOPstreamBase.
References Ostream().

|
pure virtual |
Write character/string content, with/without surrounding quotes.
Implemented in OBJstream, OSstream, OTstream, prefixOSstream, and UOPstreamBase.
References Ostream().
Referenced by beginBlock(), JSONformatter::write(), JSONformatter::write(), write(), JSONformatter::writeEntry(), JSONformatter::writeKeyword(), writeKeyword(), OBJstream::writeQuoted(), and writeQuoted().


|
virtual |
Write string content, with/without surrounding quotes.
Reimplemented in OSstream, OTstream, prefixOSstream, and UOPstreamBase.
Definition at line 44 of file Ostream.C.
References writeQuoted().

|
pure virtual |
Write character string.
Implemented in ensightFile, OBJstream, OSstream, OTstream, prefixOSstream, UOPstream, and UOPstreamBase.
References Ostream().

Write word (unquoted).
Implemented in ensightFile, OBJstream, OSstream, OTstream, prefixOSstream, UOPstream, and UOPstreamBase.
References Ostream().

|
pure virtual |
Write string content (usually quoted).
Implemented in ensightFile, OBJstream, OSHA1stream, OSstream, OTstream, prefixOSstream, UOPstream, and UOPstreamBase.
References Ostream().

|
virtual |
Write keyType.
A plain word is written unquoted. A regular expression is written as a quoted string.
Definition at line 54 of file Ostream.C.
References keyType::isPattern(), and writeQuoted().

|
pure virtual |
Write int32_t.
Implemented in ensightFile, OSstream, OTstream, prefixOSstream, UOPstream, and UOPstreamBase.
References Ostream().

|
pure virtual |
Write int64_t.
Implemented in ensightFile, OSstream, OTstream, prefixOSstream, UOPstream, and UOPstreamBase.
References Ostream().

|
pure virtual |
Write uint32_t.
Implemented in OSstream, OTstream, prefixOSstream, UOPstream, and UOPstreamBase.
References Ostream().

|
pure virtual |
Write uint64_t.
Implemented in OSstream, OTstream, prefixOSstream, UOPstream, and UOPstreamBase.
References Ostream().

|
pure virtual |
Write float.
Implemented in ensightFile, OSstream, OTstream, prefixOSstream, UOPstream, and UOPstreamBase.
References Ostream().

|
pure virtual |
Write double.
Implemented in ensightFile, OSstream, OTstream, prefixOSstream, UOPstream, and UOPstreamBase.
References Ostream().

|
pure virtual |
Write binary block.
Implemented in ensightFile, OSstream, OTstream, prefixOSstream, UOPstream, and UOPstreamBase.
References Ostream().

|
pure virtual |
Low-level raw binary output.
Implemented in OSstream, OTstream, and UOPstreamBase.
References Ostream().

|
pure virtual |
Emit begin marker for low-level raw binary output.
The count indicates the number of bytes for subsequent writeRaw calls [currently only used by Pstream].
Implemented in OSstream, OTstream, and UOPstreamBase.
|
pure virtual |
Emit end marker for low-level raw binary output.
Implemented in OSstream, OTstream, and UOPstreamBase.
|
pure virtual |
Add indentation characters.
Implemented in OSstream, OTstream, prefixOSstream, and UOPstreamBase.
|
inlinenoexcept |
Return indent size (spaces per level).
Definition at line 243 of file Ostream.H.
References indentSize_, and Foam::noexcept.
|
inlinenoexcept |
Change indent size (spaces per level), return old value.
Definition at line 251 of file Ostream.H.
References indentSize_.
|
inlinenoexcept |
Return the indent level.
Definition at line 261 of file Ostream.H.
References indentLevel_, and Foam::noexcept.
|
inlinenoexcept |
Change the indent level, return old value.
Definition at line 269 of file Ostream.H.
References indentLevel_.
|
inlinenoexcept |
Increment the indent level.
Definition at line 279 of file Ostream.H.
References indentLevel_, and Foam::noexcept.
| void decrIndent | ( | ) |
|
virtual |
Write the keyword followed by an appropriate indentation.
Reimplemented in ensightFile, and ensightGeoFile.
Definition at line 60 of file Ostream.C.
References entryIndentation_, Foam::indent(), indentSize_, keyType::isPattern(), token::SPACE, write(), and writeQuoted().
Referenced by writeEntry().


|
virtual |
Write begin block group with the given name.
Increments indentation, adds newline.
Definition at line 90 of file Ostream.C.
References Foam::beginBlock(), Foam::indent(), keyType::isPattern(), write(), and writeQuoted().
Referenced by janafThermo< EquationOfState >::write(), LookupField< Type >::writeData(), and MappedFile< Type >::writeData().


|
virtual |
Write begin block group without a name.
Increments indentation, adds newline.
Definition at line 99 of file Ostream.C.
References token::BEGIN_BLOCK, Foam::incrIndent(), Foam::indent(), and write().

|
virtual |
Write end block group.
Decrements indentation, adds newline.
Definition at line 108 of file Ostream.C.
References Foam::decrIndent(), token::END_BLOCK, Foam::indent(), and write().

|
virtual |
Write end entry (';') followed by newline.
Definition at line 117 of file Ostream.C.
References token::END_STATEMENT, and write().
Referenced by writeEntry().


Write a keyword/value entry.
The following two are functionally equivalent:
Definition at line 331 of file Ostream.H.
References endEntry(), Ostream(), Foam::T(), and writeKeyword().
Referenced by writeEntryIfDifferent().


|
inline |
Write a keyword/value entry only when the two values differ.
| key | the name of the entry |
| value1 | the reference value |
| value2 | the value to write if it differs from value1 |
Definition at line 345 of file Ostream.H.
References Ostream(), Foam::T(), and writeEntry().

|
pure virtual |
Flush stream.
Implemented in OSstream, OTstream, and UOPstreamBase.
|
pure virtual |
Add newline and flush stream.
Implemented in OSstream, OTstream, and UOPstreamBase.
|
pure virtual |
Get padding character.
Implemented in OSstream, OTstream, and UOPstreamBase.
Referenced by Foam::setfill().

|
pure virtual |
Set padding character for formatted field up to field width.
Implemented in OSstream, OTstream, and UOPstreamBase.
|
pure virtual |
Get width of output field.
Implemented in OSstream, OTstream, and UOPstreamBase.
Referenced by Foam::setw().

|
pure virtual |
Set width of output field (and return old width).
Implemented in OSstream, OTstream, and UOPstreamBase.
|
pure virtual |
Get precision of output field.
Implemented in OSstream, OTstream, and UOPstreamBase.
Referenced by Foam::setprecision().

|
pure virtual |
Set precision of output field (and return old precision).
Implemented in OSstream, OTstream, and UOPstreamBase.
References p.
|
inline |
|
inlinenoexcept |
Access to indent level.
Definition at line 423 of file Ostream.H.
References indentLevel_, and Foam::noexcept.
|
inlinenoexcept |
Access to indent size.
Definition at line 431 of file Ostream.H.
References indentSize_, and Foam::noexcept.
|
staticconstexprprotected |
Indentation of the entry from the start of the keyword.
Definition at line 67 of file Ostream.H.
Referenced by writeKeyword().
|
protected |
Number of spaces per indent level.
Definition at line 72 of file Ostream.H.
Referenced by OSstream::indent(), indentSize(), indentSize(), indentSize(), and writeKeyword().
|
protected |
Current indent level.
Definition at line 77 of file Ostream.H.
Referenced by decrIndent(), incrIndent(), OSstream::indent(), indentLevel(), indentLevel(), and indentLevel().