dictionaryEntry Class Reference

A keyword and a list of tokens is a 'dictionaryEntry'. More...

Inheritance diagram for dictionaryEntry:
Collaboration diagram for dictionaryEntry:

Public Member Functions

 dictionaryEntry (const dictionary &parentDict, Istream &)
 Construct from the parent dictionary and Istream. More...
 
 dictionaryEntry (const keyType &, const dictionary &parentDict, Istream &)
 Construct from the keyword, parent dictionary and a Istream. More...
 
 dictionaryEntry (const keyType &, const dictionary &parentDict, const dictionary &dict)
 Construct from the keyword, parent dictionary and a dictionary. More...
 
 dictionaryEntry (const dictionary &parentDict, const dictionaryEntry &)
 Construct as copy for the given parent dictionary. More...
 
 dictionaryEntry (const dictionary &)=delete
 Disallow bitwise copy. More...
 
autoPtr< entryclone (const dictionary &parentDict) const
 Construct on freestore as copy with reference to the. More...
 
const word dictName () const
 Return the local dictionary name (final part of scoped name) More...
 
const fileNamename () const
 Return the dictionary name (scoped, e.g. dictA::dictB::dictC) More...
 
fileNamename ()
 Return the dictionary name (scoped, e.g. dictA::dictB::dictC) More...
 
label startLineNumber () const
 Return line number of first token in dictionary. More...
 
label endLineNumber () const
 Return line number of last token in dictionary. More...
 
ITstreamstream () const
 This entry is not a primitive,. More...
 
bool isDict () const
 Return true because this entry is a dictionary. More...
 
const dictionarydict () const
 Return dictionary. More...
 
dictionarydict ()
 Return non-const access to dictionary. More...
 
void write (Ostream &) const
 Write. More...
 
InfoProxy< dictionaryEntryinfo () const
 Return info proxy. More...
 
- Public Member Functions inherited from entry
 entry (const keyType &)
 Construct from keyword. More...
 
 entry (const entry &)
 Copy constructor. More...
 
virtual autoPtr< entryclone () const
 Construct on freestore as copy. More...
 
virtual ~entry ()
 Destructor. More...
 
const keyTypekeyword () const
 Return keyword. More...
 
keyTypekeyword ()
 Return non-const access to keyword. More...
 
virtual bool isStream () const
 Return true if this entry is a stream. More...
 
void operator= (const entry &)
 
bool operator== (const entry &) const
 
bool operator!= (const entry &) const
 
- Public Member Functions inherited from dictionary
 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, Istream &)
 Construct given the entry name, parent dictionary and Istream,. More...
 
 dictionary (Istream &, const bool keepHeader=false)
 Construct top-level dictionary from Istream,. More...
 
template<class T , class ... KeysAndTs>
 dictionary (const keyType &k, const T &t, const KeysAndTs &... keysAndTs)
 Construct top-level dictionary with given T entries. More...
 
template<class T , class ... KeysAndTs>
 dictionary (const fileName &name, const keyType &k, const T &t, const KeysAndTs &... keysAndTs)
 Construct top-level dictionary with given name and T entries. 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...
 
autoPtr< dictionaryclone () const
 Construct and return clone. More...
 
virtual ~dictionary ()
 Destructor. More...
 
const dictionaryparent () const
 Return the parent dictionary. More...
 
bool isNull () const
 Return whether this dictionary is null. More...
 
const dictionarytopDict () const
 Return the top of the tree. More...
 
word topDictKeyword () const
 Return the scoped keyword with which this dictionary can be. More...
 
label startLineNumber () const
 Return line number of first token in dictionary. More...
 
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 entrylookupEntryPtr (const word &, bool recursive, bool patternMatch) const
 Find and return an entry data stream pointer if present. More...
 
entrylookupEntryPtr (const word &, bool recursive, bool patternMatch)
 Find and return an entry data stream pointer for manipulation. More...
 
const entrylookupEntryPtrBackwardsCompatible (const wordList &, bool recursive, bool patternMatch) const
 Find and return an entry data stream if present, trying a list. More...
 
const entrylookupEntry (const word &, bool recursive, bool patternMatch) const
 Find and return an entry data stream if present otherwise error. More...
 
const entrylookupEntryBackwardsCompatible (const wordList &, bool recursive, bool patternMatch) const
 Find and return an entry data stream if present, trying a list. More...
 
ITstreamlookup (const word &, bool recursive=false, bool patternMatch=true) const
 Find and return an entry data stream. More...
 
ITstreamlookupBackwardsCompatible (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 &, bool recursive=false, bool patternMatch=true) 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 &, bool recursive=false, bool patternMatch=true) const
 Find and return a T with dimension checking and unit. More...
 
template<class T >
T lookupOrDefaultBackwardsCompatible (const wordList &, const T &, bool recursive=false, bool patternMatch=true) 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 &, bool recursive=false, bool patternMatch=true) const
 Find and return a T, with dimension checking and unit. More...
 
template<class T >
T lookupOrAddDefault (const word &, const T &, bool recursive=false, bool patternMatch=true)
 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 entrylookupScopedEntryPtr (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 TlookupCompoundScoped (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 dictionarysubDictPtr (const word &) const
 Find and return a sub-dictionary pointer if present. More...
 
dictionarysubDictPtr (const word &)
 Find and return a sub-dictionary pointer if present. More...
 
const dictionarysubDict (const word &) const
 Find and return a sub-dictionary. More...
 
dictionarysubDict (const word &)
 Find and return a sub-dictionary for manipulation. More...
 
const dictionarysubDictBackwardsCompatible (const wordList &) const
 Find and return a sub-dictionary, trying a list of keywords in. More...
 
dictionary subOrEmptyDict (const word &, const bool mustRead=false) const
 Find and return a sub-dictionary as a copy, or. More...
 
const dictionaryoptionalSubDict (const word &) const
 Find and return a sub-dictionary if found. More...
 
const dictionaryscopedDict (const word &) const
 Find and return a sub-dictionary by scoped lookup. More...
 
dictionaryscopedDict (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< keyTypekeys (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 substituteScopedKeyword (const word &keyword)
 Substitute the given scoped 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 T , class ... KeysAndTs>
void set (const keyType &, const T &, const KeysAndTs &...)
 Assign multiple T entries, overwriting any existing entries. More...
 
bool remove (const word &)
 Remove an entry specified by keyword. 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...
 
ITstreamoperator[] (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 T , class ... KeysAndTs>
void set (const keyType &k, const T &t, const KeysAndTs &... keysAndTs)
 
- 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 fileNamename () const
 Return the dictionary name. More...
 
fileNamename ()
 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...
 
Tfirst ()
 Return the first entry. More...
 
const Tfirst () const
 Return the first entry. More...
 
Tlast ()
 Return the last entry. More...
 
const Tlast () const
 Return the last entry. More...
 
TremoveHead ()
 Remove and return head. More...
 
Tremove (T *p)
 Remove and return element. More...
 
Tremove (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 iteratorend ()
 
const_iterator cbegin () const
 
const const_iteratorcend () const
 
const_iterator begin () const
 
const const_iteratorend () const
 
const_reverse_iterator crbegin () const
 
const const_reverse_iteratorcrend () const
 
const_reverse_iterator rbegin () const
 
const const_reverse_iteratorrend () 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...
 

Friends

Ostreamoperator<< (Ostream &, const dictionaryEntry &)
 

Additional Inherited Members

- Public Types inherited from UILList< LListBase, T >
typedef T value_type
 Type of values the DLList contains. More...
 
typedef Treference
 Type that can be used for storing into DLList::value_type. More...
 
typedef const Tconst_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
 
- Static Public Member Functions inherited from entry
static bool New (dictionary &parentDict, Istream &)
 Construct from Istream and insert into dictionary. More...
 
static autoPtr< entryNew (Istream &is)
 Construct on freestore from Istream and return. More...
 
- Static Public Member Functions inherited from dictionary
static autoPtr< dictionaryNew (Istream &)
 Construct top-level dictionary on freestore from Istream. More...
 
- Static Public Attributes inherited from entry
static int disableFunctionEntries
 
- Static Public Attributes inherited from dictionary
static const dictionary null
 Null dictionary. More...
 
static bool writeOptionalEntries
 If true write optional keywords and values. More...
 

Detailed Description

A keyword and a list of tokens is a 'dictionaryEntry'.

An dictionaryEntry can be read, written and printed, and the types and values of its tokens analysed. A dictionaryEntry 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 64 of file dictionaryEntry.H.

Constructor & Destructor Documentation

◆ dictionaryEntry() [1/5]

dictionaryEntry ( const dictionary parentDict,
Istream is 
)

Construct from the parent dictionary and Istream.

Definition at line 32 of file dictionaryEntryIO.C.

References IOstream::fatalCheck().

Referenced by dictionaryEntry::clone().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ dictionaryEntry() [2/5]

dictionaryEntry ( const keyType key,
const dictionary parentDict,
Istream is 
)

Construct from the keyword, parent dictionary and a Istream.

Definition at line 49 of file dictionaryEntryIO.C.

References IOstream::fatalCheck().

Here is the call graph for this function:

◆ dictionaryEntry() [3/5]

dictionaryEntry ( const keyType key,
const dictionary parentDict,
const dictionary dict 
)

Construct from the keyword, parent dictionary and a dictionary.

Definition at line 30 of file dictionaryEntry.C.

◆ dictionaryEntry() [4/5]

dictionaryEntry ( const dictionary parentDict,
const dictionaryEntry dictEnt 
)

Construct as copy for the given parent dictionary.

Definition at line 42 of file dictionaryEntry.C.

◆ dictionaryEntry() [5/5]

dictionaryEntry ( const dictionary )
delete

Disallow bitwise copy.

Member Function Documentation

◆ clone()

autoPtr<entry> clone ( const dictionary parentDict) const
inlinevirtual

Construct on freestore as copy with reference to the.

dictionary the copy belongs to

Implements entry.

Reimplemented in dictionaryListEntry.

Definition at line 107 of file dictionaryEntry.H.

References dictionaryEntry::dictionaryEntry().

Here is the call graph for this function:

◆ dictName()

const word dictName ( ) const
inline

Return the local dictionary name (final part of scoped name)

Definition at line 116 of file dictionaryEntry.H.

References dictionaryName::dictName().

Here is the call graph for this function:

◆ name() [1/2]

const fileName& name ( ) const
inlinevirtual

Return the dictionary name (scoped, e.g. dictA::dictB::dictC)

Implements entry.

Definition at line 122 of file dictionaryEntry.H.

References dictionaryName::name().

Here is the call graph for this function:

◆ name() [2/2]

fileName& name ( )
inlinevirtual

Return the dictionary name (scoped, e.g. dictA::dictB::dictC)

Implements entry.

Definition at line 128 of file dictionaryEntry.H.

References dictionaryName::name().

Here is the call graph for this function:

◆ startLineNumber()

Foam::label startLineNumber ( ) const
virtual

Return line number of first token in dictionary.

Implements entry.

Definition at line 55 of file dictionaryEntry.C.

References Foam::first().

Here is the call graph for this function:

◆ endLineNumber()

Foam::label endLineNumber ( ) const
virtual

Return line number of last token in dictionary.

Implements entry.

Definition at line 68 of file dictionaryEntry.C.

◆ stream()

Foam::ITstream & stream ( ) const
virtual

This entry is not a primitive,.

calling this function generates a FatalError

Implements entry.

Definition at line 81 of file dictionaryEntry.C.

References Foam::abort(), Foam::FatalIOError, and FatalIOErrorInFunction.

Here is the call graph for this function:

◆ isDict()

bool isDict ( ) const
inlinevirtual

Return true because this entry is a dictionary.

Reimplemented from entry.

Definition at line 144 of file dictionaryEntry.H.

◆ dict() [1/2]

const Foam::dictionary & dict ( ) const
virtual

Return dictionary.

Implements entry.

Definition at line 91 of file dictionaryEntry.C.

◆ dict() [2/2]

Foam::dictionary & dict ( )
virtual

Return non-const access to dictionary.

Implements entry.

Definition at line 97 of file dictionaryEntry.C.

◆ write()

void write ( Ostream os) const
virtual

Write.

Implements entry.

Reimplemented in dictionaryListEntry.

Definition at line 69 of file dictionaryEntryIO.C.

References Ostream::indent(), and dictionary::write().

Referenced by Foam::operator<<().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ info()

InfoProxy<dictionaryEntry> info ( ) const
inline

Return info proxy.

Used to print token information to a stream

Definition at line 160 of file dictionaryEntry.H.

Friends And Related Function Documentation

◆ operator<<

Ostream& operator<< ( Ostream ,
const dictionaryEntry  
)
friend

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