A keyword and a list of tokens is an 'entry'. More...

Inheritance diagram for entry:

Collaboration diagram for entry:

Public Types
enum class	inputMode { MERGE , OVERWRITE , PROTECT , WARN , ERROR , GLOBAL }
	The input mode options. More...

Public Member Functions
	entry (const keyType &keyword)
	Construct from keyword. More...

	entry (const entry &e)
	Construct as copy. More...

virtual autoPtr< entry >	clone (const dictionary &parentDict) const =0
	Construct on freestore as copy with reference to the. More...

virtual autoPtr< entry >	clone () const
	Construct on freestore as copy. More...

virtual	~entry ()=default
	Destructor. More...

const keyType &	keyword () const noexcept
	Return keyword. More...

keyType &	keyword () noexcept
	Return non-const access to keyword. More...

virtual const fileName &	name () const =0
	Return the entry name. More...

virtual fileName &	name ()=0
	Return the entry name for modification. More...

virtual fileName	relativeName () const =0
	Return the entry name relative to the current case. More...

virtual label	startLineNumber () const =0
	Return line number of first token in dictionary. More...

virtual label	endLineNumber () const =0
	Return line number of last token in dictionary. More...

virtual bool	isStream () const noexcept
	Return true if this entry is a stream. More...

virtual ITstream &	stream () const =0
	Return token stream, if entry is a primitive entry. More...

virtual bool	isDict () const noexcept
	Return true if this entry is a dictionary. More...

virtual const dictionary *	dictPtr () const noexcept
	Return pointer to dictionary, if entry is a dictionary. More...

virtual dictionary *	dictPtr () noexcept
	Return non-const pointer to dictionary, if entry is a dictionary. More...

virtual const dictionary &	dict () const =0
	Return dictionary, if entry is a dictionary. More...

virtual dictionary &	dict ()=0
	Return non-const access to dictionary, if entry is a dictionary. More...

void	checkITstream (const ITstream &is) const

template<class T >
T	get () const

template<class T >
void	readEntry (T &val) const

template<class T , class Predicate >
T	getCheck (const Predicate &pred) const

template<class T , class Predicate >
void	readCheck (T &val, const Predicate &pred) const

virtual void	write (Ostream &os) const =0
	Write. More...

void	operator= (const entry &e)

bool	operator== (const entry &e) const

bool	operator!= (const entry &e) const

Public Member Functions inherited from LList< LListBase, T >::link
	link (const T &elem)
	Copy construct from given object. More...

	link (T &&elem)
	Move construct from given object. More...

Static Public Member Functions
static bool	New (dictionary &parentDict, Istream &is, const inputMode inpMode=inputMode::GLOBAL, const int endChar=0)
	Construct from an Istream and insert into the dictionary. More...

static autoPtr< entry >	New (Istream &is)
	Construct an entry from Istream. More...

static void	resetInputMode ()
	Reset the globalInputMode to merge. More...

Static Public Member Functions inherited from LList< LListBase, T >::link
static T	remove (typename LListBase::link *node)
	Delete linked item and return the element value. More...

static constexpr T *	ptr (typename LListBase::link *node)
	Dereference LListBase::link to obtain address of stored object. More...

static constexpr const T *	ptr (const typename LListBase::link *node)
	Dereference LListBase::link to obtain address of stored object. More...

static constexpr T &	ref (typename LListBase::link *node)
	Dereference LListBase::link to obtain the stored object. More...

static constexpr const T &	ref (const typename LListBase::link *node)
	Dereference LListBase::link to obtain the stored object. More...

Static Public Attributes
static int	disableFunctionEntries
	Enable or disable use of function entries and variable expansions. More...

static inputMode	globalInputMode = inputMode::MERGE
	The current global input-mode. More...

Static Protected Member Functions
static void	reportReadWarning (const IOstream &, const std::string &)
	Report a read warning (on std::cerr) More...

Friends
Ostream &	operator<< (Ostream &os, const entry &e)

Additional Inherited Members
Public Attributes inherited from LList< LListBase, T >::link
T	val_
	Stored object. More...

Detailed Description

A keyword and a list of tokens is an 'entry'.

An entry can be read, written and printed, and the types and values of its tokens analysed. An entry is a high-level building block for data description. It is a front-end for the token parser. A list of entries can be used as a set of keyword syntax elements, for example.

Source files

Definition at line 67 of file entry.H.

Member Enumeration Documentation

◆ inputMode

enum class inputMode

strong

The input mode options.

Enumerator
MERGE	Merge sub-dictionaries when possible.
OVERWRITE	Keep last entry. Silently remove previous ones.
PROTECT	Keep initial entry. Silently ignore subsequent ones.
WARN	Keep initial entry. Warn about subsequent ones.
ERROR	FatalError for duplicate entries.
GLOBAL	Use global value from globalInputMode variable.

Definition at line 76 of file entry.H.

Constructor & Destructor Documentation

◆ entry() [1/2]

entry ( const keyType & keyword )

Construct from keyword.

Definition at line 69 of file entry.C.

◆ entry() [2/2]

entry ( const entry & e )

Construct as copy.

Definition at line 76 of file entry.C.

◆ ~entry()

virtual ~entry ( )

virtualdefault

Destructor.

Member Function Documentation

◆ reportReadWarning()

void reportReadWarning	(	const IOstream &	is,
		const std::string &	msg
	)

staticprotected

Report a read warning (on std::cerr)

Definition at line 47 of file entry.C.

References IOstream::lineNumber(), and IOstream::relativeName().

Here is the call graph for this function:

◆ clone() [1/2]

virtual autoPtr< entry > clone ( const dictionary & parentDict ) const

pure virtual

Construct on freestore as copy with reference to the.

dictionary the copy belongs to

Implemented in primitiveEntry, dictionaryEntry, and dictionaryListEntry.

◆ clone() [2/2]

Foam::autoPtr< Foam::entry > clone ( ) const

virtual

Construct on freestore as copy.

Note: the parent directory is set to dictionary::null

Definition at line 83 of file entry.C.

◆ New() [1/2]

bool New	(	dictionary &	parentDict,
		Istream &	is,
		const inputMode	inpMode = `inputMode::GLOBAL`,
		const int	endChar = `0`
	)

static

Construct from an Istream and insert into the dictionary.

Parameters

parentDict	dictionary to insert into
is	the input stream
inpMode	the input mode. The default is to use the currently active globalInputMode
endChar	the expected end character (eg, a closing brace). The endChar is 0 if no expectations are asserted.

Definition at line 104 of file entryIO.C.

References dictionary::add(), token::BEGIN_BLOCK, token::BEGIN_LIST, fileName::clean(), dictionary::csearchScoped(), entry::disableFunctionEntries, token::DOLLAR, token::END_BLOCK, token::END_LIST, IOstream::eof(), ObukhovLength::execute(), Foam::exit(), IOstream::fatalCheck(), Foam::FatalIOError, FatalIOErrorInFunction, FUNCTION_NAME, token::HASH, token::info(), Foam::stringOps::inplaceExpand(), token::isLabel(), token::isPunctuation(), keyType::LITERAL, dictionary::makeScopedDict(), Foam::mode(), fileName::name(), formatter::npos, fileName::path(), Istream::putBack(), keyType::REGEX, keyType::REGEX_RECURSIVE, dictionary::search(), dictionary::searchScoped(), dictionary::substituteScopedKeyword(), and kkLOmega::validate().

Here is the call graph for this function:

◆ New() [2/2]

Foam::autoPtr< Foam::entry > New ( Istream & is )

static

Construct an entry from Istream.

The expected input comprises a keyword followed by a dictionaryEntry or a primitiveEntry.

The dictionaryEntry starts with a '{' left brace and ends with a '}' right brace.

The primitiveEntry ends with a ';' semi-colon.

Example input

   key1 { ... }   // dictionary input
   key2 ... ;     // primitive input

Returns: The entry read, or nullptr on error.

Definition at line 463 of file entryIO.C.

References token::BEGIN_BLOCK, IOstream::fatalCheck(), FUNCTION_NAME, Istream::putBack(), and autoPtr< T >::reset().

Here is the call graph for this function:

◆ resetInputMode()

void resetInputMode ( )

static

Reset the globalInputMode to merge.

Definition at line 61 of file entry.C.

Referenced by dictionary::dictionary(), inputMode::execute(), and Foam::operator>>().

Here is the caller graph for this function:

◆ keyword() [1/2]

const keyType & keyword ( ) const

inlinenoexcept

Return keyword.

Definition at line 195 of file entry.H.

Referenced by dictionary::add(), cellModel::cellModel(), GeometricBoundaryField< symmTensor, fvPatchField, volMesh >::GeometricBoundaryField(), solutionControl::maxResidual(), solutionControl::maxTypeResidual(), Function1< Type >::New(), PatchFunction1< Type >::New(), phase::iNew::operator()(), phaseModel::iNew::operator()(), sizeGroup::iNew::operator()(), Foam::functionObjects::operator>>(), Foam::operator>>(), genericPatchFieldBase::processEntry(), refinementSurfaces::refinementSurfaces(), dictionary::set(), shellSurfaces::shellSurfaces(), and Foam::blockMeshTools::write().

Here is the caller graph for this function:

◆ keyword() [2/2]

keyType & keyword ( )

inlinenoexcept

Return non-const access to keyword.

Definition at line 201 of file entry.H.

◆ name() [1/2]

virtual const fileName & name ( ) const

pure virtual

Return the entry name.

Implemented in dictionaryEntry, and primitiveEntry.

Referenced by dictionary::add().

Here is the caller graph for this function:

◆ name() [2/2]

virtual fileName & name ( )

pure virtual

Return the entry name for modification.

Implemented in dictionaryEntry, and primitiveEntry.

◆ relativeName()

virtual fileName relativeName ( ) const

pure virtual

Return the entry name relative to the current case.

Implemented in dictionaryEntry, and primitiveEntry.

◆ startLineNumber()

virtual label startLineNumber ( ) const

pure virtual

Return line number of first token in dictionary.

Implemented in dictionaryEntry, and primitiveEntry.

Referenced by dynamicCodeContext::readEntry().

Here is the caller graph for this function:

◆ endLineNumber()

virtual label endLineNumber ( ) const

pure virtual

Return line number of last token in dictionary.

Implemented in dictionaryEntry, and primitiveEntry.

◆ isStream()

virtual bool isStream ( ) const

inlinevirtualnoexcept

Return true if this entry is a stream.

Reimplemented in primitiveEntry.

Definition at line 223 of file entry.H.

Referenced by Constant< Type >::Constant(), Polynomial< Type >::Polynomial(), genericPatchFieldBase::processEntry(), and Table< Type >::Table().

Here is the caller graph for this function:

◆ stream()

virtual ITstream & stream ( ) const

pure virtual

Return token stream, if entry is a primitive entry.

Implemented in dictionaryEntry, and primitiveEntry.

Referenced by Constant< Type >::Constant(), exprResultDelayed::exprResultDelayed(), Foam::exprTools::getList(), expressionEntry::inplaceExpand(), solutionControl::maxTypeResidual(), fvGeometryScheme::New(), Polynomial< Type >::Polynomial(), genericPatchFieldBase::processEntry(), Foam::blockMeshTools::read(), entry::readCheck(), fvExprDriver::readDict(), entry::readEntry(), Foam::readScaling(), shellSurfaces::shellSurfaces(), Table< Type >::Table(), solution::upgradeSolverDict(), and Foam::writeEntryIfPresent().

Here is the caller graph for this function:

◆ isDict()

virtual bool isDict ( ) const

inlinevirtualnoexcept

Return true if this entry is a dictionary.

Definition at line 233 of file entry.H.

References entry::dictPtr().

Referenced by dictionary::add(), dictionary::cfindScopedDict(), Foam::entryToString(), GAMGSolver::GAMGSolver(), GeometricBoundaryField< symmTensor, fvPatchField, volMesh >::GeometricBoundaryField(), Foam::getVariableOrDie(), dictionary::makeScopedDict(), functionObjectList::read(), Foam::debug::switchSet(), solution::upgradeSolverDict(), and Foam::writeEntryIfPresent().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ dictPtr() [1/2]

virtual const dictionary * dictPtr ( ) const

inlinevirtualnoexcept

Return pointer to dictionary, if entry is a dictionary.

Return nullptr if the entry is not a dictionary.

Reimplemented in dictionaryEntry.

Definition at line 240 of file entry.H.

Referenced by dictionary::cfindScopedDict(), entry::isDict(), and dictionary::makeScopedDict().

Here is the caller graph for this function:

◆ dictPtr() [2/2]

virtual dictionary * dictPtr ( )

inlinevirtualnoexcept

Return non-const pointer to dictionary, if entry is a dictionary.

Return nullptr if the entry is not a dictionary.

Reimplemented in dictionaryEntry.

Definition at line 247 of file entry.H.

◆ dict() [1/2]

virtual const dictionary & dict ( ) const

pure virtual

Return dictionary, if entry is a dictionary.

Implemented in primitiveEntry, and dictionaryEntry.

Referenced by dictionary::add(), Foam::entryToString(), GAMGSolver::GAMGSolver(), functionObjectList::read(), sampledSurfaces::read(), refinementSurfaces::refinementSurfaces(), shellSurfaces::shellSurfaces(), Foam::debug::switchSet(), and Foam::writeEntryIfPresent().

Here is the caller graph for this function:

◆ dict() [2/2]

virtual dictionary & dict ( )

pure virtual

Return non-const access to dictionary, if entry is a dictionary.

Implemented in primitiveEntry, and dictionaryEntry.

◆ checkITstream()

void checkITstream ( const ITstream & is ) const

Check after reading if the input token stream has unconsumed tokens remaining or if there were no tokens in the first place.

Emits FatalIOError

Definition at line 110 of file entry.C.

References JobInfo::constructed, Foam::exit(), Foam::FatalIOError, IOstream::lineNumber(), Foam::nl, ITstream::nRemainingTokens(), UList< T >::size(), and UList< T >::writeList().

Referenced by entry::readCheck(), entry::readEntry(), and Foam::readScaling().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ get()

T get ( ) const

inline

Get a T from the stream, FatalIOError if the number of tokens is incorrect.

Definition at line 269 of file entry.H.

References T.

Referenced by Foam::getOrAdd(), Enum< injectionMethod >::getOrDefault(), and Enum< injectionMethod >::read().

Here is the caller graph for this function:

◆ readEntry()

void readEntry ( T & val ) const

inline

Assign to T val, FatalIOError if the number of tokens is incorrect.

Parameters

val	the value to read into

Definition at line 281 of file entry.H.

References entry::checkITstream(), and entry::stream().

Referenced by dynamicCodeContext::readEntry().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getCheck()

T getCheck ( const Predicate & pred ) const

inline

Get a T from the stream, FatalIOError if the number of tokens is incorrect.

Parameters

pred	the value check predicate

Definition at line 294 of file entry.H.

References T.

◆ readCheck()

void readCheck	(	T &	val,
		const Predicate &	pred
	)		const

inline

Assign to T val, FatalIOError if the number of tokens is incorrect.

Parameters

val	the value to read into
pred	the value check predicate

Definition at line 307 of file entry.H.

References entry::checkITstream(), and entry::stream().

Here is the call graph for this function:

◆ write()

virtual void write ( Ostream & os ) const

pure virtual

Write.

Implemented in dictionaryEntry, dictionaryListEntry, functionEntry, and primitiveEntry.

◆ operator=()

void operator= ( const entry & e )

Definition at line 194 of file entry.C.

References e.

◆ operator==()

bool operator== ( const entry & e ) const

Definition at line 205 of file entry.C.

References e, and StringStreamAllocator< StreamType >::str().

Here is the call graph for this function:

◆ operator!=()

bool operator!= ( const entry & e ) const

Definition at line 228 of file entry.C.

References e, and Foam::operator==().

Here is the call graph for this function:

Friends And Related Function Documentation

◆ operator<<

Ostream & operator<<	(	Ostream &	os,
		const entry &	e
	)

friend

Member Data Documentation

◆ disableFunctionEntries

int disableFunctionEntries

static

Enable or disable use of function entries and variable expansions.

Definition at line 127 of file entry.H.

Referenced by entry::New().

◆ globalInputMode

Foam::entry::inputMode globalInputMode = inputMode::MERGE

static

The current global input-mode.

Definition at line 130 of file entry.H.

Referenced by inputMode::execute().

The documentation for this class was generated from the following files:

src/OpenFOAM/db/dictionary/entry/entry.H
src/OpenFOAM/db/dictionary/entry/entry.C
src/OpenFOAM/db/dictionary/entry/entryIO.C

Public Types

Public Member Functions

Static Public Member Functions

Static Public Attributes

Static Protected Member Functions

Friends

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ inputMode

Constructor & Destructor Documentation

◆ entry() [1/2]

◆ entry() [2/2]

◆ ~entry()

Member Function Documentation

◆ reportReadWarning()

◆ clone() [1/2]

◆ clone() [2/2]

◆ New() [1/2]

◆ New() [2/2]

◆ resetInputMode()

◆ keyword() [1/2]

◆ keyword() [2/2]

◆ name() [1/2]

◆ name() [2/2]

◆ relativeName()

◆ startLineNumber()

◆ endLineNumber()

◆ isStream()

◆ stream()

◆ isDict()

◆ dictPtr() [1/2]

◆ dictPtr() [2/2]

◆ dict() [1/2]

◆ dict() [2/2]

◆ checkITstream()

◆ get()

◆ readEntry()

◆ getCheck()

◆ readCheck()

◆ write()

◆ operator=()

◆ operator==()

◆ operator!=()

Friends And Related Function Documentation

◆ operator<<

Member Data Documentation

◆ disableFunctionEntries

◆ globalInputMode