dictionary Class Reference

A list of keywords followed by any number of values (e.g. words and numbers) or sub-dictionaries. More...

Inheritance diagram for dictionary:

Collaboration diagram for dictionary:

Classes
class	includedDictionary

Public Member Functions
	ClassName ("dictionary")
	dictionary ()
	Construct top-level dictionary null. More...
	dictionary (const fileName &name)
	Construct top-level empty dictionary with given name. More...
	dictionary (const fileName &name, const dictionary &parentDict)
	Construct an empty sub-dictionary with given name and parent. More...
	dictionary (const fileName &name, const dictionary &parentDict, Istream &)
	Construct given the name, parent dictionary and Istream,. More...
	dictionary (Istream &, const bool keepHeader=false)
	Construct top-level dictionary from Istream,. More...
	dictionary (const dictionary &parentDict, const dictionary &)
	Construct as copy given the parent dictionary. More...
	dictionary (const dictionary &)
	Construct top-level dictionary as copy. More...
	dictionary (const dictionary *)
	Construct top-level dictionary as copy from pointer to dictionary. More...
template<class ... Entries>
	dictionary (const std::tuple< const Entries &... > &)
	Construct top-level dictionary with given entries. More...
template<class ... Entries>
	dictionary (const fileName &name, const std::tuple< const Entries &... > &)
	Construct top-level dictionary with given name and entries. More...
template<class ... Entries>
	dictionary (const fileName &name, const dictionary &parentDict, const std::tuple< const Entries &... > &)
	Construct dictionary with given name, parent and entries. More...
template<class ... Entries>
	dictionary (const dictionary &dict, const std::tuple< const Entries &... > &)
	Construct dictionary as copy and add a list of entries. More...
autoPtr< dictionary >	clone () const
	Construct and return clone. More...
virtual	~dictionary ()
	Destructor. More...
const dictionary &	parent () const
	Return the parent dictionary. More...
bool	isNull () const
	Return whether this dictionary is null. More...
const dictionary &	topDict () const
	Return the top of the tree. More...
word	topDictKeyword () const
	Return the scoped keyword with which this dictionary can be. More...
virtual label	startLineNumber () const
	Return line number of first token in dictionary. More...
virtual label	endLineNumber () const
	Return line number of last token in dictionary. More...
SHA1Digest	digest () const
	Return the SHA1 digest of the dictionary contents. More...
tokenList	tokens () const
	Return the dictionary as a list of tokens. More...
bool	found (const word &, bool recursive=false, bool patternMatch=true) const
	Search dictionary for given keyword. More...
const entry *	lookupEntryPtr (const word &, bool recursive, bool patternMatch) const
	Find and return an entry data stream pointer if present. More...
entry *	lookupEntryPtr (const word &, bool recursive, bool patternMatch)
	Find and return an entry data stream pointer for manipulation. More...
const entry *	lookupEntryPtrBackwardsCompatible (const wordList &, bool recursive, bool patternMatch) const
	Find and return an entry data stream if present, trying a list. More...
const entry &	lookupEntry (const word &, bool recursive, bool patternMatch) const
	Find and return an entry data stream if present otherwise error. More...
const entry &	lookupEntryBackwardsCompatible (const wordList &, bool recursive, bool patternMatch) const
	Find and return an entry data stream if present, trying a list. More...
ITstream &	lookup (const word &, bool recursive=false, bool patternMatch=true) const
	Find and return an entry data stream. More...
ITstream &	lookupBackwardsCompatible (const wordList &, bool recursive=false, bool patternMatch=true) const
	Find and return an entry data stream, trying a list of keywords. More...
template<class T >
T	lookup (const word &, bool recursive=false, bool patternMatch=true) const
	Find and return a T, if not found throw a fatal error. More...
template<class T >
T	lookup (const word &, const unitConversion &, bool recursive=false, bool patternMatch=true) const
	Find and return a T, with dimension checking and unit. More...
template<class T >
T	lookupBackwardsCompatible (const wordList &, bool recursive=false, bool patternMatch=true) const
	Find and return a T, trying a list of keywords in sequence,. More...
template<class T >
T	lookupBackwardsCompatible (const wordList &, const unitConversion &, bool recursive=false, bool patternMatch=true) const
	Find and return a T, with dimension checking and unit. More...
template<class T >
T	lookupOrDefault (const word &, const T &, const bool writeDefault=writeOptionalEntries > 0) const
	Find and return a T, if not found return the given default. More...
template<class T >
T	lookupOrDefault (const word &, const unitConversion &, const T &, const bool writeDefault=writeOptionalEntries > 0) const
	Find and return a T with dimension checking and unit. More...
template<class T >
T	lookupOrDefaultBackwardsCompatible (const wordList &, const T &) const
	Find and return a T, trying a list of keywords in sequence,. More...
template<class T >
T	lookupOrDefaultBackwardsCompatible (const wordList &, const unitConversion &, const T &) const
	Find and return a T, with dimension checking and unit. More...
template<class T >
T	lookupOrAddDefault (const word &, const T &)
	Find and return a T, if not found return the given. More...
template<class T >
bool	readIfPresent (const word &, T &, bool recursive=false, bool patternMatch=true) const
	Find an entry if present, and assign to T. More...
template<class T >
bool	readIfPresent (const word &, const unitConversion &, T &, bool recursive=false, bool patternMatch=true) const
	Find an entry if present, and assign to T, with dimension. More...
const entry *	lookupScopedEntryPtr (const word &, bool recursive, bool patternMatch) const
	Find and return an entry data stream pointer if present,. More...
template<class T >
T	lookupScoped (const word &, bool recursive=false, bool patternMatch=true) const
	Find and return a T,. More...
template<class T >
const T &	lookupCompoundScoped (const word &keyword, bool recursive, bool patternMatch) const
	Find return the reference to the compound T,. More...
bool	isDict (const word &) const
	Check if entry is a sub-dictionary. More...
const dictionary *	subDictPtr (const word &) const
	Find and return a sub-dictionary pointer if present. More...
dictionary *	subDictPtr (const word &)
	Find and return a sub-dictionary pointer if present. More...
const dictionary &	subDict (const word &) const
	Find and return a sub-dictionary. More...
dictionary &	subDict (const word &)
	Find and return a sub-dictionary for manipulation. More...
const dictionary &	subDictBackwardsCompatible (const wordList &) const
	Find and return a sub-dictionary, trying a list of keywords in. More...
const dictionary &	subOrEmptyDict (const word &, const bool mustRead=false) const
	Find and return a sub-dictionary. More...
const dictionary &	optionalSubDict (const word &) const
	Find and return a sub-dictionary if found. More...
const dictionary &	scopedDict (const word &) const
	Find and return a sub-dictionary by scoped lookup. More...
dictionary &	scopedDict (const word &)
	Find and return a sub-dictionary by scoped lookup. More...
wordList	toc () const
	Return the table of contents. More...
wordList	sortedToc () const
	Return the sorted table of contents. More...
List< keyType >	keys (bool patterns=false) const
	Return the list of available keys or patterns. More...
bool	substituteKeyword (const word &keyword)
	Substitute the given keyword prepended by '$' with the. More...
bool	add (entry *, bool mergeEntry=false)
	Add a new entry. More...
void	add (const entry &, bool mergeEntry=false)
	Add an entry. More...
void	add (const keyType &, const word &, bool overwrite=false)
	Add a word entry. More...
void	add (const keyType &, const string &, bool overwrite=false)
	Add a string entry. More...
void	add (const keyType &, const label, bool overwrite=false)
	Add a label entry. More...
void	add (const keyType &, const scalar, bool overwrite=false)
	Add a scalar entry. More...
void	add (const keyType &, const dictionary &, bool mergeEntry=false)
	Add a dictionary entry. More...
template<class T >
void	add (const keyType &, const T &, bool overwrite=false)
	Add a T entry. More...
void	set (entry *)
	Assign a new entry, overwrite any existing entry. More...
void	set (const entry &)
	Assign a new entry, overwrite any existing entry. More...
void	set (const keyType &, const dictionary &)
	Assign a dictionary entry, overwrite any existing entry. More...
template<class T >
void	set (const keyType &, const T &)
	Assign a T entry, overwrite any existing entry. More...
template<class ... Entries>
void	set (const entry &e, const Entries &...)
	Assign multiple entries, overwriting any existing entries. More...
template<class T , class ... Entries>
void	set (const keyType &, const T &, const Entries &...)
	Assign multiple T entries, overwriting any existing entries. More...
bool	remove (const word &)
	Remove an entry specified by keyword. More...
void	remove (const wordList &)
	Remove entries specified by keywords. More...
bool	changeKeyword (const keyType &oldKeyword, const keyType &newKeyword, bool forceOverwrite=false)
	Change the keyword for an entry,. More...
bool	merge (const dictionary &)
	Merge entries from the given dictionary. More...
void	clear ()
	Clear the dictionary. More...
void	transfer (dictionary &)
	Transfer the contents of the argument and annul the argument. More...
bool	read (Istream &, const bool keepHeader=false)
	Read dictionary from Istream, optionally keeping the header. More...
virtual bool	global () const
	Return true if the dictionary global,. More...
void	write (Ostream &, const bool subDict=true) const
	Write dictionary, normally with sub-dictionary formatting. More...
ITstream &	operator[] (const word &) const
	Find and return entry. More...
void	operator= (const dictionary &)
void	operator+= (const dictionary &)
	Include entries from the given dictionary. More...
void	operator|= (const dictionary &)
	Conditionally include entries from the given dictionary. More...
void	operator<<= (const dictionary &)
	Unconditionally include entries from the given dictionary. More...
template<class ... Entries>
std::tuple< const Entries &... >	entries (const Entries &... entries)
template<class T >
T	lookupOrDefault (const word &keyword, const T &defaultValue, const bool writeDefault) const
template<class T >
T	lookupOrDefault (const word &keyword, const unitConversion &defaultUnits, const T &defaultValue, const bool writeDefault) const
template<class ... Entries>
void	set (const entry &e, const Entries &... entries)
template<class T , class ... Entries>
void	set (const keyType &k, const T &t, const Entries &... entries)
Public Member Functions inherited from dictionaryName
	dictionaryName ()
	Construct dictionaryName null. More...
	dictionaryName (const fileName &name)
	Construct dictionaryName as copy of the given fileName. More...
	dictionaryName (dictionaryName &&name)
	Move constructor. More...
const fileName &	name () const
	Return the dictionary name. More...
fileName &	name ()
	Return the dictionary name. More...
const word	dictName () const
	Return the local dictionary name (final part of scoped name) More...
void	operator= (const dictionaryName &name)
void	operator= (dictionaryName &&name)
Public Member Functions inherited from ILList< LListBase, T >
	ILList ()
	Null construct. More...
	ILList (T *a)
	Construct given initial T. More...
	ILList (Istream &)
	Construct from Istream. More...
	ILList (const ILList< LListBase, T > &)
	Copy constructor. More...
	ILList (ILList< LListBase, T > &&)
	Move constructor. More...
template<class CloneArg >
	ILList (const ILList< LListBase, T > &lst, const CloneArg &cloneArg)
	Copy constructor with additional argument for clone. More...
template<class INew >
	ILList (Istream &, const INew &)
	Construct from Istream using given Istream constructor class. More...
	~ILList ()
	Destructor. More...
bool	eraseHead ()
	Remove the head element specified from the list and delete it. More...
bool	erase (T *p)
	Remove the specified element from the list and delete it. More...
void	clear ()
	Clear the contents of the list. More...
void	transfer (ILList< LListBase, T > &)
	Transfer the contents of the argument into this List. More...
void	operator= (const ILList< LListBase, T > &)
	Assignment operator. More...
void	operator= (ILList< LListBase, T > &&)
	Move assignment operator. More...
Public Member Functions inherited from UILList< LListBase, T >
	UILList ()
	Null construct. More...
	UILList (T *a)
	Construct given initial T. More...
	UILList (const UILList< LListBase, T > &)
	Copy constructor. More...
	UILList (UILList< LListBase, T > &&)
	Move constructor. More...
T *	first ()
	Return the first entry. More...
const T *	first () const
	Return the first entry. More...
T *	last ()
	Return the last entry. More...
const T *	last () const
	Return the last entry. More...
T *	removeHead ()
	Remove and return head. More...
T *	remove (T *p)
	Remove and return element. More...
T *	remove (iterator &it)
	Remove and return specified by iterator. More...
void	operator= (const UILList< LListBase, T > &)
	Assignment operator. More...
void	operator= (UILList< LListBase, T > &&)
	Move assignment operator. More...
iterator	begin ()
const iterator &	end ()
const_iterator	cbegin () const
const const_iterator &	cend () const
const_iterator	begin () const
const const_iterator &	end () const
const_reverse_iterator	crbegin () const
const const_reverse_iterator &	crend () const
const_reverse_iterator	rbegin () const
const const_reverse_iterator &	rend () const
bool	operator== (const UILList< LListBase, T > &) const
	Equality operation on ULists of the same type. More...
bool	operator!= (const UILList< LListBase, T > &) const
	The opposite of the equality operation. Takes linear time. More...

Static Public Member Functions
template<class ... Entries>
static std::tuple< const Entries &... >	entries (const Entries &...)
	Construct an entries tuple from which to make a dictionary. More...
static autoPtr< dictionary >	New (Istream &)
	Construct top-level dictionary on freestore from Istream. More...

Static Public Attributes
static const dictionary	null
	Null dictionary. More...
static int	writeOptionalEntries
	If true write optional keywords and values. More...

Friends
class	entry
	Declare friendship with the entry class for IO. More...
Istream &	operator>> (Istream &, dictionary &)
	Read dictionary from Istream. More...
Ostream &	operator<< (Ostream &, const dictionary &)
	Write dictionary to Ostream. More...

Additional Inherited Members
Public Types inherited from UILList< LListBase, T >
typedef T	value_type
	Type of values the DLList contains. More...
typedef T &	reference
	Type that can be used for storing into DLList::value_type. More...
typedef const T &	const_reference
	Type that can be used for storing into constant. More...
typedef label	size_type
	The type that can represent the size of a DLList. More...
typedef LListBase::iterator	LListBase_iterator
typedef LListBase::const_iterator	LListBase_const_iterator

Detailed Description

A list of keywords followed by any number of values (e.g. words and numbers) or sub-dictionaries.

The keywords can represent patterns which are matched using Posix regular expressions. The general order for searching is as follows:

• exact match
• pattern match (in reverse order)
• optional recursion into the enclosing (parent) dictionaries

The dictionary class is the base class for IOdictionary. It also serves as a bootstrap dictionary for the objectRegistry data dictionaries since, unlike the IOdictionary class, it does not use an objectRegistry itself to work.

Source files

• dictionary.H
• dictionary.C
• dictionaryIO.C
• dictionaryTemplates.C

Definition at line 158 of file dictionary.H.

Constructor & Destructor Documentation

dictionary() [1/12]

dictionary

(

)

Construct top-level dictionary null.

Definition at line 327 of file dictionary.C.

Referenced by dictionary::New(), and Foam::readConfigFile().

Here is the caller graph for this function:

dictionary() [2/12]

dictionary

(

const fileName &

name

)

Construct top-level empty dictionary with given name.

Definition at line 334 of file dictionary.C.

dictionary() [3/12]

dictionary	(	const fileName &	name,
		const dictionary &	parentDict
	)

Construct an empty sub-dictionary with given name and parent.

Definition at line 342 of file dictionary.C.

dictionary() [4/12]

dictionary	(	const fileName &	name,
		const dictionary &	parentDict,
		Istream &	is
	)

Construct given the name, parent dictionary and Istream,.

reading entries until lastEntry or EOF

Definition at line 38 of file dictionaryIO.C.

References dictionary::read().

Here is the call graph for this function:

dictionary() [5/12]

dictionary	(	Istream &	is,
		const bool	keepHeader = false
	)

Construct top-level dictionary from Istream,.

reading entries until EOF, optionally keeping the header

Definition at line 58 of file dictionaryIO.C.

References calcIncludeEntry::clear(), inputModeEntry::clear(), and dictionary::read().

Here is the call graph for this function:

dictionary() [6/12]

dictionary	(	const dictionary &	parentDict,
		const dictionary &	dict
	)

Construct as copy given the parent dictionary.

Definition at line 359 of file dictionary.C.

References forAllIter.

dictionary() [7/12]

dictionary

(

const dictionary &

dict

)

Construct top-level dictionary as copy.

Definition at line 386 of file dictionary.C.

References forAllIter.

dictionary() [8/12]

dictionary

(

const dictionary *

dictPtr

)

Construct top-level dictionary as copy from pointer to dictionary.

A null pointer is treated like an empty dictionary.

Definition at line 409 of file dictionary.C.

References dictionary::operator=().

Here is the call graph for this function:

dictionary() [9/12]

dictionary

(

const std::tuple< const Entries &... > &

entries

)

Construct top-level dictionary with given entries.

Definition at line 88 of file dictionaryTemplates.C.

References dictionary::entries().

Here is the call graph for this function:

dictionary() [10/12]

dictionary	(	const fileName &	name,
		const std::tuple< const Entries &... > &	entries
	)

Construct top-level dictionary with given name and entries.

Definition at line 97 of file dictionaryTemplates.C.

References dictionary::entries().

Here is the call graph for this function:

dictionary() [11/12]

dictionary	(	const fileName &	name,
		const dictionary &	parentDict,
		const std::tuple< const Entries &... > &	entries
	)

Construct dictionary with given name, parent and entries.

Definition at line 110 of file dictionaryTemplates.C.

References dictionary::entries().

Here is the call graph for this function:

dictionary() [12/12]

dictionary	(	const dictionary &	dict,
		const std::tuple< const Entries &... > &	entries
	)

Construct dictionary as copy and add a list of entries.

Definition at line 124 of file dictionaryTemplates.C.

References dictionary::entries().

Here is the call graph for this function:

~dictionary()

~dictionary ( )

virtual

Destructor.

Definition at line 429 of file dictionary.C.

Member Function Documentation

ClassName()

ClassName

(

"dictionary"

)

entries() [1/2]

static std::tuple<const Entries& ...> entries ( const Entries &  ... )

static

Construct an entries tuple from which to make a dictionary.

Referenced by dictionary::dictionary(), dictionary::entries(), zoneGenerator::New(), zoneGeneratorList::read(), rigidBodyMeshMotion::solve(), rigidBodyMeshMotionSolver::solve(), sixDoFRigidBodyMotionSolver::solve(), and zoneGeneratorList::zoneGeneratorList().

Here is the caller graph for this function:

clone()

Foam::autoPtr< Foam::dictionary > clone

(

)

const

Construct and return clone.

Definition at line 421 of file dictionary.C.

Referenced by Foam::preservePatchTypes(), and refinementSurfaces::refinementSurfaces().

Here is the caller graph for this function:

New()

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

static

Construct top-level dictionary on freestore from Istream.

Definition at line 103 of file dictionaryIO.C.

References dictionary::dictionary().

Referenced by kineticTheoryModel::correct(), IATE::correct(), transport::correct(), kEpsilonLopesdaCosta< BasicMomentumTransportModel >::correct(), kOmegaSST< MomentumTransportModel, BasicMomentumTransportModel >::correct(), lambdaThixotropic< BasicMomentumTransportModel >::correct(), Maxwell< BasicMomentumTransportModel >::correct(), DeardorffDiffStress< BasicMomentumTransportModel >::correct(), dynamicKEqn< BasicMomentumTransportModel >::correct(), dynamicLagrangian< BasicMomentumTransportModel >::correct(), kEqn< BasicMomentumTransportModel >::correct(), SpalartAllmarasDES< BasicMomentumTransportModel >::correct(), kEpsilon< BasicMomentumTransportModel >::correct(), kOmega< BasicMomentumTransportModel >::correct(), kOmega2006< BasicMomentumTransportModel >::correct(), LaunderSharmaKE< BasicMomentumTransportModel >::correct(), LRR< BasicMomentumTransportModel >::correct(), realizableKE< BasicMomentumTransportModel >::correct(), RNGkEpsilon< BasicMomentumTransportModel >::correct(), SpalartAllmaras< BasicMomentumTransportModel >::correct(), SSG< BasicMomentumTransportModel >::correct(), v2f< BasicMomentumTransportModel >::correct(), mixtureKEpsilon< BasicMomentumTransportModel >::correct(), kEpsilonLopesdaCosta< BasicMomentumTransportModel >::correctNut(), DeardorffDiffStress< BasicMomentumTransportModel >::correctNut(), kEqn< BasicMomentumTransportModel >::correctNut(), Smagorinsky< BasicMomentumTransportModel >::correctNut(), WALE< BasicMomentumTransportModel >::correctNut(), kEpsilon< BasicMomentumTransportModel >::correctNut(), kOmega< BasicMomentumTransportModel >::correctNut(), LaunderSharmaKE< BasicMomentumTransportModel >::correctNut(), LRR< BasicMomentumTransportModel >::correctNut(), RNGkEpsilon< BasicMomentumTransportModel >::correctNut(), SSG< BasicMomentumTransportModel >::correctNut(), v2f< BasicMomentumTransportModel >::correctNut(), NicenoKEqn< BasicMomentumTransportModel >::correctNut(), SmagorinskyZhang< BasicMomentumTransportModel >::correctNut(), continuousGasKEpsilon< BasicMomentumTransportModel >::correctNut(), LaheyKEpsilon< BasicMomentumTransportModel >::correctNut(), mixtureKEpsilon< BasicMomentumTransportModel >::correctNut(), dynamicLagrangian< BasicMomentumTransportModel >::correctNut(), SpalartAllmarasDES< BasicMomentumTransportModel >::correctNut(), SpalartAllmaras< BasicMomentumTransportModel >::correctNut(), kOmegaSST< MomentumTransportModel, BasicMomentumTransportModel >::correctNut(), kOmegaSSTSato< BasicMomentumTransportModel >::correctNut(), dynamicKEqn< BasicMomentumTransportModel >::correctNut(), realizableKE< BasicMomentumTransportModel >::correctNut(), kOmegaSSTLM< BasicMomentumTransportModel >::correctReThetatGammaInt(), age::execute(), phaseScalarTransport::execute(), scalarTransport::execute(), VoFFilmTransfer::filmVoFTransferRate(), solver::fvConstraints(), phaseSystem::fvConstraints(), solver::fvModels(), phaseSystem::fvModels(), heatTransferSystem::Hs(), cloud::LagrangianModels(), adjustTimeStepToNucleation::maxDeltaT(), fvMesh::postConstruct(), propellerDiskForce::restrain(), kEpsilonLopesdaCosta< BasicMomentumTransportModel >::setPorosityCoefficients(), and filmVoFTransfer::VoFToFilmTransferRate().

Here is the call graph for this function:

Here is the caller graph for this function:

parent()

const dictionary& parent ( ) const

inline

Return the parent dictionary.

Definition at line 364 of file dictionary.H.

Referenced by dictionary::write().

Here is the caller graph for this function:

isNull()

bool isNull ( ) const

inline

Return whether this dictionary is null.

Definition at line 370 of file dictionary.H.

Referenced by ParticleForce< CloudType >::ParticleForce().

Here is the caller graph for this function:

topDict()

const Foam::dictionary & topDict

(

)

const

Return the top of the tree.

Definition at line 437 of file dictionary.C.

References IOobject::name(), and p.

Here is the call graph for this function:

topDictKeyword()

Foam::word topDictKeyword

(

)

const

Return the scoped keyword with which this dictionary can be.

accessed from the top dictionary in the tree

Definition at line 452 of file dictionary.C.

References IOobject::name(), word::null, and p.

Here is the call graph for this function:

startLineNumber()

Foam::label startLineNumber ( ) const

virtual

Return line number of first token in dictionary.

Reimplemented in dictionaryEntry.

Definition at line 472 of file dictionary.C.

References Foam::first().

Referenced by codedBase::updateLibrary().

Here is the call graph for this function:

Here is the caller graph for this function:

endLineNumber()

Foam::label endLineNumber ( ) const

virtual

Return line number of last token in dictionary.

Reimplemented in dictionaryEntry.

Definition at line 485 of file dictionary.C.

Referenced by zoneGenerator::New(), and messageStream::operator()().

Here is the caller graph for this function:

digest()

Foam::SHA1Digest digest

(

)

const

Return the SHA1 digest of the dictionary contents.

Definition at line 505 of file dictionary.C.

References OSHA1stream::digest(), and forAllConstIter.

Here is the call graph for this function:

tokens()

Foam::tokenList tokens

(

)

const

Return the dictionary as a list of tokens.

Definition at line 519 of file dictionary.C.

References DynamicList< T, SizeInc, SizeMult, SizeDiv >::append(), ISstream::read(), OStringStream::str(), and Foam::vtkWriteOps::write().

Here is the call graph for this function:

found()

bool found	(	const word &	keyword,
		bool	recursive = false,
		bool	patternMatch = true
	)		const

Search dictionary for given keyword.

If recursive, search parent dictionaries If patternMatch, use regular expressions

Definition at line 538 of file dictionary.C.

References dictionary::null.

Referenced by sixDoFRigidBodyMotion::addConstraints(), sixDoFRigidBodyMotion::addRestraints(), BlendedInterfacialModel< ModelType >::BlendedInterfacialModel(), Foam::blendingDict(), BreakupModel< CloudType >::BreakupModel(), constTransport< Thermo >::constTransport(), decompositionMethod::decompositionMethod(), directions::directions(), includeEntry::execute(), includeEtcEntry::execute(), fractal::fractal(), functionObjectList::functionObjectList(), functions::functions(), fvConstraints::fvConstraints(), fvModels::fvModels(), subModelBase::getBaseProperty(), subModelBase::getModelProperty(), heatTransferSystem::heatTransferSystem(), layerParameters::layerParameters(), Foam::listSwitches(), LocalInteraction< CloudType >::LocalInteraction(), basicThermo::lookupCstrIter(), NamedEnum< Enum, nEnum >::lookupOrDefault(), NamedEnum< vtkPolyhedra, 3 >::lookupOrDefault(), laminarModel< BasicMomentumTransportModel >::New(), liquidProperties::New(), solidProperties::New(), packingDispersionModel::New(), LagrangianPatchField< Type >::New(), setWriter::New(), fvMeshTopoChanger::New(), dlLibraryTable::open(), axesRotation::operator=(), parcelThermo::parcelThermo(), parMetis::parMetis(), polyBoundaryMesh::patchSet(), phaseSystem::phaseSystem(), populationBalanceSystem::populationBalanceSystem(), Foam::preservePatchTypes(), processorFvPatchField< Type >::processorFvPatchField(), multiphaseVoFSolver::read(), twoPhaseSolver::read(), tolerances::read(), MaxwellStefan< BasicThermophysicalTransportModel >::read(), timeControl::read(), phaseSystem::alphaControl::read(), generatedCellZone::read(), BirdCarreau::read(), CrossPowerLaw::read(), Time::readDict(), liquidProperties::readIfPresent(), refinementRegions::refinementRegions(), refinementSurfaces::refinementSurfaces(), massTransfer::rho(), rigidBodyMeshMotion::rigidBodyMeshMotion(), rigidBodyMeshMotionSolver::rigidBodyMeshMotionSolver(), rigidBodyModel::rigidBodyModel(), scalarTransport::scalarTransport(), kEpsilonLopesdaCosta< BasicMomentumTransportModel >::setCdAv(), Time::setControls(), subModelBase::setModelProperty(), kEpsilonLopesdaCosta< BasicMomentumTransportModel >::setPorosityCoefficient(), incompressibleFluid::setRDeltaT(), Time::setTime(), sixDoFRigidBodyMotion::sixDoFRigidBodyMotion(), mappedInternalPatchBase::specified(), mappedPatchBaseBase::specified(), ensightSurfaceWriter::surfaceWriter(), Time::Time(), and twoPhaseVoFSolver::twoPhaseVoFSolver().

Here is the caller graph for this function:

lookupEntryPtr() [1/2]

const Foam::entry * lookupEntryPtr	(	const word &	keyword,
		bool	recursive,
		bool	patternMatch
	)		const

Find and return an entry data stream pointer if present.

otherwise return nullptr. If recursive, search parent dictionaries. If patternMatch, use regular expressions

Definition at line 577 of file dictionary.C.

References dictionary::null.

Referenced by Foam::mergeDictionaries(), entry::New(), dynamicCodeContext::read(), unitConversion::readIfPresent(), refinementRegions::refinementRegions(), refinementSurfaces::refinementSurfaces(), dictionary::substituteKeyword(), and solution::upgradeSolverDict().

Here is the caller graph for this function:

lookupEntryPtr() [2/2]

Foam::entry * lookupEntryPtr	(	const word &	keyword,
		bool	recursive,
		bool	patternMatch
	)

Find and return an entry data stream pointer for manipulation.

if present otherwise return nullptr. If recursive, search parent dictionaries. If patternMatch, use regular expressions.

Definition at line 616 of file dictionary.C.

References dictionary::null.

lookupEntryPtrBackwardsCompatible()

const Foam::entry * lookupEntryPtrBackwardsCompatible	(	const wordList &	keywords,
		bool	recursive,
		bool	patternMatch
	)		const

Find and return an entry data stream if present, trying a list.

of keywords in sequence, otherwise return nullptr. If recursive, search parent dictionaries. If patternMatch, use regular expressions

Definition at line 660 of file dictionary.C.

References Foam::endl(), forAll, IOWarningInFunction, entry::keyword(), and Foam::name().

Here is the call graph for this function:

lookupEntry()

const Foam::entry & lookupEntry	(	const word &	keyword,
		bool	recursive,
		bool	patternMatch
	)		const

Find and return an entry data stream if present otherwise error.

If recursive, search parent dictionaries. If patternMatch, use regular expressions.

Definition at line 696 of file dictionary.C.

References Foam::exit(), Foam::FatalIOError, FatalIOErrorInFunction, and Foam::name().

Referenced by lduMatrix::smoother::getName(), lduMatrix::preconditioner::getName(), Foam::listSwitches(), Foam::mergeDictionaries(), lduMatrix::preconditioner::New(), and lduMatrix::smoother::New().

Here is the call graph for this function:

Here is the caller graph for this function:

lookupEntryBackwardsCompatible()

const Foam::entry & lookupEntryBackwardsCompatible	(	const wordList &	keywords,
		bool	recursive,
		bool	patternMatch
	)		const

Find and return an entry data stream if present, trying a list.

of keywords in sequence, otherwise error. If recursive, search parent dictionaries. If patternMatch, use regular expressions

Definition at line 717 of file dictionary.C.

lookup() [1/3]

Foam::ITstream & lookup	(	const word &	keyword,
		bool	recursive = false,
		bool	patternMatch = true
	)		const

Find and return an entry data stream.

If recursive, search parent dictionaries. If patternMatch, use regular expressions.

Definition at line 739 of file dictionary.C.

Referenced by advectiveFvPatchField< Type >::advectiveFvPatchField(), BlendedInterfacialModel< ModelType >::BlendedInterfacialModel(), Foam::blendingDict(), BreakupModel< CloudType >::BreakupModel(), Field< tensor >::clone(), CloudFilmTransfer< CloudType >::CloudFilmTransfer(), collection::collection(), compressibleInterPhaseTransportModel::compressibleInterPhaseTransportModel(), constTransport< Thermo >::constTransport(), forcesBase::createFileNames(), directions::directions(), argList::displayDoc(), ETAB< CloudType >::ETAB(), exponentialSolidTransport< Thermo >::exponentialSolidTransport(), FreeStream< CloudType >::FreeStream(), functions::functions(), fvConstraints::fvConstraints(), fvModels::fvModels(), incompressibleInterPhaseTransportModel::incompressibleInterPhaseTransportModel(), InjectionModel< CloudType >::InjectionModel(), layerParameters::layerParameters(), LocalInteraction< CloudType >::LocalInteraction(), basicThermo::lookupCstrIter(), NamedEnum< Enum, nEnum >::lookupOrDefault(), mixtureName(), medialAxisMeshMover::move(), forcesBase::mu(), multiDirRefinement::multiDirRefinement(), multivariateSelectionScheme< Type >::multivariateSelectionScheme(), SuModel::New(), XiModel::New(), profileModel::New(), CorrectionLimitingMethod::New(), ParticleStressModel::New(), TimeScaleModel::New(), liquidProperties::New(), solidProperties::New(), contactAngleModel::New(), chemistryReductionMethod< ThermoType >::New(), DampingModel< CloudType >::New(), IsotropyModel< CloudType >::New(), PackingModel< CloudType >::New(), surfaceTensionModel::New(), patchDistMethod::New(), relativeVelocityModel::New(), diffusiveMassTransferModel::New(), interfaceCompositionModel::New(), liftModel::New(), turbulentDispersionModel::New(), wallLubricationModel::New(), surfaceTensionCoefficientModel::New(), dragModel::New(), heatTransferModel::New(), virtualMassModel::New(), packingDispersionModel::New(), waveSpectrum::New(), coordinateRotation::New(), interpolation< Type >::New(), PDRDragModel::New(), renumberMethod::New(), solidBodyMotionFunction::New(), generalisedNewtonianViscosityModel::New(), XiEqModel::New(), XiGModel::New(), XiProfile::New(), fvFieldSource< Type >::New(), XiCorrModel::New(), chemistryTabulationMethod::New(), AveragingMethod< Type >::New(), LagrangianPatchField< Type >::New(), coordinateSystem::New(), phaseModel::New(), LagrangianFieldSource< Type >::New(), LduMatrix< Type, DType, LUType >::preconditioner::New(), Reaction< ThermoType >::New(), momentumTransportModel::New(), radiationModel::New(), lduMatrix::solver::New(), LduMatrix< Type, DType, LUType >::smoother::New(), LduMatrix< Type, DType, LUType >::solver::New(), saturationPressureModel::New(), saturationTemperatureModel::New(), polyPatch::New(), energyScalingFunction::New(), pairPotential::New(), sixDoFRigidBodyMotionConstraint::New(), sixDoFRigidBodyMotionRestraint::New(), tetherPotential::New(), Function1< Type >::New(), Function2< Type >::New(), fvConstraint::New(), fvModel::New(), LagrangianModel::New(), LESdelta::New(), fieldValue::New(), motionSolver::New(), sampledSurface::New(), zoneGenerator::New(), sampledSet::New(), functionObject::New(), parcelCloud::New(), setWriter::New(), fvMeshDistributor::New(), fvMeshMover::New(), decomposedBlockData::numBlocks(), dlLibraryTable::open(), multivariateIndependentScheme< Type >::operator()(), axesRotation::operator=(), argList::parse(), PatchInjection< CloudType >::PatchInjection(), patchInternalField::patchInternalField(), polyBoundaryMesh::patchSet(), PilchErdman< CloudType >::PilchErdman(), plane::plane(), populationBalanceSystem::populationBalanceSystem(), powerLawLopesdaCostaZone::powerLawLopesdaCostaZone(), kineticTheoryModel::read(), multiphaseVoFSolver::read(), singleRegionConvergenceControl::read(), singleRegionCorrectorConvergenceControl::read(), cloudSolution::read(), forcesBase::read(), smoothDelta::read(), anisotropicFilter::read(), laplaceFilter::read(), timeControl::read(), patchProbes::read(), probes::read(), consumptionSpeed::read(), relaxation::read(), porosityModel::read(), targetCoeffTrim::read(), generatedCellZone::read(), cavitationModel::read(), fieldAverage::read(), reactionRateFlameArea::read(), doubleSigmoid::read(), sigmoid::read(), azizChen::read(), dampedCoulomb::read(), exponentialRepulsion::read(), lennardJones::read(), maitlandSmith::read(), PDRDragModel::read(), harmonicSpring::read(), pitchForkRing::read(), restrainedHarmonicSpring::read(), unitConversion::read(), generatedZoneSet::read(), Time::readDict(), DimensionedField< Type, GeoMesh, PrimitiveField >::readField(), IOobject::readHeader(), constSolidThermo::readProperty(), ensightPart::reconstruct(), refinementSurfaces::refinementSurfaces(), ReitzDiwakar< CloudType >::ReitzDiwakar(), ReitzKHRT< CloudType >::ReitzKHRT(), boundaryRegion::rename(), rigidBodyModel::rigidBodyModel(), motionSmootherAlgo::scaleMesh(), LagrangianSchemes::schemesDict(), searchableSurfaceList::searchableSurfaceList(), kEpsilonLopesdaCosta< BasicMomentumTransportModel >::setCdAv(), Time::setControls(), kEpsilonLopesdaCosta< BasicMomentumTransportModel >::setPorosityCoefficient(), incompressibleFluid::setRDeltaT(), Time::setTime(), SingleMixtureFraction< CloudType >::SingleMixtureFraction(), structured::structured(), surfaceFeatures::surfaceFeatures(), ensightSurfaceWriter::surfaceWriter(), surfaceZonesInfo::surfaceZonesInfo(), UniformDimensionedField< Type >::UniformDimensionedField(), WallLocalSpringSliderDashpot< CloudType >::WallLocalSpringSliderDashpot(), and waveSuperposition::waveSuperposition().

Here is the caller graph for this function:

lookupBackwardsCompatible() [1/3]

Foam::ITstream & lookupBackwardsCompatible	(	const wordList &	keywords,
		bool	recursive = false,
		bool	patternMatch = true
	)		const

Find and return an entry data stream, trying a list of keywords.

in sequence if not found throw a fatal error relating to the first keyword If recursive, search parent dictionaries. If patternMatch, use regular expressions.

Definition at line 750 of file dictionary.C.

Referenced by laminarModel< BasicMomentumTransportModel >::New(), LESModel< BasicMomentumTransportModel >::New(), RASModel< BasicMomentumTransportModel >::New(), extrudeModel::New(), basicChemistryModel::New(), decompositionMethod::NewDecomposer(), plane::plane(), and Time::readDict().

Here is the caller graph for this function:

lookup() [2/3]

T lookup	(	const word &	keyword,
		bool	recursive = false,
		bool	patternMatch = true
	)		const

Find and return a T, if not found throw a fatal error.

If recursive, search parent dictionaries. If patternMatch, use regular expressions.

Definition at line 139 of file dictionaryTemplates.C.

References Foam::exit(), Foam::FatalIOError, FatalIOErrorInFunction, Foam::name(), and entry::stream().

Here is the call graph for this function:

lookup() [3/3]

T lookup	(	const word &	keyword,
		const unitConversion &	defaultUnits,
		bool	recursive = false,
		bool	patternMatch = true
	)		const

Find and return a T, with dimension checking and unit.

conversions, and if not found throw a fatal error. If recursive, search parent dictionaries. If patternMatch, use regular expressions.

Definition at line 160 of file dictionaryTemplates.C.

References Foam::exit(), Foam::FatalIOError, FatalIOErrorInFunction, Foam::name(), and entry::stream().

Here is the call graph for this function:

lookupBackwardsCompatible() [2/3]

T lookupBackwardsCompatible	(	const wordList &	keywords,
		bool	recursive = false,
		bool	patternMatch = true
	)		const

Find and return a T, trying a list of keywords in sequence,.

and if not found throw a fatal error relating to the first (preferred) keyword. If recursive, search parent dictionaries. If patternMatch, use regular expressions.

Definition at line 182 of file dictionaryTemplates.C.

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

Here is the call graph for this function:

lookupBackwardsCompatible() [3/3]

T lookupBackwardsCompatible	(	const wordList &	keywords,
		const unitConversion &	defaultUnits,
		bool	recursive = false,
		bool	patternMatch = true
	)		const

Find and return a T, with dimension checking and unit.

conversions, trying a list of keywords in sequence, and if not found throw a fatal error relating to the first (preferred) keyword. If recursive, search parent dictionaries. If patternMatch, use regular expressions.

Definition at line 205 of file dictionaryTemplates.C.

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

Here is the call graph for this function:

lookupOrDefault() [1/4]

T lookupOrDefault	(	const word &	,
		const T &	,
		const bool	writeDefault = writeOptionalEntries,
		0
	)		const

Find and return a T, if not found return the given default.

value.

Referenced by CloudFilmTransfer< CloudType >::CloudFilmTransfer(), velocityGroup::correct(), momentumTransferSystem::ddtCorrs(), directions::directions(), fieldAverageItem::fieldAverageItem(), fixedMeanOutletInletFvPatchField< Type >::fixedMeanOutletInletFvPatchField(), freestreamFvPatchField< Type >::freestreamFvPatchField(), momentumTransferSystem::invADVs(), LocalInteraction< CloudType >::LocalInteraction(), meshRefinement::meshRefinement(), basicChemistryModel::New(), argList::parse(), compressibleVoF::read(), multiphaseEuler::read(), twoPhaseSolver::read(), pimpleLoop::read(), pimpleMultiRegionControl::read(), pimpleNoLoopControl::read(), pisoControl::read(), fluidSolutionControl::read(), nonOrthogonalSolutionControl::read(), functionObject::read(), timeControl::read(), multicomponentMixture< ThermoType >::read(), phaseSystem::alphaControl::read(), control::read(), targetCoeffTrim::read(), temperatureDependent::readDict(), refinementSurfaces::refinementSurfaces(), scalarTransport::scalarTransport(), multiphaseVoFSolver::setInterfaceRDeltaT(), twoPhaseVoFSolver::setInterfaceRDeltaT(), incompressibleFluid::setRDeltaT(), fvMatrix< Type >::solve(), and solver::solver().

Here is the caller graph for this function:

lookupOrDefault() [2/4]

T lookupOrDefault	(	const word &	,
		const unitConversion &	,
		const T &	,
		const bool	writeDefault = writeOptionalEntries,
		0
	)		const

Find and return a T with dimension checking and unit.

conversions, and if not found return the given default value. If recursive, search parent dictionaries. If patternMatch, use regular expressions.

lookupOrDefaultBackwardsCompatible() [1/2]

T lookupOrDefaultBackwardsCompatible	(	const wordList &	keywords,
		const T &	defaultValue
	)		const

Find and return a T, trying a list of keywords in sequence,.

and if not found throw a fatal error relating to the first (preferred) keyword If recursive, search parent dictionaries. If patternMatch, use regular expressions.

Definition at line 287 of file dictionaryTemplates.C.

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

Referenced by twoPhaseSolver::read(), pimpleNoLoopControl::read(), and phaseSystem::alphaControl::read().

Here is the call graph for this function:

Here is the caller graph for this function:

lookupOrDefaultBackwardsCompatible() [2/2]

T lookupOrDefaultBackwardsCompatible	(	const wordList &	keywords,
		const unitConversion &	defaultUnits,
		const T &	defaultValue
	)		const

Find and return a T, with dimension checking and unit.

conversions, trying a list of keywords in sequence, and if not found throw a fatal error relating to the first (preferred) keyword If recursive, search parent dictionaries. If patternMatch, use regular expressions.

Definition at line 309 of file dictionaryTemplates.C.

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

Here is the call graph for this function:

lookupOrAddDefault()

T lookupOrAddDefault	(	const word &	keyword,
		const T &	defaultValue
	)

Find and return a T, if not found return the given.

default value, and add to dictionary. If recursive, search parent dictionaries. If patternMatch, use regular expressions.

Definition at line 333 of file dictionaryTemplates.C.

References Foam::add(), Foam::endl(), Foam::indent(), Foam::Info, Foam::name(), and entry::stream().

Referenced by Foam::debug::debugSwitch(), Foam::debug::floatOptimisationSwitch(), Foam::debug::infoSwitch(), Foam::debug::optimisationSwitch(), and Foam::debug::wordOptimisationSwitch().

Here is the call graph for this function:

Here is the caller graph for this function:

readIfPresent() [1/2]

bool readIfPresent	(	const word &	keyword,
		T &	val,
		bool	recursive = false,
		bool	patternMatch = true
	)		const

Find an entry if present, and assign to T.

Returns true if the entry was found. If recursive, search parent dictionaries. If patternMatch, use regular expressions.

Definition at line 361 of file dictionaryTemplates.C.

References Foam::endl(), Foam::indent(), Foam::Info, Foam::name(), and entry::stream().

Referenced by advectiveFvPatchField< Type >::advectiveFvPatchField(), DAC< ThermoType >::DAC(), demandDrivenEntry< Type >::demandDrivenEntry(), subModelBase::getBaseProperty(), subModelBase::getModelProperty(), layerParameters::layerParameters(), linearNormal::linearNormal(), polyPatch::New(), axesRotation::operator=(), parMetis::parMetis(), Foam::preservePatchTypes(), IDDESDelta::read(), maxDeltaxyz::read(), PrandtlDelta::read(), vanDriestDelta::read(), timeControl::read(), probes::read(), Time::readDict(), IOobject::readHeader(), liquidProperties::readIfPresent(), solidProperties::readIfPresent(), thermophysicalProperties::readIfPresent(), Switch::readIfPresent(), ensightPart::reconstruct(), Time::setControls(), Time::setTime(), fvMatrix< Type >::solve(), and surfaceZonesInfo::surfaceZonesInfo().

Here is the call graph for this function:

Here is the caller graph for this function:

readIfPresent() [2/2]

bool readIfPresent	(	const word &	keyword,
		const unitConversion &	defaultUnits,
		T &	val,
		bool	recursive = false,
		bool	patternMatch = true
	)		const

Find an entry if present, and assign to T, with dimension.

checking and unit conversions. Returns true if the entry was found. If recursive, search parent dictionaries. If patternMatch, use regular expressions.

Definition at line 391 of file dictionaryTemplates.C.

References Foam::endl(), Foam::indent(), Foam::Info, Foam::name(), and entry::stream().

Here is the call graph for this function:

lookupScopedEntryPtr()

const Foam::entry * lookupScopedEntryPtr	(	const word &	keyword,
		bool	recursive,
		bool	patternMatch
	)		const

Find and return an entry data stream pointer if present,.

otherwise return nullptr. If recursive, search parent dictionaries. If patternMatch, use regular expressions. Allows scoping using '/' with special handling for '!' and '..'.

Definition at line 766 of file dictionary.C.

References dictionary::null.

Referenced by Foam::getVariable(), and entry::New().

Here is the caller graph for this function:

lookupScoped()

T lookupScoped	(	const word &	keyword,
		bool	recursive = false,
		bool	patternMatch = true
	)		const

Find and return a T,.

if not found throw a fatal error. If recursive, search parent dictionaries. If patternMatch, use regular expressions. Allows scoping using '/' with special handling for '!' and '..'.

Definition at line 422 of file dictionaryTemplates.C.

References Foam::exit(), Foam::FatalIOError, FatalIOErrorInFunction, Foam::name(), and entry::stream().

Here is the call graph for this function:

lookupCompoundScoped()

const T & lookupCompoundScoped	(	const word &	keyword,
		bool	recursive,
		bool	patternMatch
	)		const

Find return the reference to the compound T,.

if not found or not a compound throw a fatal error. If recursive, search parent dictionaries. If patternMatch, use regular expressions. Allows scoping using '/' with special handling for '!' and '..'.

Definition at line 444 of file dictionaryTemplates.C.

References token::compoundToken(), Foam::exit(), Foam::FatalIOError, FatalIOErrorInFunction, Foam::name(), and entry::stream().

Here is the call graph for this function:

isDict()

bool isDict

(

const word &

keyword

)

const

Check if entry is a sub-dictionary.

Definition at line 803 of file dictionary.C.

References entry::isDict().

Referenced by Foam::blendingDict(), fvConstraints::fvConstraints(), fvModels::fvModels(), LagrangianModels::LagrangianModels(), LocalInteraction< CloudType >::LocalInteraction(), basicThermo::lookupCstrIter(), basicChemistryModel::New(), saturationPressureModel::New(), saturationTemperatureModel::New(), phaseSystem::phaseSystem(), multicomponentMixture< ThermoType >::read(), generatedCellZone::read(), generatedZoneSet::read(), and searchableSurfaceList::searchableSurfaceList().

Here is the call graph for this function:

Here is the caller graph for this function:

subDictPtr() [1/2]

const Foam::dictionary * subDictPtr

(

const word &

keyword

)

const

Find and return a sub-dictionary pointer if present.

otherwise return nullptr.

Definition at line 819 of file dictionary.C.

References entry::dict().

Referenced by namedBlock::namedBlock(), namedVertex::namedVertex(), blockVertex::read(), blockDescriptor::write(), and blockVertex::write().

Here is the call graph for this function:

Here is the caller graph for this function:

subDictPtr() [2/2]

Foam::dictionary * subDictPtr

(

const word &

keyword

)

Find and return a sub-dictionary pointer if present.

otherwise return nullptr.

Definition at line 834 of file dictionary.C.

References entry::dict().

Here is the call graph for this function:

subDict() [1/2]

const Foam::dictionary & subDict

(

const word &

keyword

)

const

Find and return a sub-dictionary.

Definition at line 849 of file dictionary.C.

References entry::dict(), Foam::exit(), Foam::FatalIOError, FatalIOErrorInFunction, and Foam::name().

Referenced by sixDoFRigidBodyMotion::addConstraints(), snappyLayerDriver::addLayers(), sixDoFRigidBodyMotion::addRestraints(), patchFluxToFace::applyToSet(), Foam::blendingDict(), BreakupModel< CloudType >::BreakupModel(), CloudFunctionObjectList< CloudType >::CloudFunctionObjectList(), collection::collection(), decompositionMethod::decompositionMethod(), multiRegionSolutionControl::dict(), singleRegionSolutionControl::dict(), argList::displayDoc(), fvMeshDistribute::distribute(), includeEntry::execute(), includeEtcEntry::execute(), functionObjectList::functionObjectList(), subModelBase::getBaseProperty(), subModelBase::getModelProperty(), cloudSolution::integrationSchemes(), cloudSolution::interpolationSchemes(), layerParameters::layerParameters(), LocalInteraction< CloudType >::LocalInteraction(), basicThermo::lookupCstrIter(), laminarModel< BasicMomentumTransportModel >::New(), LESModel< BasicMomentumTransportModel >::New(), RASModel< BasicMomentumTransportModel >::New(), SuModel::New(), XiModel::New(), XiEqModel::New(), XiGModel::New(), XiProfile::New(), basicChemistryModel::New(), phaseModel::New(), saturationPressureModel::New(), saturationTemperatureModel::New(), fvMeshTopoChanger::New(), parcelThermo::parcelThermo(), parMetis::parMetis(), phaseModel::phaseModel(), phaseSystem::phaseSystem(), Foam::preservePatchTypes(), tolerances::read(), MaxwellStefan< BasicThermophysicalTransportModel >::read(), pureMixture< ThermoType >::read(), homogeneousMixture< ThermoType >::read(), inhomogeneousEGRMixture< ThermoType >::read(), inhomogeneousMixture< ThermoType >::read(), leanInhomogeneousMixture< ThermoType >::read(), multicomponentMixture< ThermoType >::read(), singleComponentMixture< ThermoType >::read(), SuModel::read(), XiModel::read(), relaxation::read(), MRFZoneList::read(), porosityModelList::read(), doubleSigmoid::read(), sigmoid::read(), dampedCoulomb::read(), lennardJones::read(), harmonicSpring::read(), pitchForkRing::read(), restrainedHarmonicSpring::read(), XiCorrModel::read(), XiEqModel::read(), XiGModel::read(), XiProfile::read(), generatedZoneSet::read(), Foam::readConfigFile(), liquidProperties::readIfPresent(), constSolidThermo::readProperty(), refinementSurfaces::refinementSurfaces(), rigidBodyModel::rigidBodyModel(), searchableSurfaceList::searchableSurfaceList(), subModelBase::setBaseProperty(), subModelBase::setModelProperty(), cloudSolution::sourceTermDict(), Foam::units(), and dictionary::write().

Here is the call graph for this function:

Here is the caller graph for this function:

subDict() [2/2]

Foam::dictionary & subDict

(

const word &

keyword

)

Find and return a sub-dictionary for manipulation.

Definition at line 864 of file dictionary.C.

References entry::dict(), Foam::exit(), Foam::FatalIOError, FatalIOErrorInFunction, and Foam::name().

Here is the call graph for this function:

subDictBackwardsCompatible()

const Foam::dictionary & subDictBackwardsCompatible

(

const wordList &

keywords

)

const

Find and return a sub-dictionary, trying a list of keywords in.

sequence, otherwise error.

Definition at line 879 of file dictionary.C.

References entry::dict().

Here is the call graph for this function:

subOrEmptyDict()

const Foam::dictionary & subOrEmptyDict	(	const word &	keyword,
		const bool	mustRead = false
	)		const

Find and return a sub-dictionary.

or empty dictionary if the sub-dictionary does not exist

Definition at line 899 of file dictionary.C.

References entry::dict(), Foam::exit(), Foam::FatalIOError, FatalIOErrorInFunction, and Foam::name().

Referenced by decompositionMethod::NewDecomposer(), singleRegionConvergenceControl::read(), and singleRegionCorrectorConvergenceControl::read().

Here is the call graph for this function:

Here is the caller graph for this function:

optionalSubDict()

const Foam::dictionary & optionalSubDict

(

const word &

keyword

)

const

Find and return a sub-dictionary if found.

otherwise return this dictionary

Definition at line 926 of file dictionary.C.

References entry::dict().

Referenced by mixtureViscosityModel::coeffDict(), laminarModel< BasicMomentumTransportModel >::coeffDict(), LESModel< BasicMomentumTransportModel >::coeffDict(), RASModel< BasicMomentumTransportModel >::coeffDict(), extrudeModel::coeffDict(), fvConstraint::coeffs(), directions::directions(), SuModel::New(), XiModel::New(), solidProperties::New(), relativeVelocityModel::New(), packingDispersionModel::New(), waveSpectrum::New(), XiEqModel::New(), XiGModel::New(), XiProfile::New(), XiCorrModel::New(), saturationPressureModel::New(), saturationTemperatureModel::New(), LagrangianModel::New(), motionSolver::New(), sampledSet::New(), LagrangianModels::read(), anisotropicFilter::read(), laplaceFilter::read(), SuModel::read(), XiModel::read(), trimModel::read(), PDRDragModel::read(), solidBodyMotionFunction::read(), BirdCarreau::read(), Casson::read(), CrossPowerLaw::read(), HerschelBulkley::read(), powerLaw::read(), strainRateFunction::read(), XiCorrModel::read(), XiEqModel::read(), XiGModel::read(), and XiProfile::read().

Here is the call graph for this function:

Here is the caller graph for this function:

scopedDict() [1/2]

const Foam::dictionary & scopedDict

(

const word &

keyword

)

const

Find and return a sub-dictionary by scoped lookup.

i.e. the keyword may contain scope characters. If the keyword is null this dictionary is returned

Definition at line 944 of file dictionary.C.

References Foam::abort(), entry::dict(), Foam::endl(), Foam::FatalIOError, FatalIOErrorInFunction, entry::isDict(), and Foam::name().

Referenced by Foam::readConfigFile().

Here is the call graph for this function:

Here is the caller graph for this function:

scopedDict() [2/2]

Foam::dictionary & scopedDict

(

const word &

keyword

)

Find and return a sub-dictionary by scoped lookup.

i.e. the keyword may contain scope characters. If the keyword is null this dictionary is returned

Definition at line 973 of file dictionary.C.

toc()

Foam::wordList toc

(

)

const

Return the table of contents.

Definition at line 982 of file dictionary.C.

References forAllConstIter.

Referenced by CloudFunctionObjectList< CloudType >::CloudFunctionObjectList(), removeEntry::execute(), FreeStream< CloudType >::FreeStream(), Foam::modelSubDict(), ParticleForceList< CloudType >::ParticleForceList(), cloudSolution::read(), multicomponentMixture< ThermoType >::read(), refinementRegions::refinementRegions(), and refinementSurfaces::refinementSurfaces().

Here is the caller graph for this function:

sortedToc()

Foam::wordList sortedToc

(

)

const

Return the sorted table of contents.

Definition at line 996 of file dictionary.C.

keys()

Foam::List< Foam::keyType > keys

(

bool

patterns = false

)

const

Return the list of available keys or patterns.

Definition at line 1002 of file dictionary.C.

References forAllConstIter, and List< T >::setSize().

Referenced by Foam::mergeDictionaries().

Here is the call graph for this function:

Here is the caller graph for this function:

substituteKeyword()

bool substituteKeyword

(

const word &

keyword

)

Substitute the given keyword prepended by '$' with the.

corresponding sub-dictionary entries

Definition at line 181 of file dictionaryIO.C.

References dictionary::add(), entry::dict(), forAllConstIter, and dictionary::lookupEntryPtr().

Here is the call graph for this function:

add() [1/8]

bool add	(	entry *	entryPtr,
		bool	mergeEntry = false
	)

Add a new entry.

With the merge option, dictionaries are interwoven and primitive entries are overwritten

Definition at line 1020 of file dictionary.C.

References entry::dict(), entry::disableFunctionEntries, Foam::endl(), IOWarningInFunction, entry::isDict(), keyType::isPattern(), entry::keyword(), entry::name(), Foam::name(), and UILList< LListBase, T >::remove().

Referenced by error::abort(), IOerror::abort(), Foam::addEntry(), snappyLayerDriver::addLayers(), calcIncludeEntry::codeInclude(), includeEntry::execute(), includeEtcEntry::execute(), error::exit(), IOerror::exit(), Foam::mergeDictionaries(), namedBlock::namedBlock(), namedVertex::namedVertex(), basicChemistryModel::New(), entry::New(), cellTable::operator=(), argList::parse(), Foam::preservePatchTypes(), generatedZoneSet::read(), Foam::readConfigFile(), subModelBase::setBaseProperty(), subModelBase::setModelProperty(), dictionary::substituteKeyword(), solution::upgradeSolverDict(), polynomialSolidTransport< Thermo, PolySize >::write(), adiabaticPerfectFluid< Specie >::write(), Boussinesq< Specie >::write(), icoPolynomial< Specie, PolySize >::write(), icoTabulated< Specie >::write(), incompressiblePerfectGas< Specie >::write(), linear< Type >::write(), perfectFluid< Specie >::write(), rhoConst< Specie >::write(), rhoTabulated< Specie >::write(), rPolynomial< Specie >::write(), specie::write(), eConstThermo< EquationOfState >::write(), eIcoTabulatedThermo< EquationOfState >::write(), ePolynomialThermo< EquationOfState, PolySize >::write(), eTabulatedThermo< EquationOfState >::write(), hConstThermo< EquationOfState >::write(), hIcoTabulatedThermo< EquationOfState >::write(), hPolynomialThermo< EquationOfState, PolySize >::write(), hTabulatedThermo< EquationOfState >::write(), janafThermo< EquationOfState >::write(), AndradeTransport< Thermo >::write(), icoTabulatedTransport< Thermo >::write(), logPolynomialTransport< Thermo, PolySize >::write(), polynomialTransport< Thermo, PolySize >::write(), sutherlandTransport< Thermo >::write(), tabulatedTransport< Thermo >::write(), WLFTransport< Thermo >::write(), surfaceFeatures::writeDict(), and Time::writeTimeDict().

Here is the call graph for this function:

Here is the caller graph for this function:

add() [2/8]

void add	(	const entry &	e,
		bool	mergeEntry = false
	)

Add an entry.

With the merge option, dictionaries are interwoven and primitive entries are overwritten

Definition at line 1112 of file dictionary.C.

References Foam::add(), and Foam::e.

Here is the call graph for this function:

add() [3/8]

void add	(	const keyType &	k,
		const word &	w,
		bool	overwrite = false
	)

Add a word entry.

optionally overwrite an existing entry

Definition at line 1118 of file dictionary.C.

References Foam::add(), k, and overwrite.

Here is the call graph for this function:

add() [4/8]

void add	(	const keyType &	k,
		const string &	s,
		bool	overwrite = false
	)

Add a string entry.

optionally overwrite an existing entry

Definition at line 1124 of file dictionary.C.

References Foam::add(), k, overwrite, and s().

Here is the call graph for this function:

add() [5/8]

void add	(	const keyType &	k,
		const label	l,
		bool	overwrite = false
	)

Add a label entry.

optionally overwrite an existing entry

Definition at line 1135 of file dictionary.C.

References Foam::add(), k, and overwrite.

Here is the call graph for this function:

add() [6/8]

void add	(	const keyType &	k,
		const scalar	s,
		bool	overwrite = false
	)

Add a scalar entry.

optionally overwrite an existing entry

Definition at line 1141 of file dictionary.C.

References Foam::add(), k, overwrite, and s().

Here is the call graph for this function:

add() [7/8]

void add	(	const keyType &	k,
		const dictionary &	d,
		bool	mergeEntry = false
	)

Add a dictionary entry.

optionally merge with an existing sub-dictionary

Definition at line 1147 of file dictionary.C.

References Foam::add(), and k.

Here is the call graph for this function:

add() [8/8]

void add	(	const keyType &	k,
		const T &	t,
		bool	overwrite = false
	)

Add a T entry.

optionally overwrite an existing entry

Definition at line 471 of file dictionaryTemplates.C.

References Foam::add(), k, and overwrite.

Here is the call graph for this function:

set() [1/8]

void set

(

entry *

entryPtr

)

Assign a new entry, overwrite any existing entry.

Definition at line 1158 of file dictionary.C.

References Foam::add(), dictionary::clear(), entry::dict(), entry::isDict(), and entry::keyword().

Here is the call graph for this function:

set() [2/8]

void set

(

const entry &

e

)

Assign a new entry, overwrite any existing entry.

Definition at line 1171 of file dictionary.C.

References Foam::e.

set() [3/8]

void set	(	const keyType &	k,
		const dictionary &	d
	)

Assign a dictionary entry, overwrite any existing entry.

Definition at line 1177 of file dictionary.C.

References k.

set() [4/8]

void set	(	const keyType &	k,
		const T &	t
	)

Assign a T entry, overwrite any existing entry.

Definition at line 478 of file dictionaryTemplates.C.

References k.

set() [5/8]

void set	(	const entry &	e,
		const Entries &	...
	)

Assign multiple entries, overwriting any existing entries.

set() [6/8]

void set	(	const keyType &	,
		const T &	,
		const Entries &	...
	)

Assign multiple T entries, overwriting any existing entries.

remove() [1/2]

bool remove

(

const word &

Keyword

)

Remove an entry specified by keyword.

Definition at line 1183 of file dictionary.C.

References UILList< LListBase, T >::remove().

Referenced by removeEntry::execute(), Foam::mergeDictionaries(), and dictionary::read().

Here is the call graph for this function:

Here is the caller graph for this function:

remove() [2/2]

void remove

(

const wordList &

Keywords

)

Remove entries specified by keywords.

Definition at line 1215 of file dictionary.C.

References forAll.

changeKeyword()

bool changeKeyword	(	const keyType &	oldKeyword,
		const keyType &	newKeyword,
		bool	forceOverwrite = false
	)

Change the keyword for an entry,.

optionally forcing overwrite of an existing entry

Definition at line 1224 of file dictionary.C.

References Foam::endl(), Foam::exit(), Foam::FatalIOError, FatalIOErrorInFunction, IOWarningInFunction, keyType::isPattern(), and Foam::name().

Here is the call graph for this function:

merge()

bool merge

(

const dictionary &

dict

)

Merge entries from the given dictionary.

Also merge sub-dictionaries as required.

Definition at line 1314 of file dictionary.C.

References Foam::abort(), Foam::add(), Foam::clone(), dict, Foam::FatalIOError, FatalIOErrorInFunction, forAllConstIter, and Foam::name().

Referenced by snappyLayerDriver::addLayers(), functionObjectList::functionObjectList(), functionObjectList::New(), Foam::readConfigFile(), and stateModel::stateDict().

Here is the call graph for this function:

Here is the caller graph for this function:

clear()

void clear

(

)

Clear the dictionary.

Definition at line 1359 of file dictionary.C.

References ILList< LListBase, T >::clear().

Referenced by includeEntry::execute(), includeEtcEntry::execute(), functionObjectList::New(), entry::New(), Foam::operator>>(), and dictionary::set().

Here is the call graph for this function:

Here is the caller graph for this function:

transfer()

void transfer

(

dictionary &

dict

)

Transfer the contents of the argument and annul the argument.

Definition at line 1368 of file dictionary.C.

References dict, dictionaryName::name(), Foam::name(), and ILList< LListBase, T >::transfer().

Referenced by Foam::operator>>().

Here is the call graph for this function:

Here is the caller graph for this function:

read()

bool read	(	Istream &	is,
		const bool	keepHeader = false
	)

Read dictionary from Istream, optionally keeping the header.

Definition at line 111 of file dictionaryIO.C.

References IOstream::bad(), token::BEGIN_BLOCK, Foam::endl(), IOstream::eof(), Foam::exit(), Foam::FatalIOError, FatalIOErrorInFunction, IOobject::foamFile, IOstream::good(), InfoInFunction, dictionaryName::name(), IOstream::name(), entry::New(), Istream::putBack(), and dictionary::remove().

Referenced by dictionary::dictionary(), includeEntry::execute(), includeEtcEntry::execute(), includeIfPresentEntry::execute(), dictionary::includedDictionary::includedDictionary(), functionEntry::insert(), MRFZone::read(), BirdCarreau::read(), Casson::read(), CrossPowerLaw::read(), HerschelBulkley::read(), and powerLaw::read().

Here is the call graph for this function:

Here is the caller graph for this function:

global()

bool global ( ) const

virtual

Return true if the dictionary global,.

i.e. the same on all processors. Defaults to false, must be overridden by global IO dictionaries

Reimplemented in zonesGenerator, localIOdictionary, IOdictionary, dictionary::includedDictionary, LagrangianModels, fvModels, and fvConstraints.

Definition at line 168 of file dictionaryIO.C.

References dictionary::global(), and dictionary::null.

Referenced by dictionary::global().

Here is the call graph for this function:

Here is the caller graph for this function:

write()

void write	(	Ostream &	os,
		const bool	subDict = true
	)		const

Write dictionary, normally with sub-dictionary formatting.

Definition at line 226 of file dictionaryIO.C.

References token::BEGIN_BLOCK, Foam::decrIndent(), Foam::e, token::END_BLOCK, Foam::endl(), forAllConstIter, IOstream::good(), Foam::incrIndent(), Foam::indent(), UILList< LListBase, T >::last(), dictionaryName::name(), Foam::nl, dictionary::null, dictionary::parent(), dictionary::subDict(), and WarningInFunction.

Referenced by Foam::stringOps::inplaceExpandCodeString(), Foam::readConfigFile(), dictionaryEntry::write(), dictionaryListEntry::write(), IOdictionary::writeData(), zonesGenerator::writeData(), fvConstraints::writeData(), fvModels::writeData(), LagrangianModels::writeData(), fieldDictionary::writeData(), and surfaceFeatures::writeDict().

Here is the call graph for this function:

Here is the caller graph for this function:

operator[]()

Foam::ITstream & operator[]

(

const word &

keyword

)

const

Find and return entry.

Definition at line 1383 of file dictionary.C.

operator=()

void operator=

(

const dictionary &

rhs

)

Definition at line 1389 of file dictionary.C.

References Foam::abort(), Foam::add(), clear(), Foam::clone(), Foam::FatalIOError, FatalIOErrorInFunction, forAllConstIter, dictionaryName::name(), and Foam::name().

Referenced by dictionary::dictionary(), IOdictionary::IOdictionary(), localIOdictionary::localIOdictionary(), IOdictionary::operator=(), and timeIOdictionary::timeIOdictionary().

Here is the call graph for this function:

Here is the caller graph for this function:

operator+=()

void operator+=

(

const dictionary &

rhs

)

Include entries from the given dictionary.

Warn, but do not overwrite existing entries.

Definition at line 1412 of file dictionary.C.

References Foam::abort(), Foam::add(), Foam::clone(), Foam::FatalIOError, FatalIOErrorInFunction, forAllConstIter, and Foam::name().

Here is the call graph for this function:

operator|=()

void operator|=

(

const dictionary &

rhs

)

Conditionally include entries from the given dictionary.

Do not overwrite existing entries.

Definition at line 1429 of file dictionary.C.

References Foam::abort(), Foam::add(), Foam::clone(), Foam::FatalIOError, FatalIOErrorInFunction, forAllConstIter, found, and Foam::name().

Here is the call graph for this function:

operator<<=()

void operator<<=

(

const dictionary &

rhs

)

Unconditionally include entries from the given dictionary.

Overwrite existing entries.

Definition at line 1449 of file dictionary.C.

References Foam::abort(), Foam::clone(), Foam::FatalIOError, FatalIOErrorInFunction, forAllConstIter, and Foam::name().

Here is the call graph for this function:

entries() [2/2]

std::tuple<const Entries& ...> entries

(

const Entries &...

entries

)

Definition at line 32 of file dictionaryTemplates.C.

References dictionary::entries().

Here is the call graph for this function:

lookupOrDefault() [3/4]

T lookupOrDefault	(	const word &	keyword,
		const T &	defaultValue,
		const bool	writeDefault
	)		const

Definition at line 230 of file dictionaryTemplates.C.

References Foam::endl(), Foam::indent(), Foam::Info, Foam::name(), and entry::stream().

Here is the call graph for this function:

lookupOrDefault() [4/4]

T lookupOrDefault	(	const word &	keyword,
		const unitConversion &	defaultUnits,
		const T &	defaultValue,
		const bool	writeDefault
	)		const

Definition at line 258 of file dictionaryTemplates.C.

References Foam::endl(), Foam::indent(), Foam::Info, Foam::name(), and entry::stream().

Here is the call graph for this function:

set() [7/8]

void set	(	const entry &	e,
		const Entries &...	entries
	)

Definition at line 485 of file dictionaryTemplates.C.

References Foam::e.

set() [8/8]

void set	(	const keyType &	k,
		const T &	t,
		const Entries &...	entries
	)

Definition at line 493 of file dictionaryTemplates.C.

References k.

Friends And Related Function Documentation

entry

friend class entry

friend

Declare friendship with the entry class for IO.

Definition at line 263 of file dictionary.H.

operator>>

Istream& operator>> ( Istream &  , dictionary &    )

friend

Read dictionary from Istream.

operator<<

Ostream& operator<< ( Ostream &  , const dictionary &    )

friend

Write dictionary to Ostream.

Member Data Documentation

null

const Foam::dictionary null

static

Null dictionary.

Definition at line 273 of file dictionary.H.

Referenced by cellModel::cellModel(), entry::clone(), primitiveEntry::dict(), dictionary::found(), dictionary::global(), dictionary::lookupEntryPtr(), dictionary::lookupScopedEntryPtr(), meanVelocityForce::meanVelocityForce(), lduMatrix::preconditioner::New(), entry::New(), Foam::operator>>(), phaseProperties::phaseProperties(), primitiveEntry::primitiveEntry(), Foam::readConfigFile(), and dictionary::write().

writeOptionalEntries

int writeOptionalEntries

static

If true write optional keywords and values.

if not present in dictionary

Definition at line 277 of file dictionary.H.

Referenced by unitConversions::readIfPresent(), and unitConversion::readIfPresent().

---

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

• src/OpenFOAM/db/dictionary/dictionary.H
• src/OpenFOAM/db/dictionary/dictionary.C
• src/OpenFOAM/db/dictionary/dictionaryIO.C
• src/OpenFOAM/db/dictionary/dictionaryTemplates.C