A list of keyword definitions, which are a keyword followed by a number of values (eg, words and numbers) or by a sub-dictionary. Since the dictionary format is used extensively throughout OpenFOAM for input/output files, there are many examples of its use. More...
Classes | |
| class | Searcher |
| Generic const/non-const dictionary entry searcher. More... | |
Public Types | |
| typedef Searcher< true > | const_searcher |
| Searcher with const access. More... | |
| typedef Searcher< false > | searcher |
| Searcher with non-const access. More... | |
 Public Types inherited from UILList< LListBase, T > | |
| typedef T | value_type |
| Type of values stored. More... | |
| typedef T * | pointer |
| Pointer for value_type. More... | |
| typedef const T * | const_pointer |
| Const pointer for value_type. More... | |
| typedef T & | reference |
| Reference for value_type. More... | |
| typedef const T & | const_reference |
| Const reference for value_type. More... | |
| typedef label | size_type |
| The type that can represent the container size. More... | |
| typedef label | difference_type |
| The difference between iterator objects. More... | |
| using | base_iterator = typename LListBase::iterator |
| using | const_base_iterator = typename LListBase::const_iterator |
Public Member Functions | |
| ClassName ("dictionary") | |
| dictionary () | |
| Default construct, a top-level empty dictionary. More... | |
| dictionary (const fileName &name) | |
| Construct top-level empty dictionary with given name. More... | |
| dictionary (const fileName &name, const dictionary &parentDict, Istream &is, bool keepHeader=false) | |
| Construct given the entry name, parent dictionary and Istream, reading entries until EOF, optionally keeping the header. More... | |
| dictionary (Istream &is) | |
| Construct top-level dictionary from Istream (discards the header). Reads entries until EOF or when the first token is a '{' character, it will stop reading at the matching '}' character. More... | |
| dictionary (Istream &is, bool keepHeader) | |
| Construct top-level dictionary from Istream, reading entries until EOF, optionally keeping the header. More... | |
| dictionary (const dictionary &parentDict, const dictionary &dict) | |
| Copy construct given the parent dictionary. More... | |
| dictionary (const dictionary &dict) | |
| Copy construct top-level dictionary. More... | |
| dictionary (const dictionary *dict) | |
| Construct top-level dictionary as copy from pointer to dictionary. More... | |
| dictionary (const dictionary &parentDict, dictionary &&dict) | |
| Move construct for given parent dictionary. More... | |
| dictionary (dictionary &&dict) | |
| Move construct top-level dictionary. More... | |
| autoPtr< dictionary > | clone () const |
| Construct and return clone. More... | |
| virtual | ~dictionary () |
| Destructor. More... | |
| const fileName & | name () const noexcept |
| The dictionary name. More... | |
| fileName & | name () noexcept |
| The dictionary name for modification (use with caution). More... | |
| word | dictName () const |
| The local dictionary name (final part of scoped name) More... | |
| fileName | relativeName (const bool caseTag=false) const |
| The dictionary name relative to the case. More... | |
| bool | isNullDict () const noexcept |
| The dictionary is actually dictionary::null (root dictionary) More... | |
| const dictionary & | parent () const noexcept |
| Return the parent dictionary. More... | |
| const dictionary & | topDict () const |
| Return the top of the tree. 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... | |
| const entry * | findEntry (const word &keyword, enum keyType::option matchOpt=keyType::REGEX) const |
| Find an entry (const access) with the given keyword. More... | |
| entry * | findEntry (const word &keyword, enum keyType::option matchOpt=keyType::REGEX) |
| Find an entry (non-const access) with the given keyword. More... | |
| bool | found (const word &keyword, enum keyType::option matchOpt=keyType::REGEX) const |
| Find an entry (const access) with the given keyword. More... | |
| const entry * | findScoped (const word &keyword, enum keyType::option matchOpt=keyType::REGEX) const |
| Search for a scoped entry (const access) with the given keyword. More... | |
| const dictionary * | findDict (const word &keyword, enum keyType::option matchOpt=keyType::REGEX) const |
| Find and return a sub-dictionary pointer if present (and a sub-dictionary) otherwise return nullptr. More... | |
| dictionary * | findDict (const word &keyword, enum keyType::option matchOpt=keyType::REGEX) |
| Find and return a sub-dictionary pointer if present (and a sub-dictionary) otherwise return nullptr. More... | |
| bool | isDict (const word &keyword, enum keyType::option matchOpt=keyType::REGEX) const |
| Find a sub-dictionary. More... | |
| const entry & | lookupEntry (const word &keyword, enum keyType::option matchOpt) const |
| Search for an entry (const access) with the given keyword. More... | |
| ITstream & | lookup (const word &keyword, enum keyType::option matchOpt=keyType::REGEX) const |
| Find and return an entry data stream. FatalIOError if not found, or not a stream. More... | |
| template<class T > | |
| T | get (const word &keyword, enum keyType::option matchOpt=keyType::REGEX) const |
| Find and return a T. FatalIOError if not found, or if the number of tokens is incorrect. More... | |
| template<class T > | |
| T | getOrDefault (const word &keyword, const T &deflt, enum keyType::option matchOpt=keyType::REGEX) const |
| Find and return a T, or return the given default value. FatalIOError if it is found and the number of tokens is incorrect. More... | |
| template<class T > | |
| T | getOrAdd (const word &keyword, const T &deflt, enum keyType::option matchOpt=keyType::REGEX) |
| Find and return a T, or return the given default value and add it to dictionary. FatalIOError if it is found and the number of tokens is incorrect. More... | |
| template<class T > | |
| bool | readEntry (const word &keyword, T &val, enum keyType::option matchOpt=keyType::REGEX, IOobjectOption::readOption readOpt=IOobjectOption::MUST_READ) const |
| Find entry and assign to T val. FatalIOError if it is found and the number of tokens is incorrect, or it is mandatory and not found. More... | |
| template<class T > | |
| bool | readIfPresent (const word &keyword, T &val, enum keyType::option matchOpt=keyType::REGEX) const |
| Find an entry if present, and assign to T val. FatalIOError if it is found and the number of tokens is incorrect. More... | |
| template<class T , class Predicate > | |
| T | getCheck (const word &keyword, const Predicate &pred, enum keyType::option matchOpt=keyType::REGEX) const |
| Find and return a T with additional checking FatalIOError if not found, or if the number of tokens is incorrect. More... | |
| template<class T , class Predicate > | |
| T | getCheckOrDefault (const word &keyword, const T &deflt, const Predicate &pred, enum keyType::option matchOpt=keyType::REGEX) const |
| Find and return a T, or return the given default value. FatalIOError if it is found and the number of tokens is incorrect. More... | |
| template<class T , class Predicate > | |
| T | getCheckOrAdd (const word &keyword, const T &deflt, const Predicate &pred, enum keyType::option matchOpt=keyType::REGEX) |
| Find and return a T, or return the given default value and add it to dictionary. FatalIOError if it is found and the number of tokens is incorrect. More... | |
| template<class T , class Predicate > | |
| bool | readCheck (const word &keyword, T &val, const Predicate &pred, enum keyType::option matchOpt=keyType::REGEX, IOobjectOption::readOption readOpt=IOobjectOption::MUST_READ) const |
| Find entry and assign to T val. FatalIOError if it is found and the number of tokens is incorrect, or it is mandatory and not found. More... | |
| template<class T , class Predicate > | |
| bool | readCheckIfPresent (const word &keyword, T &val, const Predicate &pred, enum keyType::option matchOpt=keyType::REGEX) const |
| Find an entry if present, and assign to T val. FatalIOError if it is found and the number of tokens is incorrect. More... | |
| const dictionary & | subDict (const word &keyword, enum keyType::option matchOpt=keyType::REGEX) const |
| Find and return a sub-dictionary. More... | |
| dictionary & | subDict (const word &keyword, enum keyType::option matchOpt=keyType::REGEX) |
| Find and return a sub-dictionary for manipulation. More... | |
| dictionary & | subDictOrAdd (const word &keyword, enum keyType::option matchOpt=keyType::REGEX) |
| Find and return a sub-dictionary for manipulation. More... | |
| dictionary | subOrEmptyDict (const word &keyword, enum keyType::option matchOpt=keyType::REGEX, const bool mandatory=false) const |
| Find and return a sub-dictionary as a copy, otherwise return an empty dictionary. More... | |
| const dictionary & | optionalSubDict (const word &keyword, enum keyType::option matchOpt=keyType::REGEX) const |
| Find and return a sub-dictionary, otherwise return this dictionary. More... | |
| wordList | toc () const |
| Return the table of contents. More... | |
| wordList | sortedToc () const |
| Return the sorted table of contents. More... | |
| template<class Compare > | |
| wordList | sortedToc (const Compare &comp) const |
| Return table of contents sorted using the specified comparator. More... | |
| List< keyType > | keys (bool patterns=false) const |
| Return the list of available keys or patterns. More... | |
| bool | substituteKeyword (const word &keyword, bool mergeEntry=false) |
| Substitute the given keyword (which is prefixed by '$') More... | |
| bool | substituteScopedKeyword (const word &keyword, bool mergeEntry=false) |
| Substitute the given scoped keyword (which is prefixed by '$') More... | |
| entry * | add (entry *entryPtr, bool mergeEntry=false) |
| Add a new entry. More... | |
| entry * | add (const entry &e, bool mergeEntry=false) |
| Add an entry. More... | |
| entry * | add (const keyType &k, const word &v, bool overwrite=false) |
| Add a word entry. More... | |
| entry * | add (const keyType &k, const string &v, bool overwrite=false) |
| Add a string entry. More... | |
| entry * | add (const keyType &k, const label v, bool overwrite=false) |
| Add a label entry. More... | |
| entry * | add (const keyType &k, const scalar v, bool overwrite=false) |
| Add a scalar entry. More... | |
| entry * | add (const keyType &k, const dictionary &d, bool mergeEntry=false) |
| Add a dictionary entry. More... | |
| template<class T > | |
| entry * | add (const keyType &k, const T &v, bool overwrite=false) |
| Add a T entry. More... | |
| entry * | set (entry *entryPtr) |
| Assign a new entry, overwriting any existing entry. More... | |
| entry * | set (const entry &e) |
| Assign a new entry, overwriting any existing entry. More... | |
| entry * | set (const keyType &k, const dictionary &v) |
| Assign a dictionary entry, overwriting any existing entry. More... | |
| template<class T > | |
| entry * | set (const keyType &k, const T &v) |
| Assign a T entry, overwriting any existing entry. More... | |
| bool | remove (const word &keyword) |
| Remove an entry specified by keyword. More... | |
| bool | changeKeyword (const keyType &oldKeyword, const keyType &newKeyword, bool overwrite=false) |
| Change the keyword for an entry,. More... | |
| bool | merge (const dictionary &dict) |
| Merge entries from the given dictionary. More... | |
| void | clear () |
| Clear the dictionary. More... | |
| void | transfer (dictionary &dict) |
| Transfer the contents of the argument and annul the argument. More... | |
| void | checkITstream (const ITstream &is, const word &keyword) const |
| Check after reading if the input token stream has unconsumed tokens remaining or if there were no tokens in the first place. More... | |
| bool | read (Istream &is) |
| Read dictionary from Istream (discards the header). Reads entries until EOF or when the first token is a '{' character, it will stop reading at the matching '}' character. More... | |
| bool | read (Istream &is, bool keepHeader) |
| Read dictionary from Istream (optionally keeping the header) Reads entries until EOF or when the first token is a '{' character, it will stop reading at the matching '}' character. More... | |
| void | writeEntry (Ostream &os) const |
| Write sub-dictionary with its dictName as its header. More... | |
| void | writeEntry (const keyType &keyword, Ostream &os) const |
| Write sub-dictionary with the keyword as its header. More... | |
| void | writeEntries (Ostream &os, const bool extraNewLine=false) const |
| Write dictionary entries. More... | |
| void | write (Ostream &os, const bool subDict=true) const |
| Write dictionary, normally with sub-dictionary formatting. More... | |
| const_searcher | csearch (const word &keyword, enum keyType::option matchOpt=keyType::REGEX) const |
| Search dictionary for given keyword. More... | |
| const_searcher | search (const word &keyword, enum keyType::option matchOpt=keyType::REGEX) const |
| Search dictionary for given keyword. More... | |
| searcher | search (const word &keyword, enum keyType::option matchOpt=keyType::REGEX) |
| Search dictionary for given keyword. More... | |
| const_searcher | csearchScoped (const word &keyword, enum keyType::option matchOpt) const |
| Search using scoping. More... | |
| const_searcher | searchScoped (const word &keyword, enum keyType::option matchOpt) const |
| Search using dot or slash scoping. More... | |
| searcher | searchScoped (const word &keyword, enum keyType::option matchOpt) |
| Search using dot or slash scoping. More... | |
| const dictionary * | cfindScopedDict (const fileName &dictPath) const |
| Locate a sub-dictionary using slash-scoping. More... | |
| const dictionary * | findScopedDict (const fileName &dictPath) const |
| Locate a sub-dictionary using slash-scoping. More... | |
| dictionary * | findScopedDict (const fileName &dictPath) |
| Locate a sub-dictionary using slash-scoping. More... | |
| dictionary * | makeScopedDict (const fileName &dictPath) |
| Locate existing or create sub-dictionary using slash-scoping. More... | |
| const_searcher | csearchCompat (const word &keyword, std::initializer_list< std::pair< const char *, int >> compat, enum keyType::option matchOpt=keyType::REGEX) const |
| Search dictionary for given keyword and any compatibility names. More... | |
| const entry * | findCompat (const word &keyword, std::initializer_list< std::pair< const char *, int >> compat, enum keyType::option matchOpt) const |
| Find and return an entry pointer if present, or return a nullptr, using any compatibility names if needed. More... | |
| bool | foundCompat (const word &keyword, std::initializer_list< std::pair< const char *, int >> compat, enum keyType::option matchOpt=keyType::REGEX) const |
| Search dictionary for given keyword and any compatibility names. More... | |
| const entry & | lookupEntryCompat (const word &keyword, std::initializer_list< std::pair< const char *, int >> compat, enum keyType::option matchOpt) const |
| Find and return an entry if present, otherwise FatalIOError, using any compatibility names if needed. More... | |
| ITstream & | lookupCompat (const word &keyword, std::initializer_list< std::pair< const char *, int >> compat, enum keyType::option matchOpt=keyType::REGEX) const |
| Find and return an entry data stream, using any compatibility names if needed. More... | |
| template<class T > | |
| T | getCompat (const word &keyword, std::initializer_list< std::pair< const char *, int >> compat, enum keyType::option matchOpt=keyType::REGEX) const |
| Find and return a T using any compatibility names if needed. FatalIOError if not found, or if there are excess tokens. More... | |
| template<class T > | |
| T | getOrDefaultCompat (const word &keyword, std::initializer_list< std::pair< const char *, int >> compat, const T &deflt, enum keyType::option matchOpt=keyType::REGEX) const |
| Find and return a T, or return the given default value using any compatibility names if needed. More... | |
| template<class T > | |
| bool | readCompat (const word &keyword, std::initializer_list< std::pair< const char *, int >> compat, T &val, enum keyType::option matchOpt=keyType::REGEX, IOobjectOption::readOption readOpt=IOobjectOption::MUST_READ) const |
| Find entry and assign to T val using any compatibility names if needed. FatalIOError if there are excess tokens. More... | |
| template<class T > | |
| bool | readIfPresentCompat (const word &keyword, std::initializer_list< std::pair< const char *, int >> compat, T &val, enum keyType::option matchOpt=keyType::REGEX) const |
| Find an entry if present, and assign to T val using any compatibility names if needed. FatalIOError if it is found and there are excess tokens. More... | |
| void | operator= (const dictionary &rhs) |
| Copy assignment. More... | |
| void | operator+= (const dictionary &rhs) |
| Include entries from the given dictionary. More... | |
| void | operator|= (const dictionary &rhs) |
| Conditionally include entries from the given dictionary. More... | |
| void | operator<<= (const dictionary &rhs) |
| Unconditionally include entries from the given dictionary. More... | |
| bool | getBool (const word &keyword, enum keyType::option matchOpt=keyType::REGEX) const |
| Same as get< bool >(const word&, keyType::option) More... | |
| label | getLabel (const word &keyword, enum keyType::option matchOpt=keyType::REGEX) const |
| Same as get< label >(const word&, keyType::option) More... | |
| scalar | getScalar (const word &keyword, enum keyType::option matchOpt=keyType::REGEX) const |
| Same as get< scalar >(const word&, keyType::option) More... | |
| string | getString (const word &keyword, enum keyType::option matchOpt=keyType::REGEX) const |
| Same as get< string >(const word&, keyType::option) More... | |
| word | getWord (const word &keyword, enum keyType::option matchOpt=keyType::REGEX) const |
| Same as get< word >(const word&, keyType::option) More... | |
| fileName | getFileName (const word &keyword, enum keyType::option matchOpt=keyType::REGEX) const |
| Same as get< fileName >(const word&, keyType::option) More... | |
| template<class T > | |
| T | lookupOrDefault (const word &keyword, const T &deflt, enum keyType::option matchOpt=keyType::REGEX) const |
| Same as getOrDefault() More... | |
| template<class T > | |
| T | lookupOrAddDefault (const word &keyword, const T &deflt, enum keyType::option matchOpt=keyType::REGEX) |
| Same as getOrAdd() More... | |
| ITstream & | operator[] (const word &keyword) const |
| Deprecated(2018-07) - use lookup() method. More... | |
| bool | found (const word &keyword, bool recursive, bool patternMatch=true) const |
| Deprecated(2018-10) More... | |
| entry * | lookupEntryPtr (const word &keyword, bool recursive, bool patternMatch) |
| Deprecated(2018-10) More... | |
| const entry * | lookupEntryPtr (const word &keyword, bool recursive, bool patternMatch) const |
| Deprecated(2018-10) More... | |
| const entry * | lookupScopedEntryPtr (const word &keyword, bool recursive, bool patternMatch) const |
| Deprecated(2018-10) More... | |
| const dictionary * | subDictPtr (const word &keyword) const |
| Deprecated(2018-10) More... | |
| dictionary * | subDictPtr (const word &keyword) |
| Deprecated(2018-10) Find and return a sub-dictionary pointer if present. More... | |
| const entry & | lookupEntry (const word &keyword, bool recursive, bool patternMatch) const |
| Deprecated(2018-10) More... | |
| ITstream & | lookup (const word &keyword, bool recursive, bool patternMatch=true) const |
| Deprecated(2018-10) More... | |
| template<class T > | |
| T | lookupOrDefault (const word &keyword, const T &deflt, bool recursive, bool patternMatch=true) const |
| Deprecated(2018-10) More... | |
| template<class T > | |
| T | lookupOrAddDefault (const word &keyword, const T &deflt, bool recursive, bool patternMatch=true) |
| Deprecated(2018-10) More... | |
| template<class T > | |
| bool | readIfPresent (const word &keyword, T &val, bool recursive, bool patternMatch=true) const |
| Deprecated(2018-10) More... | |
| template<class T > | |
| T | lookupType (const word &keyword, bool recursive=false, bool patternMatch=true) const |
| Deprecated(2018-10) find and return a T. More... | |
| template<class Compare > | |
| Foam::wordList | sortedToc (const Compare &comp) const |
| template<class T > | |
| Foam::entry * | add (const keyType &k, const T &v, bool overwrite) |
| template<class T > | |
| Foam::entry * | set (const keyType &k, const T &v) |
| Public Member Functions inherited from ILList< LListBase, T > | |
| ILList ()=default | |
| Default construct. More... | |
| ILList (T *item) | |
| Construct and add initial item pointer. More... | |
| ILList (Istream &is) | |
| Construct from Istream. More... | |
| ILList (const ILList< LListBase, T > &lst) | |
| Copy construct using the 'clone()' method for each element. More... | |
| ILList (ILList< LListBase, T > &&lst) | |
| Move construct. More... | |
| template<class CloneArg > | |
| ILList (const ILList< LListBase, T > &lst, const CloneArg &cloneArg) | |
| Copy constructor with additional argument for clone 'clone()'. More... | |
| template<class INew > | |
| ILList (Istream &is, const INew &inew) | |
| Construct from Istream using given Istream constructor class. More... | |
| ~ILList () | |
| Destructor. Calls clear() More... | |
| void | clear () |
| Clear the contents of the list. More... | |
| void | pop_front (label n=1) |
| Remove first element(s) from the list (deletes pointers) More... | |
| bool | erase (T *item) |
| Remove the specified element from the list and delete it. More... | |
| void | transfer (ILList< LListBase, T > &lst) |
| Transfer the contents of the argument into this List and annul the argument list. More... | |
| void | operator= (const ILList< LListBase, T > &lst) |
| Copy assignment using the 'clone()' method for each element. More... | |
| void | operator= (ILList< LListBase, T > &&lst) |
| Move assignment. More... | |
| Public Member Functions inherited from UILList< LListBase, T > | |
| UILList ()=default | |
| Default construct. More... | |
| UILList (T *item) | |
| Construct and add initial item pointer. More... | |
| UILList (const UILList< LListBase, T > &list) | |
| Construct as copy. More... | |
| T * | front () |
| The first entry in the list. More... | |
| const T * | front () const |
| The first entry in the list (const access) More... | |
| T * | back () |
| The last entry in the list. More... | |
| const T * | back () const |
| The last entry in the list (const access) More... | |
| T * | removeHead () |
| Remove and return head. More... | |
| T * | remove (T *item) |
| Remove and return element. More... | |
| T * | remove (iterator &iter) |
| Remove and return item specified by iterator. More... | |
| void | operator= (const UILList< LListBase, T > &lst) |
| Copy assignment. More... | |
| bool | operator== (const UILList< LListBase, T > &lst) const |
| Equality. True both lists are element-wise equal. More... | |
| bool | operator!= (const UILList< LListBase, T > &lst) const |
| The opposite of the equality operation. Takes linear time. More... | |
| Ostream & | writeList (Ostream &os, const label shortLen=0) const |
| Write UILList with line-breaks when length exceeds shortLen. More... | |
| iterator | begin () |
| Iterator to first item in list with non-const access. More... | |
| const_iterator | cbegin () const |
| Iterator to first item in list with const access. More... | |
| reverse_iterator | rbegin () |
| Iterator to last item in list with non-const access. More... | |
| const_reverse_iterator | crbegin () const |
| Iterator to last item in list with const access. More... | |
| const_iterator | begin () const |
| Iterator to first item in list with const access. More... | |
| const_reverse_iterator | rbegin () const |
| Iterator to last item in list with const access. More... | |
| const iterator & | end () |
| End of list for forward iterators. More... | |
| const const_iterator & | cend () const |
| End of list for forward iterators. More... | |
| const reverse_iterator & | rend () |
| End of list for reverse iterators. More... | |
| const const_reverse_iterator & | crend () const |
| End of list for reverse iterators. More... | |
| const const_iterator & | end () const |
| End of list for forward iterators. More... | |
| const const_reverse_iterator & | rend () const |
| End of list for reverse iterators. More... | |
| T * | first () |
| The first entry in the list. More... | |
| const T * | first () const |
| The first entry in the list (const access) More... | |
| T * | last () |
| The last entry in the list. More... | |
| const T * | last () const |
| The last entry in the list (const access) More... | |
Static Public Member Functions | |
| static int | reportOptional () noexcept |
| Return the state of reporting optional (default) entries. More... | |
| static int | reportOptional (const int level) noexcept |
| Change the state of reporting optional (default) entries. More... | |
| static autoPtr< dictionary > | New (Istream &is) |
| Construct top-level dictionary on freestore from Istream. More... | |
Public Attributes | |
| friend | const_searcher |
| Declare friendship with the searcher classes. More... | |
| friend | searcher |
Static Public Attributes | |
| static int | writeOptionalEntries |
| Report optional keywords and values if not present in dictionary. More... | |
| static const dictionary | null |
| An empty dictionary, which is also the parent for all dictionaries. More... | |
| static refPtr< OSstream > | reportingOutput |
| Output location when reporting default values. More... | |
Friends | |
| class | entry |
| Declare friendship with the entry class for IO. More... | |
| Istream & | operator>> (Istream &is, dictionary &dict) |
| Read dictionary from Istream. More... | |
| Ostream & | operator<< (Ostream &os, const dictionary &dict) |
| Write dictionary to Ostream. More... | |
A list of keyword definitions, which are a keyword followed by a number of values (eg, words and numbers) or by a sub-dictionary. Since the dictionary format is used extensively throughout OpenFOAM for input/output files, there are many examples of its use.
Dictionary keywords are a plain word or a pattern (regular expression). The general order for searching is as follows:
The dictionary class is the base class for IOdictionary and also serves as a bootstrap dictionary for the objectRegistry data dictionaries.
'$' syntax familiar from shell programming. Similarly, the '/' separator is used when referencing sub-dictionary entries:'/' anchor specifies that the path starts from the top-level entry. It is also possible to use the '${}' syntax for clarity.For example,
key1 val1;
key2 $key1; // Use key1 value from current scope
key3 $./key1; // Use key1 value from current scope
subdict1
{
key1 val1b;
key2 $../key1; // Use key1 value from parent
subdict2
{
key2 val2;
key3 $../../key1; // Use key1 value from grandparent
}
}
key4 $/subdict1/subdict2/key3; // Lookup with absolute scoping
Prior to OpenFOAM-v1712, a dot-scoping (.) syntax was used, which is still supported (AUG-2023) but deprecated in favour of the less ambiguous slash-scoping (/) syntax. With dot-scoping, an initial '^' anchor, or an initial (:), was used to specify that the path starts from the top-level entry.
Definition at line 129 of file dictionary.H.
| typedef Searcher<true> const_searcher |
Searcher with const access.
Definition at line 312 of file dictionary.H.
Searcher with non-const access.
Definition at line 317 of file dictionary.H.
| dictionary | ( | ) |
Default construct, a top-level empty dictionary.
Definition at line 68 of file dictionary.C.
Referenced by localIOdictionary::readContents(), and IOdictionary::readContents().
|
explicit |
Construct top-level empty dictionary with given name.
Definition at line 75 of file dictionary.C.
| dictionary | ( | const fileName & | name, |
| const dictionary & | parentDict, | ||
| Istream & | is, | ||
| bool | keepHeader = false |
||
| ) |
Construct given the entry name, parent dictionary and Istream, reading entries until EOF, optionally keeping the header.
Definition at line 28 of file dictionaryIO.C.
References Foam::blockMeshTools::read().
| dictionary | ( | Istream & | is | ) |
Construct top-level dictionary from Istream (discards the header). Reads entries until EOF or when the first token is a '{' character, it will stop reading at the matching '}' character.
Definition at line 42 of file dictionaryIO.C.
| dictionary | ( | Istream & | is, |
| bool | keepHeader | ||
| ) |
Construct top-level dictionary from Istream, reading entries until EOF, optionally keeping the header.
Definition at line 48 of file dictionaryIO.C.
References dictionary::read(), and entry::resetInputMode().
| dictionary | ( | const dictionary & | parentDict, |
| const dictionary & | dict | ||
| ) |
Copy construct given the parent dictionary.
Definition at line 83 of file dictionary.C.
References Foam::constant::electromagnetic::e.
| dictionary | ( | const dictionary & | dict | ) |
Copy construct top-level dictionary.
Definition at line 106 of file dictionary.C.
References Foam::constant::electromagnetic::e.
|
explicit |
Construct top-level dictionary as copy from pointer to dictionary.
A null pointer is treated like an empty dictionary.
Definition at line 127 of file dictionary.C.
References dict, and dictionary::operator=().
| dictionary | ( | const dictionary & | parentDict, |
| dictionary && | dict | ||
| ) |
Move construct for given parent dictionary.
Definition at line 140 of file dictionary.C.
References fileName::concat(), dict, Foam::name(), and dictionary::name().
| dictionary | ( | dictionary && | dict | ) |
|
virtual |
Destructor.
Definition at line 173 of file dictionary.C.
| ClassName | ( | "dictionary" | ) |
|
inlinestaticnoexcept |
Return the state of reporting optional (default) entries.
0: no reporting, 1: report, 2: fatal if not set
Definition at line 25 of file dictionaryI.H.
References dictionary::writeOptionalEntries.
|
inlinestaticnoexcept |
Change the state of reporting optional (default) entries.
0: no reporting, 1: report, 2: fatal if not set
Definition at line 31 of file dictionaryI.H.
| Foam::autoPtr< Foam::dictionary > clone | ( | ) | const |
Construct and return clone.
Definition at line 165 of file dictionary.C.
References autoPtr< T >::New().
Referenced by Foam::preservePatchTypes(), and refinementSurfaces::refinementSurfaces().
|
static |
Construct top-level dictionary on freestore from Istream.
Definition at line 62 of file dictionaryIO.C.
References autoPtr< T >::New().
|
inlinenoexcept |
The dictionary name.
Definition at line 41 of file dictionaryI.H.
Referenced by chemkinReader::chemkinReader(), Foam::copyFilteredDict(), dictionary::dictionary(), decompositionMethod::findCoeffsDict(), motionSmootherAlgo::get(), meshRefinement::get(), JobInfo::JobInfo(), dictionaryEntry::name(), dictionary::operator=(), Foam::operator>>(), dynamicCodeContext::readEntry(), dictionary::transfer(), Foam::unitSet(), codedBase::updateLibrary(), and velocityDisplacementMotionSolver::velocityDisplacementMotionSolver().
|
inlinenoexcept |
The dictionary name for modification (use with caution).
Definition at line 47 of file dictionaryI.H.
|
inline |
The local dictionary name (final part of scoped name)
Definition at line 53 of file dictionaryI.H.
Referenced by radiation::addSup(), interRegionHeatTransferModel::addSup(), hydrostaticPressure::calculateAndWrite(), variableHeatTransfer::calculateHtc(), limitTemperature::correct(), ReynoldsAnalogy::Cp(), ReynoldsAnalogy::devReff(), filmTurbulenceModel::devRhoReff(), forces::devRhoReff(), effectivenessTable::energyDensity(), wallHeatFlux::execute(), jouleHeatingSource::jouleHeatingSource(), forces::mu(), blendingMethod::New(), thermophysicalProperties::New(), objectiveGeometric::New(), basicSolidChemistryModel::New(), liquidProperties::New(), profileModel::New(), objectiveIncompressible::New(), limitTurbulenceViscosity::nu(), enthalpySorptionFvPatchScalarField::patchSource(), speciesSorptionFvPatchScalarField::patchSource(), heatTransferCoeffModel::q(), limitTemperature::read(), multiFieldValue::read(), solidificationMeltingSource::solidificationMeltingSource(), gradientUnburntEnthalpyFvPatchScalarField::updateCoeffs(), fixedUnburntEnthalpyFvPatchScalarField::updateCoeffs(), mixedUnburntEnthalpyFvPatchScalarField::updateCoeffs(), outletMappedUniformInletHeatAdditionFvPatchField::updateCoeffs(), outletMachNumberPressureFvPatchScalarField::updateCoeffs(), turbulentTemperatureRadCoupledMixedFvPatchScalarField::updateCoeffs(), and viscousDissipation::viscousDissipation().
| Foam::fileName relativeName | ( | const bool | caseTag = false | ) | const |
The dictionary name relative to the case.
Uses argList::envRelativePath to obtain FOAM_CASE
| caseTag | replace globalPath with <case> for later use with expand(), or prefix <case> if the file name was not an absolute location |
Definition at line 179 of file dictionary.C.
References argList::envRelativePath(), and Foam::name().
Referenced by codeStream::evaluate(), includeEtcEntry::execute(), includeEntry::execute(), meshRefinement::lookup(), messageStream::operator()(), IOerror::operator()(), dimensionSet::readEntry(), dictionaryEntry::relativeName(), meshRefinement::subDict(), and Foam::warnCompatDegrees().
|
inlinenoexcept |
The dictionary is actually dictionary::null (root dictionary)
Definition at line 71 of file dictionaryI.H.
References dictionary::null.
|
inlinenoexcept |
Return the parent dictionary.
Definition at line 77 of file dictionaryI.H.
| const Foam::dictionary & topDict | ( | ) | const |
Return the top of the tree.
Definition at line 185 of file dictionary.C.
References IOobject::name(), and p.
Referenced by includeEtcEntry::execute(), includeEntry::execute(), and codeStream::getFunction().
| Foam::label startLineNumber | ( | ) | const |
Return line number of first token in dictionary.
Definition at line 198 of file dictionary.C.
Referenced by messageStream::operator()(), IOerror::operator()(), dictionaryEntry::startLineNumber(), and codedBase::updateLibrary().
| Foam::label endLineNumber | ( | ) | const |
Return line number of last token in dictionary.
Definition at line 209 of file dictionary.C.
Referenced by dictionaryEntry::endLineNumber(), messageStream::operator()(), and IOerror::operator()().
| Foam::SHA1Digest digest | ( | ) | const |
Return the SHA1 digest of the dictionary contents.
Definition at line 220 of file dictionary.C.
References Foam::constant::electromagnetic::e, and os().
Referenced by functionObjectList::read().
| Foam::tokenList tokens | ( | ) | const |
Return the dictionary as a list of tokens.
Definition at line 234 of file dictionary.C.
References Foam::constant::electromagnetic::e, os(), and ITstream::parse().
|
inline |
Find an entry (const access) with the given keyword.
| keyword | the keyword to search for |
| matchOpt | search mode (default: non-recursive with patterns) |
Definition at line 84 of file dictionaryI.H.
Referenced by boundaryRadiationProperties::boundaryRadiationProperties(), dynamicCodeContext::findEntry(), Foam::getOrAdd(), meshRefinement::lookup(), dictionary::lookupEntryPtr(), fvGeometryScheme::New(), sampledSets::read(), sampledSurfaces::read(), dynamicCodeContext::readEntry(), dimensionSet::readEntry(), refinementSurfaces::refinementSurfaces(), shellSurfaces::shellSurfaces(), solution::upgradeSolverDict(), Foam::writeEntryIfPresent(), caseInfo::writeFileDicts(), and caseInfo::writeRegisteredDicts().
|
inline |
Find an entry (non-const access) with the given keyword.
| keyword | the keyword to search for |
| matchOpt | search mode (default: non-recursive with patterns) |
Definition at line 94 of file dictionaryI.H.
|
inline |
Find an entry (const access) with the given keyword.
| keyword | the keyword to search for |
| matchOpt | search mode (default: non-recursive with patterns) |
Definition at line 104 of file dictionaryI.H.
References Foam::blockMeshTools::findEntry().
Referenced by sixDoFRigidBodyMotion::addConstraints(), sixDoFRigidBodyMotion::addRestraints(), quasiNewton::allocateHessian(), LBFGS::allocateVectors(), angularOscillatingDisplacementPointPatchVectorField::angularOscillatingDisplacementPointPatchVectorField(), angularOscillatingVelocityPointPatchVectorField::angularOscillatingVelocityPointPatchVectorField(), DAC< CompType, ThermoType >::DAC(), designVariablesUpdate::designVariablesUpdate(), Foam::dimensionedConstant(), DRG< CompType, ThermoType >::DRG(), DRGEP< CompType, ThermoType >::DRGEP(), dictionary::found(), properties::foundObjectProperty(), subModelBase::getModelDict(), subModelBase::getModelProperty(), adjointSolver::getObjectiveSensitivities(), properties::getObjectResult(), refinementParameters::getZoneInfo(), properties::hasResultObject(), properties::hasResultObjectEntry(), humidityTemperatureCoupledMixedFvPatchScalarField::humidityTemperatureCoupledMixedFvPatchScalarField(), incompressibleInterPhaseTransportModel< Mixture >::incompressibleInterPhaseTransportModel(), oversetFvPatchField< Type >::initEvaluate(), solverInfo::initialiseResidualField(), layerParameters::layerParameters(), mappedPatchBase::mappedPatchBase(), liquidProperties::New(), waveModel::New(), objective::objective(), properties::objectResultEntries(), properties::objectResultType(), oldCyclicPolyPatch::oldCyclicPolyPatch(), oscillatingDisplacementPointPatchVectorField::oscillatingDisplacementPointPatchVectorField(), oscillatingVelocityPointPatchVectorField::oscillatingVelocityPointPatchVectorField(), PFA< CompType, ThermoType >::PFA(), Foam::preservePatchTypes(), tolerances::read(), timeControl::read(), multiphaseMangrovesTurbulenceModel::read(), fixedTemperatureConstraint::read(), volumetricBSplinesDesignVariables::readBounds(), Time::readDict(), topODesignVariables::readField(), levelSetDesignVariables::readField(), functionObjectList::readFunctionObject(), liquidProperties::readIfPresent(), refinementSurfaces::refinementSurfaces(), rigidBodyMeshMotion::rigidBodyMeshMotion(), rigidBodyMeshMotionSolver::rigidBodyMeshMotionSolver(), rigidBodyModel::rigidBodyModel(), sampledCuttingPlane::sampledCuttingPlane(), sampledCuttingSurface::sampledCuttingSurface(), sampledInterface::sampledInterface(), sampledIsoSurface::sampledIsoSurface(), sampledPlane::sampledPlane(), sampledThresholdCellFaces::sampledThresholdCellFaces(), searchableSurfaces::searchableSurfaces(), kEpsilonLopesdaCosta< BasicTurbulenceModel >::setCdSigma(), runTimeCondition::setConditionDict(), subModelBase::setModelProperty(), properties::setObjectResult(), kEpsilonLopesdaCosta< BasicTurbulenceModel >::setPorosityCoefficient(), shellSurfaces::shellSurfaces(), sixDoFRigidBodyDisplacementPointPatchVectorField::sixDoFRigidBodyDisplacementPointPatchVectorField(), sixDoFRigidBodyMotion::sixDoFRigidBodyMotion(), solidBodyMotionDisplacementPointPatchVectorField::solidBodyMotionDisplacementPointPatchVectorField(), SQPBase::SQPBase(), surfaceZonesInfo::surfaceZonesInfo(), uncoupledSixDoFRigidBodyDisplacementPointPatchVectorField::uncoupledSixDoFRigidBodyDisplacementPointPatchVectorField(), uniformInterpolatedDisplacementPointPatchVectorField::uniformInterpolatedDisplacementPointPatchVectorField(), Foam::unitSet(), inverseDistance::update(), faMeshDecomposition::updateParameters(), solverInfo::updateSolverInfo(), volumetricBSplinesDesignVariables::volumetricBSplinesDesignVariables(), Foam::warnCompatDegrees(), waveMakerPointPatchVectorField::waveMakerPointPatchVectorField(), properties::writeResultEntries(), and writer::writeSolution().
|
inline |
Search for a scoped entry (const access) with the given keyword.
Allows scoping using '.'. Special handling for an absolute anchor (^) at start of the keyword and for '..' to ascend into the parent dictionaries.
| keyword | the keyword to search for |
| matchOpt | search mode (default: non-recursive with patterns) |
Definition at line 114 of file dictionaryI.H.
Referenced by Foam::getVariable(), Foam::getVariableOrDie(), and dictionary::lookupScopedEntryPtr().
|
inline |
Find and return a sub-dictionary pointer if present (and a sub-dictionary) otherwise return nullptr.
| keyword | the keyword to search for |
| matchOpt | search mode (default: non-recursive with patterns) |
Definition at line 124 of file dictionaryI.H.
Referenced by Foam::cfindCoeffsDict(), codedFunctionObject::codeContext(), codedMixedFvPatchField< Type >::codeContext(), Foam::combineFormatOptions(), coordSetWriter::coordSetWriter(), metisDecomp::decomposeSerial(), energyTransport::energyTransport(), faMesh::faMesh(), writerCaching::fieldsDict(), Foam::fileFormats::getFormatOptions(), properties::getObjectDict(), properties::getObjectResultDict(), oversetFvPatchField< Type >::initEvaluate(), loopControl::loopControl(), namedBlock::namedBlock(), namedVertex::namedVertex(), basicChemistryModel::New(), laminarModel< BasicMomentumTransportModel >::New(), RASModelVariables::New(), decompositionMethod::optionalRegionDict(), blockVertex::read(), uniformBin::read(), SemiImplicitSource< Type >::read(), adjointRASModel::read(), PDRblock::read(), Time::readDict(), lumpedPointMovement::readDict(), mapDistribute::readDict(), functionObjectList::readFunctionObject(), reader::remapMeshInfo(), Foam::resetFuncsImpl(), Time::setMonitoring(), dictionary::subDictPtr(), surfaceWriter::surfaceWriter(), Foam::unitSet(), blockVertex::write(), blockDescriptor::write(), Foam::writeFuncsImpl(), and writer::writeSolution().
|
inline |
Find and return a sub-dictionary pointer if present (and a sub-dictionary) otherwise return nullptr.
| keyword | the keyword to search for |
| matchOpt | search mode (default: non-recursive with patterns) |
Definition at line 134 of file dictionaryI.H.
|
inline |
Find a sub-dictionary.
| keyword | the keyword to search for |
| matchOpt | search mode (default: non-recursive with patterns) |
Definition at line 144 of file dictionaryI.H.
| const Foam::entry & lookupEntry | ( | const word & | keyword, |
| enum keyType::option | matchOpt | ||
| ) | const |
Search for an entry (const access) with the given keyword.
| keyword | the keyword to search for |
| matchOpt | search mode |
Definition at line 347 of file dictionary.C.
References Foam::exit(), Foam::FatalIOError, FatalIOErrorInFunction, Foam::blockMeshTools::findEntry(), and Foam::nl.
Referenced by lduMatrix::smoother::getName(), lduMatrix::preconditioner::getName(), dictionary::lookupEntry(), lduMatrix::smoother::New(), and lduMatrix::preconditioner::New().
| Foam::ITstream & lookup | ( | const word & | keyword, |
| enum keyType::option | matchOpt = keyType::REGEX |
||
| ) | const |
Find and return an entry data stream. FatalIOError if not found, or not a stream.
| keyword | the keyword to search for |
| matchOpt | search mode (default: non-recursive with patterns) |
Definition at line 367 of file dictionary.C.
Referenced by forceList::forceList(), Foam::getLazyPair(), Foam::getRadius(), dictionary::lookup(), interpolation< Foam::vector >::New(), multivariateIndependentScheme< Type >::operator()(), dictionary::operator[](), dimensionSet::read(), shellSurfaces::shellSurfaces(), and solverInfo::updateSolverInfo().
| T get | ( | const word & | keyword, |
| enum keyType::option | matchOpt = keyType::REGEX |
||
| ) | const |
Find and return a T. FatalIOError if not found, or if the number of tokens is incorrect.
| keyword | the keyword to search for |
| matchOpt | search mode (default: non-recursive with patterns) |
Definition at line 100 of file dictionaryTemplates.C.
References Foam::T().
Referenced by abaqusMeshSet::abaqusMeshSet(), geometric::add(), fvMeshAdder::add(), columnFvMeshInfo::addLocalPatches(), betaMaxDarcy::betaMaxDarcy(), chemkinReader::chemkinReader(), CloudFunctionObjectList< KinematicCloud< Cloud< basicKinematicCollidingParcel > > >::CloudFunctionObjectList(), coalCloudList::coalCloudList(), axisAligned::computeControlPoints(), betaMax::computeLength(), filmTurbulenceModel::Cw(), cyclicAMIPolyPatch::cyclicAMIPolyPatch(), DAC< CompType, ThermoType >::DAC(), designVariablesUpdate::designVariablesUpdate(), Foam::dimensionedConstant(), directions::directions(), argList::displayDoc(), thermalShell::evolveRegion(), KirchhoffShell::evolveRegion(), FreeStream< CloudType >::FreeStream(), Foam::getLazyPair(), Foam::getRadius(), optimisationManager::initialize(), InjectionModelList< Foam::KinematicCloud< Cloud< basicKinematicCollidingParcel > > >::InjectionModelList(), ISAT< CompType, ThermoType >::ISAT(), layerParameters::layerParameters(), Foam::MULES::limiterCorr(), medialAxisMeshMover::move(), multiDirRefinement::multiDirRefinement(), blendingMethod::New(), saturationModel::New(), objectiveGeometric::New(), chemistryTabulationMethod< ReactionThermo, ThermoType >::New(), basicSolidChemistryModel::New(), laminarFlameSpeed::New(), displacementMethod::New(), phaseModel::New(), chemistryReductionMethod< ReactionThermo, ThermoType >::New(), coordinateRotation::New(), heatExchangerModel::New(), adjointTurbulenceModel::New(), ATCModel::New(), liquidProperties::New(), profileModel::New(), filmTurbulenceModel::New(), objectiveIncompressible::New(), adjointSolver::New(), cellCellStencil::New(), optimisationManager::New(), decompositionMethod::New(), shapeDesignVariables::New(), liquidFilmBase::New(), updateMethod::New(), LduMatrix< Type, DType, LUType >::solver::New(), waveModel::New(), lduMatrix::solver::New(), option::New(), NURBS3DVolume::New(), sampledSurface::New(), sampledSet::New(), LduMatrix< Type, DType, LUType >::smoother::New(), functionObject::New(), LduMatrix< Type, DType, LUType >::preconditioner::New(), objective::objective(), objectiveGeometric::objectiveGeometric(), objectiveManager::objectiveManager(), offsetSurface::offsetSurface(), Foam::operator>>(), parProfilingSolver::parProfilingSolver(), IOobject::parseHeader(), plane::plane(), solutionControl::read(), timeControl::read(), multiphaseMangrovesSource::read(), patchProbes::read(), histogramModel::read(), multiphaseMangrovesTurbulenceModel::read(), heatTransferCoeffModel::read(), singleDirectionUniformBin::read(), uniformBin::read(), sampledSurfaces::read(), dynamicRefineFvMesh::readDict(), designVariables::readDict(), Time::readDict(), shapeDesignVariables::readDict(), mapDistributeBase::readDict(), functionObjectList::readFunctionObject(), SIMPLEControlSingleRun::readIters(), SIMPLEControl::readIters(), refinementSurfaces::refinementSurfaces(), faBoundaryMeshEntries::removeProcPatches(), polyBoundaryMeshEntries::removeProcPatches(), boundaryRegion::rename(), rigidBodyModel::rigidBodyModel(), searchableSurfaceCollection::searchableSurfaceCollection(), searchableSurfaces::searchableSurfaces(), searchableSurfaceWithGaps::searchableSurfaceWithGaps(), cellBitSet::select(), kEpsilonLopesdaCosta< BasicTurbulenceModel >::setCdSigma(), kEpsilonLopesdaCosta< BasicTurbulenceModel >::setPorosityCoefficient(), twoPhaseSystem::solve(), multiphaseSystem::solve(), populationBalanceModel::solve(), MultiComponentPhaseModel< BasePhaseModel, phaseThermo >::solveYi(), surfaceZonesInfo::surfaceZonesInfo(), Switch::Switch(), Foam::unitSet(), dynamicRefineFvMesh::updateTopology(), WallLocalSpringSliderDashpot< CloudType >::WallLocalSpringSliderDashpot(), thermalBaffleFvPatchScalarField::write(), and ensightWriter::writeCollated().
| T getOrDefault | ( | const word & | keyword, |
| const T & | deflt, | ||
| enum keyType::option | matchOpt = keyType::REGEX |
||
| ) | const |
Find and return a T, or return the given default value. FatalIOError if it is found and the number of tokens is incorrect.
| keyword | the keyword to search for |
| deflt | the default value to use |
| matchOpt | search mode (default: non-recursive with patterns) |
Definition at line 141 of file dictionaryTemplates.C.
References entry::stream(), and Foam::T().
Referenced by atmBoundaryLayerInletEpsilonFvPatchScalarField::atmBoundaryLayerInletEpsilonFvPatchScalarField(), atmBoundaryLayerInletKFvPatchScalarField::atmBoundaryLayerInletKFvPatchScalarField(), atmBoundaryLayerInletOmegaFvPatchScalarField::atmBoundaryLayerInletOmegaFvPatchScalarField(), atmBoundaryLayerInletVelocityFvPatchVectorField::atmBoundaryLayerInletVelocityFvPatchVectorField(), sensitivitySurface::computeRadius(), ATCModel::createLimiter(), csvWriter::csvWriter(), cyclicAMIPolyPatch::cyclicAMIPolyPatch(), ensightSurfaceReader::ensightSurfaceReader(), faMesh::faMesh(), Switch::getOrDefault(), Foam::getVerbosity(), gnuplotWriter::gnuplotWriter(), isotropic::isotropic(), Foam::MULES::limiter(), Foam::MULES::limiterCorr(), dictionary::lookupOrDefault(), tableReader< scalar >::New(), stepUpdate::New(), zeroATCcells::New(), fvGeometryScheme::New(), betaMax::New(), regularisationPDE::New(), lineSearch::New(), Foam::operator>>(), outletMappedUniformInletFvPatchField< Type >::outletMappedUniformInletFvPatchField(), argList::parse(), rawWriter::rawWriter(), SIMPLEControlOpt::read(), solverControl::read(), adjointMeshMovementSolver::read(), solutionControl::read(), sensitivitySurface::read(), sensitivitySurfacePoints::read(), timeControl::read(), resolutionIndexModel::read(), topOSource::read(), adjointEikonalSolver::read(), singleDirectionUniformBin::read(), explicitPorositySource::read(), fieldValue::read(), uniformBin::read(), multiFieldValue::read(), functionObjectList::read(), targetCoeffTrim::read(), probes::read(), directionalPressureGradientExplicitSource::read(), sampledSets::read(), functionObject::read(), sampledSurfaces::read(), PDRblock::read(), GAMGPreconditioner::readControls(), smoothSolver::readControls(), sensitivityShapeESI::readDict(), temperatureDependent::readDict(), adjointSolver::readDict(), adjointSensitivity::readDict(), shapeDesignVariables::readDict(), externalFileCoupler::readDict(), lumpedPointMovement::readDict(), refinementSurfaces::refinementSurfaces(), searchableSurfaces::searchableSurfaces(), cellTable::selectType(), sensitivityShapeESI::sensitivityShapeESI(), Time::setMonitoring(), slidingInterface::setTolerances(), shellSurfaces::shellSurfaces(), shortestPathSet::shortestPathSet(), fvMatrix< Type >::fvSolver::solve(), faMatrix< Type >::solve(), populationBalanceModel::solve(), fvMatrix< Type >::solveCoupled(), shapeDesignVariables::solveMeshMovementEqn(), fvMatrix< Type >::solveSegregated(), fvMatrix< Type >::solveSegregatedOrCoupled(), MultiComponentPhaseModel< BasePhaseModel, phaseThermo >::solveYi(), triSurface::triSurface(), triSurfaceMesh::triSurfaceMesh(), turbulentMixingLengthDissipationRateInletFvPatchScalarField::turbulentMixingLengthDissipationRateInletFvPatchScalarField(), turbulentMixingLengthFrequencyInletFvPatchScalarField::turbulentMixingLengthFrequencyInletFvPatchScalarField(), UnsortedMeshedSurface< Face >::UnsortedMeshedSurface(), inverseDistance::update(), turbulentMixingLengthFrequencyInletFvPatchScalarField::updateCoeffs(), turbulentMixingLengthDissipationRateInletFvPatchScalarField::updateCoeffs(), dynamicRefineFvMesh::updateTopology(), vtkWriter::vtkWriter(), VTKedgeFormat::write(), ensightWriter::writeCollated(), and xmgraceWriter::xmgraceWriter().
| T getOrAdd | ( | const word & | keyword, |
| const T & | deflt, | ||
| enum keyType::option | matchOpt = keyType::REGEX |
||
| ) |
Find and return a T, or return the given default value and add it to dictionary. FatalIOError if it is found and the number of tokens is incorrect.
| keyword | the keyword to search for |
| deflt | the default value to use |
| matchOpt | search mode (default: non-recursive with patterns) |
Definition at line 171 of file dictionaryTemplates.C.
References Foam::add(), entry::stream(), and Foam::T().
Referenced by Switch::getOrAddToDict(), and dictionary::lookupOrAddDefault().
| bool readEntry | ( | const word & | keyword, |
| T & | val, | ||
| enum keyType::option | matchOpt = keyType::REGEX, |
||
| IOobjectOption::readOption | readOpt = IOobjectOption::MUST_READ |
||
| ) | const |
Find entry and assign to T val. FatalIOError if it is found and the number of tokens is incorrect, or it is mandatory and not found.
| keyword | the keyword to search for |
| val | the value to read into |
| matchOpt | search mode (default: non-recursive with patterns) |
| readOpt | the entry is required/optional (default: MUST_READ) |
Definition at line 295 of file dictionaryTemplates.C.
References Foam::exit(), Foam::FatalIOError, FatalIOErrorInFunction, IOobjectOption::isReadRequired(), Foam::name(), Foam::nl, IOobjectOption::NO_READ, and entry::stream().
Referenced by advectiveFvPatchField< Type >::advectiveFvPatchField(), BreakupModel< Foam::SprayCloud< Foam::DSMCCloud > >::BreakupModel(), cellToFace::cellToFace(), cellToFaceZone::cellToFaceZone(), cellToPoint::cellToPoint(), fromFile::computeControlPoints(), cyclicAMIPolyPatch::cyclicAMIPolyPatch(), cyclicPolyPatch::cyclicPolyPatch(), argList::displayDoc(), faceToCell::faceToCell(), faceToPoint::faceToPoint(), motionSmootherAlgo::get(), meshRefinement::get(), holeToFace::holeToFace(), humidityTemperatureCoupledMixedFvPatchScalarField::humidityTemperatureCoupledMixedFvPatchScalarField(), dynamicMultiMotionSolverFvMesh::init(), liquidFilmThermo::initLiquid(), mappedPatchBase::mappedPatchBase(), multiBandZoneAbsorptionEmission::multiBandZoneAbsorptionEmission(), nastranWriter::nastranWriter(), decompositionMethod::nDomains(), combustionModel::New(), oldCyclicPolyPatch::oldCyclicPolyPatch(), Foam::operator>>(), argList::parse(), pointToCell::pointToCell(), pointToFace::pointToFace(), exponentialRepulsion::read(), lennardJones::read(), harmonicSpring::read(), pitchForkRing::read(), restrainedHarmonicSpring::read(), dampedCoulomb::read(), sigmoid::read(), doubleSigmoid::read(), azizChen::read(), anisotropicFilter::read(), laplaceFilter::read(), maitlandSmith::read(), thermalBaffle::read(), CrossPowerLaw::read(), powerLaw::read(), HerschelBulkley::read(), Arrhenius< ViscousModel >::read(), BirdCarreau::read(), consumptionSpeed::read(), Casson::read(), limitVelocity::read(), limitHeight::read(), reactionRateFlameArea::read(), multiphaseMangrovesSource::read(), multiphaseMangrovesTurbulenceModel::read(), radialActuationDiskSource::read(), fieldValue::read(), phaseModel::read(), kinematicSingleLayer::read(), porosityModel::read(), probes::read(), sampledSets::read(), adjointRASModel::read(), sampledSurfaces::read(), Foam::readBoxDim(), thermo::readControls(), constant::readDict(), dynamicRefineFvMesh::readDict(), streamFunction::readDict(), Time::readDict(), externalFileCoupler::readDict(), mapDistributePolyMesh::readDict(), lumpedPointMovement::readDict(), mapDistributeBase::readDict(), valueAverageBase::readState(), regionProperties::regionProperties(), rigidBodyMeshMotionSolver::rigidBodyMeshMotionSolver(), sampledCuttingPlane::sampledCuttingPlane(), sampledCuttingSurface::sampledCuttingSurface(), sampledInterface::sampledInterface(), sampledIsoSurface::sampledIsoSurface(), sampledPlane::sampledPlane(), searchableSurfaceCollection::searchableSurfaceCollection(), sizeDistribution::setCellZoneCells(), reducedUnits::setRefValues(), shellSurfaces::shellSurfaces(), sixDoFRigidBodyDisplacementPointPatchVectorField::sixDoFRigidBodyDisplacementPointPatchVectorField(), sixDoFRigidBodyMotionSolver::sixDoFRigidBodyMotionSolver(), slidingInterface::slidingInterface(), surfaceFeatures::surfaceFeatures(), constantFilmThermo::Tb(), thermoCoupleProbes::thermoCoupleProbes(), viscousDissipation::viscousDissipation(), constantFilmThermo::W(), writer::writeSolution(), and zoneCombustion< ReactionThermo >::zoneCombustion().
| bool readIfPresent | ( | const word & | keyword, |
| T & | val, | ||
| enum keyType::option | matchOpt = keyType::REGEX |
||
| ) | const |
Find an entry if present, and assign to T val. FatalIOError if it is found and the number of tokens is incorrect.
| keyword | the keyword to search for |
| val | the value to read into |
| matchOpt | search mode (default: non-recursive with patterns) |
Definition at line 413 of file dictionaryTemplates.C.
References IOobjectOption::READ_IF_PRESENT.
Referenced by abaqusWriter::abaqusWriter(), advectiveFvPatchField< Type >::advectiveFvPatchField(), averageCondition::averageCondition(), boundaryDataSurfaceReader::boundaryDataSurfaceReader(), boxToCell::boxToCell(), boxToFace::boxToFace(), boxToPoint::boxToPoint(), valueAverageBase::calc(), cellToFace::cellToFace(), cellToFaceZone::cellToFaceZone(), cellToPoint::cellToPoint(), chemkinReader::chemkinReader(), cloudSolution::cloudSolution(), betaMax::computeLength(), coordSetWriter::coordSetWriter(), coupleGroupIdentifier::coupleGroupIdentifier(), cyclicAMIPolyPatch::cyclicAMIPolyPatch(), metisDecomp::decomposeSerial(), dlLibraryTable::dlLibraryTable(), Foam::extract(), faceToCell::faceToCell(), faceToPoint::faceToPoint(), faceZoneToCell::faceZoneToCell(), fvMotionSolverEngineMesh::fvMotionSolverEngineMesh(), geometricSurfacePatch::geometricSurfacePatch(), Foam::getAnimationColour(), subModelBase::getBaseProperty(), subModelBase::getModelProperty(), decomposedBlockData::getNumBlocks(), properties::getObjectProperty(), properties::getObjectResult(), Foam::getSurfaceName(), refinementParameters::getZoneInfo(), holeToFace::holeToFace(), humidityTemperatureCoupledMixedFvPatchScalarField::humidityTemperatureCoupledMixedFvPatchScalarField(), kinematicSingleLayer::info(), layeredEngineMesh::layeredEngineMesh(), layerParameters::layerParameters(), liquidFilmModel::liquidFilmModel(), lumpedPointDisplacementPointPatchVectorField::lumpedPointDisplacementPointPatchVectorField(), mappedPatchBase::mappedPatchBase(), decompositionMethod::nDomains(), liquidProperties::New(), decompositionMethod::New(), coordinateSystem::New(), nullSpace::nullSpace(), objective::objective(), objectivePartialVolume::objectivePartialVolume(), oldCyclicPolyPatch::oldCyclicPolyPatch(), dlLibraryTable::open(), IOobject::parseHeader(), patchIdentifier::patchIdentifier(), patchToCell::patchToCell(), patchToFace::patchToFace(), pointHistory::pointHistory(), pointToCell::pointToCell(), pointToFace::pointToFace(), porosityModel::porosityModel(), Foam::preservePatchTypes(), profiling::profiling(), randomDecomp::randomDecomp(), maxDeltaxyz::read(), IDDESDelta::read(), vanDriestDelta::read(), DeltaOmegaTildeDelta::read(), SLADelta::read(), pointHistory::read(), limitHeight::read(), patchProbes::read(), multiphaseMangrovesTurbulenceModel::read(), buoyancyEnergy::read(), heatTransferCoeffModel::read(), singleDirectionUniformBin::read(), fixedTemperatureConstraint::read(), explicitPorositySource::read(), surfaceNoise::read(), kinematicSingleLayer::read(), porosityModel::read(), MRFZone::read(), probes::read(), noiseModel::read(), Foam::readBoxDim(), LduMatrix< Type, DType, LUType >::solver::readControls(), lduMatrix::solver::readControls(), pointPatchFieldBase::readDict(), faPatchFieldBase::readDict(), fvPatchFieldBase::readDict(), Time::readDict(), lumpedPointMovement::readDict(), mapDistribute::readDict(), Foam::readFieldsAndWriteFluent(), decomposedBlockData::readHeader(), thermophysicalProperties::readIfPresent(), solidProperties::readIfPresent(), Switch::readIfPresent(), liquidProperties::readIfPresent(), dictionary::readIfPresent(), Foam::readWriteOption(), refinementSurfaces::refinementSurfaces(), sampledCuttingPlane::sampledCuttingPlane(), sampledCuttingSurface::sampledCuttingSurface(), sampledInterface::sampledInterface(), sampledIsoSurface::sampledIsoSurface(), sampledMeshedSurface::sampledMeshedSurface(), sampledPlane::sampledPlane(), Time::setControls(), sixDoFRigidBodyDisplacementPointPatchVectorField::sixDoFRigidBodyDisplacementPointPatchVectorField(), surfaceWriter::surfaceWriter(), surfaceZonesInfo::surfaceZonesInfo(), surfZoneIdentifier::surfZoneIdentifier(), Switch::Switch(), kinematicSingleLayer::transferPrimaryRegionSourceFields(), triSurfaceMesh::triSurfaceMesh(), triSurfaceSearch::triSurfaceSearch(), updateMethod::updateMethod(), faMeshDecomposition::updateParameters(), vanDriestDelta::vanDriestDelta(), topoSetSource::verbose(), x3dWriter::x3dWriter(), zeroATCcells::zeroATCcells(), zoneIdentifier::zoneIdentifier(), zoneToCell::zoneToCell(), zoneToFace::zoneToFace(), and zoneToPoint::zoneToPoint().
| T getCheck | ( | const word & | keyword, |
| const Predicate & | pred, | ||
| enum keyType::option | matchOpt = keyType::REGEX |
||
| ) | const |
Find and return a T with additional checking FatalIOError if not found, or if the number of tokens is incorrect.
| keyword | the keyword to search for |
| pred | the value check predicate |
| matchOpt | search mode (default: non-recursive with patterns) |
Definition at line 113 of file dictionaryTemplates.C.
References Foam::T().
Referenced by electrostaticDepositionFvPatchScalarField::electrostaticDepositionFvPatchScalarField(), singleDirectionUniformBin::read(), and electricPotential::read().
| T getCheckOrDefault | ( | const word & | keyword, |
| const T & | deflt, | ||
| const Predicate & | pred, | ||
| enum keyType::option | matchOpt = keyType::REGEX |
||
| ) | const |
Find and return a T, or return the given default value. FatalIOError if it is found and the number of tokens is incorrect.
| keyword | the keyword to search for |
| deflt | the default value to use |
| pred | the value check predicate |
| matchOpt | search mode (default: non-recursive with patterns) |
Definition at line 202 of file dictionaryTemplates.C.
References Foam::exit(), Foam::FatalIOError, FatalIOErrorInFunction, Foam::name(), entry::stream(), and Foam::T().
| T getCheckOrAdd | ( | const word & | keyword, |
| const T & | deflt, | ||
| const Predicate & | pred, | ||
| enum keyType::option | matchOpt = keyType::REGEX |
||
| ) |
Find and return a T, or return the given default value and add it to dictionary. FatalIOError if it is found and the number of tokens is incorrect.
| keyword | the keyword to search for |
| deflt | the default value to use |
| pred | the value check predicate |
| matchOpt | search mode (default: non-recursive with patterns) |
Definition at line 248 of file dictionaryTemplates.C.
References Foam::add(), Foam::exit(), Foam::FatalIOError, FatalIOErrorInFunction, Foam::name(), entry::stream(), and Foam::T().
| bool readCheck | ( | const word & | keyword, |
| T & | val, | ||
| const Predicate & | pred, | ||
| enum keyType::option | matchOpt = keyType::REGEX, |
||
| IOobjectOption::readOption | readOpt = IOobjectOption::MUST_READ |
||
| ) | const |
Find entry and assign to T val. FatalIOError if it is found and the number of tokens is incorrect, or it is mandatory and not found.
| keyword | the keyword to search for |
| val | the value to read into |
| pred | the value check predicate |
| matchOpt | search mode (default: non-recursive with patterns) |
| readOpt | the entry is required/optional (default: MUST_READ) |
Definition at line 332 of file dictionaryTemplates.C.
References Foam::exit(), Foam::FatalIOError, FatalIOErrorInFunction, IOobjectOption::isReadRequired(), Foam::name(), Foam::nl, IOobjectOption::NO_READ, and entry::stream().
| bool readCheckIfPresent | ( | const word & | keyword, |
| T & | val, | ||
| const Predicate & | pred, | ||
| enum keyType::option | matchOpt = keyType::REGEX |
||
| ) | const |
Find an entry if present, and assign to T val. FatalIOError if it is found and the number of tokens is incorrect.
| keyword | the keyword to search for |
| val | the value to read into |
| pred | the value check predicate |
| matchOpt | search mode (default: non-recursive with patterns) |
Definition at line 432 of file dictionaryTemplates.C.
References IOobjectOption::READ_IF_PRESENT.
| const Foam::dictionary & subDict | ( | const word & | keyword, |
| enum keyType::option | matchOpt = keyType::REGEX |
||
| ) | const |
Find and return a sub-dictionary.
Fatal if the entry does not exist or is not a sub-dictionary.
| keyword | the keyword to search for |
| matchOpt | search mode (default: non-recursive with patterns) |
Definition at line 441 of file dictionary.C.
References dictionary::Searcher< Const >::dict(), Foam::exit(), Foam::FatalIOError, FatalIOErrorInFunction, dictionary::Searcher< Const >::good(), and Foam::nl.
Referenced by sixDoFRigidBodyMotion::addConstraints(), snappyLayerDriver::addLayers(), sixDoFRigidBodyMotion::addRestraints(), adjointSimple::adjointSimple(), adjointSolverManager::adjointSolverManager(), coordinateSystem::coordinateSystem(), DAC< CompType, ThermoType >::DAC(), adjointSolver::designVarsDict(), Foam::dimensionedConstant(), directions::directions(), argList::displayDoc(), DRG< CompType, ThermoType >::DRG(), DRGEP< CompType, ThermoType >::DRGEP(), faMesh::faMesh(), subModelBase::getBaseProperty(), subModelBase::getModelDict(), subModelBase::getModelProperty(), properties::getObjectResult(), refinementParameters::getZoneInfo(), properties::hasResultObjectEntry(), humidityTemperatureCoupledMixedFvPatchScalarField::humidityTemperatureCoupledMixedFvPatchScalarField(), dynamicMultiMotionSolverFvMesh::init(), oversetFvPatchField< Type >::initEvaluate(), optimisationManager::initialize(), cloudSolution::integrationSchemes(), cloudSolution::interpolationSchemes(), multiBandZoneAbsorptionEmission::multiBandZoneAbsorptionEmission(), adjointSolverManager::nActiveAdjointSolvers(), basicSolidChemistryModel::New(), phaseModel::New(), LESModel< BasicTurbulenceModel >::New(), RASModel< EddyDiffusivity< phaseCompressibleTurbulenceModel > >::New(), waveModel::New(), objectiveManager::objectiveManager(), properties::objectResultEntries(), properties::objectResultType(), PFA< CompType, ThermoType >::PFA(), Foam::preservePatchTypes(), pyrolysisModelCollection::pyrolysisModelCollection(), lennardJones::read(), harmonicSpring::read(), pitchForkRing::read(), restrainedHarmonicSpring::read(), tolerances::read(), dampedCoulomb::read(), sigmoid::read(), doubleSigmoid::read(), porosityModelList::read(), runTimeControl::read(), multiphaseMangrovesSource::read(), FixedValueConstraint< Type >::read(), multiphaseMangrovesTurbulenceModel::read(), adjointEikonalSolver::read(), optimisationManager::read(), MRFZoneList::read(), kinematicSingleLayer::read(), PDRblock::read(), thermo::readControls(), sensitivityMultiple::readDict(), adjointSolverManager::readDict(), adjointSolver::readDict(), mapDistributePolyMesh::readDict(), lumpedPointMovement::readDict(), mapDistributeBase::readDict(), levelSetDesignVariables::readField(), liquidProperties::readIfPresent(), refinementSurfaces::refinementSurfaces(), rigidBodyMeshMotion::rigidBodyMeshMotion(), rigidBodyMeshMotionSolver::rigidBodyMeshMotionSolver(), rigidBodyModel::rigidBodyModel(), searchableSurfaces::searchableSurfaces(), subModelBase::setBaseProperty(), runTimeCondition::setConditionDict(), subModelBase::setModelProperty(), properties::setObjectResult(), shellSurfaces::shellSurfaces(), solverControl::solutionDict(), cloudSolution::sourceTermDict(), steadyOptimisation::steadyOptimisation(), inverseDistance::update(), volBSplinesBase::volBSplinesBase(), thermalBaffleFvPatchScalarField::write(), and properties::writeResultEntries().
| Foam::dictionary & subDict | ( | const word & | keyword, |
| enum keyType::option | matchOpt = keyType::REGEX |
||
| ) |
Find and return a sub-dictionary for manipulation.
Fatal if the entry does not exist or is not a sub-dictionary.
| keyword | the keyword to search for |
| matchOpt | search mode (default: non-recursive with patterns) |
Definition at line 461 of file dictionary.C.
References dictionary::Searcher< Const >::dict(), Foam::exit(), Foam::FatalIOError, FatalIOErrorInFunction, dictionary::Searcher< Const >::good(), Foam::nl, and Foam::search().
| Foam::dictionary & subDictOrAdd | ( | const word & | keyword, |
| enum keyType::option | matchOpt = keyType::REGEX |
||
| ) |
Find and return a sub-dictionary for manipulation.
Fatal if the entry exist and is not a sub-dictionary.
| keyword | the keyword to search for |
| matchOpt | search mode (default: non-recursive with patterns) |
Definition at line 481 of file dictionary.C.
References dictionary::Searcher< Const >::dictPtr(), Foam::exit(), Foam::FatalIOError, FatalIOErrorInFunction, dictionary::Searcher< Const >::good(), Foam::nl, and Foam::search().
Referenced by sensitivitySurface::smoothSensitivities(), caseInfo::write(), mappedPatchBase::writeDict(), caseInfo::writeFileDicts(), and caseInfo::writeRegisteredDicts().
| Foam::dictionary subOrEmptyDict | ( | const word & | keyword, |
| enum keyType::option | matchOpt = keyType::REGEX, |
||
| const bool | mandatory = false |
||
| ) | const |
Find and return a sub-dictionary as a copy, otherwise return an empty dictionary.
Warn if the entry exists but is not a sub-dictionary.
| keyword | the keyword to search for |
| matchOpt | search mode (default: non-recursive with patterns) |
| mandatory | the keyword is mandatory (default: false) |
Definition at line 521 of file dictionary.C.
References dictionary::Searcher< Const >::dictPtr(), Foam::endl(), Foam::exit(), Foam::FatalIOError, FatalIOErrorInFunction, dictionary::Searcher< Const >::good(), IOWarningInFunction, and Foam::nl.
Referenced by blockDescriptor::blockDescriptor(), cloudSolution::cloudSolution(), coordSetWriter::coordSetWriter(), designVariablesUpdate::designVariablesUpdate(), solutionControl::dict(), subModelBase::getModelDict(), solverControl::read(), noiseModel::read(), adjointMeshMovementSolver::readDict(), lumpedPointMovement::readDict(), shapeDesignVariables::solveMeshMovementEqn(), and surfaceWriter::surfaceWriter().
| const Foam::dictionary & optionalSubDict | ( | const word & | keyword, |
| enum keyType::option | matchOpt = keyType::REGEX |
||
| ) | const |
Find and return a sub-dictionary, otherwise return this dictionary.
Warn if the entry exists but is not a sub-dictionary.
| keyword | the keyword to search for |
| matchOpt | search mode (default: non-recursive with patterns) |
Definition at line 560 of file dictionary.C.
References dictionary::Searcher< Const >::dictPtr(), Foam::endl(), dictionary::Searcher< Const >::good(), and IOWarningInFunction.
Referenced by geometric::add(), stepUpdate::coeffsDict(), lineSearch::coeffsDict(), updateMethod::coeffsDict(), sensitivity::dict(), liquidFilmThermo::initLiquid(), liquidProperties::New(), adjointSensitivity::New(), sampledSet::New(), anisotropicFilter::read(), laplaceFilter::read(), strainRateFunction::read(), CrossPowerLaw::read(), HerschelBulkley::read(), powerLaw::read(), diameterModel::read(), Arrhenius< ViscousModel >::read(), BirdCarreau::read(), Casson::read(), motionSolver::read(), porosityModel::read(), dynamicRefineFvMesh::readDict(), and cellBitSet::select().
| Foam::wordList toc | ( | ) | const |
Return the table of contents.
Definition at line 587 of file dictionary.C.
References Foam::constant::electromagnetic::e, and n.
Referenced by adjointSolverManager::adjointSolverManager(), DAC< CompType, ThermoType >::DAC(), removeEntry::execute(), FreeStream< CloudType >::FreeStream(), optimisationManager::initialize(), adjointSolverManager::nActiveAdjointSolvers(), Foam::operator>>(), pyrolysisModelCollection::pyrolysisModelCollection(), runTimeControl::read(), refinementSurfaces::refinementSurfaces(), and shellSurfaces::shellSurfaces().
| Foam::wordList sortedToc | ( | ) | const |
Return the sorted table of contents.
Definition at line 601 of file dictionary.C.
Referenced by properties::objectNames(), solverFieldSelection::updateSelection(), caseInfo::write(), properties::writeAllResultEntries(), and properties::writeResultEntries().
| wordList sortedToc | ( | const Compare & | comp | ) | const |
Return table of contents sorted using the specified comparator.
| Foam::List< Foam::keyType > keys | ( | bool | patterns = false | ) | const |
Return the list of available keys or patterns.
Definition at line 607 of file dictionary.C.
References Foam::constant::electromagnetic::e, n, and List< T >::resize().
| bool substituteKeyword | ( | const word & | keyword, |
| bool | mergeEntry = false |
||
| ) |
Substitute the given keyword (which is prefixed by '$')
with the corresponding sub-dictionary entries
Definition at line 377 of file dictionary.C.
References Foam::add(), Foam::constant::electromagnetic::e, and keyType::REGEX_RECURSIVE.
| bool substituteScopedKeyword | ( | const word & | keyword, |
| bool | mergeEntry = false |
||
| ) |
Substitute the given scoped keyword (which is prefixed by '$')
with the corresponding sub-dictionary entries
Definition at line 409 of file dictionary.C.
References Foam::add(), Foam::constant::electromagnetic::e, and keyType::REGEX_RECURSIVE.
Referenced by entry::New().
| Foam::entry * add | ( | entry * | entryPtr, |
| bool | mergeEntry = false |
||
| ) |
Add a new entry.
| entryPtr | the entry to add |
| mergeEntry | dictionaries are interwoven and primitive entries are overwritten (default: false) |
Definition at line 625 of file dictionary.C.
References fileName::concat(), entry::dict(), Foam::endl(), IOWarningInFunction, entry::isDict(), keyType::isPattern(), entry::keyword(), dictionary::merge(), Foam::name(), and entry::name().
Referenced by Foam::addPatchTypeDetails(), adjointSimple::addTopOFvOptions(), adjointSolverManager::adjointSolverManager(), Foam::copyFilteredDict(), fvMeshTools::createDummyFvMeshFiles(), faPatchData::dict(), Foam::dimensionedConstant(), Foam::getOrAdd(), refinementParameters::getZoneInfo(), optimisationManager::initialize(), voxelMeshSearch::makeMesh(), dictionary::makeScopedDict(), namedBlock::namedBlock(), namedVertex::namedVertex(), entry::New(), cellTable::operator=(), argList::parse(), Foam::preservePatchTypes(), multiRegion::read(), functionObjectList::readFunctionObject(), subModelBase::setBaseProperty(), runTimeCondition::setConditionDict(), subModelBase::setModelProperty(), properties::setObjectProperty(), properties::setObjectResult(), sensitivitySurface::smoothSensitivities(), sixDoFRigidBodyMotionSolver::solve(), rigidBodyMeshMotionSolver::solve(), rigidBodyMeshMotion::solve(), kinematicSingleLayer::transferPrimaryRegionSourceFields(), sixDoFRigidBodyDisplacementPointPatchVectorField::updateCoeffs(), solution::upgradeSolverDict(), thermoCoupleProbes::write(), surfaceFeatures::writeDict(), mappedPatchBase::writeDict(), decomposedBlockData::writeExtraHeaderContent(), caseInfo::writeFunctionObjects(), IOobject::writeHeaderContent(), caseInfo::writeMeta(), caseInfo::writePatches(), valueAverageBase::writeState(), abaqusWriter::writeTemplate(), and Time::writeTimeDict().
| Foam::entry * add | ( | const entry & | e, |
| bool | mergeEntry = false |
||
| ) |
Add an entry.
| e | the entry to add |
| mergeEntry | dictionaries are interwoven and primitive entries are overwritten (default: false) |
Definition at line 704 of file dictionary.C.
References Foam::add(), and Foam::constant::electromagnetic::e.
| Foam::entry * add | ( | const keyType & | k, |
| const word & | v, | ||
| bool | overwrite = false |
||
| ) |
Add a word entry.
| overwrite | force overwrite of an existing entry. |
Definition at line 711 of file dictionary.C.
References Foam::add(), and k.
| Foam::entry * add | ( | const keyType & | k, |
| const string & | v, | ||
| bool | overwrite = false |
||
| ) |
Add a string entry.
| overwrite | force overwrite of an existing entry. |
Definition at line 722 of file dictionary.C.
References Foam::add(), and k.
| Foam::entry * add | ( | const keyType & | k, |
| const label | v, | ||
| bool | overwrite = false |
||
| ) |
Add a label entry.
| overwrite | force overwrite of an existing entry. |
Definition at line 733 of file dictionary.C.
References Foam::add(), and k.
| Foam::entry * add | ( | const keyType & | k, |
| const scalar | v, | ||
| bool | overwrite = false |
||
| ) |
Add a scalar entry.
| overwrite | force overwrite of an existing entry. |
Definition at line 744 of file dictionary.C.
References Foam::add(), and k.
| Foam::entry * add | ( | const keyType & | k, |
| const dictionary & | d, | ||
| bool | mergeEntry = false |
||
| ) |
Add a dictionary entry.
| mergeEntry | merge into an existing sub-dictionary |
Definition at line 755 of file dictionary.C.
References Foam::add(), and k.
Add a T entry.
| overwrite | force overwrite of existing entry |
| Foam::entry * set | ( | entry * | entryPtr | ) |
Assign a new entry, overwriting any existing entry.
Definition at line 765 of file dictionary.C.
References Foam::add(), dictionary::clear(), dictionary::Searcher< Const >::dictPtr(), entry::keyword(), keyType::REGEX, and Foam::search().
Referenced by columnFvMeshInfo::addLocalPatches(), meshRefinement::addPatch(), sixDoFRigidBodyMotion::addRestraints(), valueAverageBase::calc(), extrudePatchMesh::extrudePatchMesh(), dynamicMotionSolverListFvMesh::init(), faMeshTools::newMesh(), fvMeshTools::newMesh(), runTimeControl::read(), multiFieldValue::read(), functionObjectList::readFunctionObject(), codedFunctionObject::redirectFunctionObject(), codedPoints0MotionSolver::redirectMotionSolver(), CodedSource< Type >::redirectOption(), refinementSurfaces::refinementSurfaces(), boundaryRegion::rename(), ZoneMesh< cellZone, polyMesh >::updateMetaData(), solution::upgradeSolverDict(), averageCondition::write(), decomposedBlockData::writeExtraHeaderContent(), IOobject::writeHeaderContent(), and mappedPatchBase::writeIOField().
| Foam::entry * set | ( | const entry & | e | ) |
Assign a new entry, overwriting any existing entry.
Definition at line 787 of file dictionary.C.
References Foam::constant::electromagnetic::e.
| Foam::entry * set | ( | const keyType & | k, |
| const dictionary & | v | ||
| ) |
Assign a dictionary entry, overwriting any existing entry.
Definition at line 793 of file dictionary.C.
References k.
Assign a T entry, overwriting any existing entry.
| bool remove | ( | const word & | keyword | ) |
Remove an entry specified by keyword.
Definition at line 577 of file dictionarySearch.C.
Referenced by removeEntry::execute(), and caseInfo::writeRegisteredDicts().
| bool changeKeyword | ( | const keyType & | oldKeyword, |
| const keyType & | newKeyword, | ||
| bool | overwrite = false |
||
| ) |
Change the keyword for an entry,.
| overwrite | force overwrite of an existing entry. |
Definition at line 606 of file dictionarySearch.C.
References fileName::concat(), Foam::endl(), Foam::exit(), Foam::FatalIOError, FatalIOErrorInFunction, IOWarningInFunction, keyType::isPattern(), Foam::name(), and Foam::nl.
Referenced by CodedSource< Type >::redirectOption().
| bool merge | ( | const dictionary & | dict | ) |
Merge entries from the given dictionary.
Also merge sub-dictionaries as required.
Definition at line 799 of file dictionary.C.
References Foam::abort(), Foam::add(), dict, Foam::constant::electromagnetic::e, Foam::FatalIOError, FatalIOErrorInFunction, and Foam::nl.
Referenced by dictionary::add(), snappyLayerDriver::addLayers(), Foam::combineFormatOptions(), Time::readDict(), and functionObjectList::readFunctionObject().
| void clear | ( | ) |
Clear the dictionary.
Definition at line 844 of file dictionary.C.
References clear().
Referenced by Foam::operator>>(), strainRateFunction::read(), and dictionary::set().
| void transfer | ( | dictionary & | dict | ) |
Transfer the contents of the argument and annul the argument.
Definition at line 853 of file dictionary.C.
References dict, Foam::name(), and dictionary::name().
Check after reading if the input token stream has unconsumed tokens remaining or if there were no tokens in the first place.
Emits FatalIOError
Definition at line 251 of file dictionary.C.
References JobInfo::constructed, Foam::endl(), Foam::exit(), Foam::FatalIOError, IOstream::lineNumber(), Foam::nl, ITstream::nRemainingTokens(), UList< T >::size(), and UList< T >::writeList().
| bool read | ( | Istream & | is | ) |
Read dictionary from Istream (discards the header). Reads entries until EOF or when the first token is a '{' character, it will stop reading at the matching '}' character.
Definition at line 134 of file dictionaryIO.C.
References Foam::read().
Referenced by atmAmbientTurbSource::atmAmbientTurbSource(), atmBuoyancyTurbSource::atmBuoyancyTurbSource(), atmLengthScaleTurbSource::atmLengthScaleTurbSource(), atmPlantCanopyTurbSource::atmPlantCanopyTurbSource(), dictionary::dictionary(), includeEtcEntry::execute(), includeEntry::execute(), calcEntry::execute(), codeStream::execute(), Foam::operator>>(), PrandtlDelta::read(), smoothDelta::read(), PDRblock::read(), and IOobject::readHeader().
| bool read | ( | Istream & | is, |
| bool | keepHeader | ||
| ) |
Read dictionary from Istream (optionally keeping the header) Reads entries until EOF or when the first token is a '{' character, it will stop reading at the matching '}' character.
Definition at line 70 of file dictionaryIO.C.
References IOstream::bad(), token::BEGIN_BLOCK, token::END_BLOCK, Foam::endl(), IOstream::eof(), Foam::exit(), Foam::FatalIOError, FatalIOErrorInFunction, entry::GLOBAL, IOstream::good(), InfoInFunction, Foam::name(), entry::New(), Foam::nl, and Istream::putBack().
| void writeEntry | ( | Ostream & | os | ) | const |
Write sub-dictionary with its dictName as its header.
Definition at line 157 of file dictionaryIO.C.
References Ostream::beginBlock(), dictName(), Ostream::endBlock(), and os().
Referenced by Foam::operator<<(), dictionaryEntry::write(), thermalBaffleFvPatchScalarField::write(), faBoundaryMeshEntries::writeEntries(), polyBoundaryMeshEntries::writeEntries(), Foam::writeEntryIfPresent(), decomposedBlockData::writeHeader(), and IOobject::writeHeaderContent().
Write sub-dictionary with the keyword as its header.
Definition at line 165 of file dictionaryIO.C.
References Ostream::beginBlock(), Ostream::endBlock(), and os().
| void writeEntries | ( | Ostream & | os, |
| const bool | extraNewLine = false |
||
| ) | const |
Write dictionary entries.
| extraNewLine | adds additional newline between entries for "top-level" dictionaries |
Definition at line 173 of file dictionaryIO.C.
References Foam::constant::electromagnetic::e, Foam::endl(), IOstream::good(), Foam::name(), Foam::nl, dictionary::null, os(), and WarningInFunction.
Referenced by decomposedBlockData::writeHeader(), and Foam::writeJobDict().
| void write | ( | Ostream & | os, |
| const bool | subDict = true |
||
| ) | const |
Write dictionary, normally with sub-dictionary formatting.
Definition at line 204 of file dictionaryIO.C.
References Ostream::beginBlock(), Ostream::endBlock(), Foam::nl, and os().
Referenced by Foam::entryToString(), Foam::operator<<(), dictionaryListEntry::write(), vibrationShellFvPatchScalarField::write(), thermalShellFvPatchScalarField::write(), velocityFilmShellFvPatchVectorField::write(), fieldDictionary::writeData(), baseIOdictionary::writeData(), and surfaceFeatures::writeDict().
| Foam::dictionary::const_searcher csearch | ( | const word & | keyword, |
| enum keyType::option | matchOpt = keyType::REGEX |
||
| ) | const |
Search dictionary for given keyword.
| keyword | the keyword to search for |
| matchOpt | search mode (default: non-recursive with patterns) |
Definition at line 258 of file dictionarySearch.C.
References dictionary::null, keyType::RECURSIVE, keyType::REGEX, and dictionary::Searcher< Const >::set().
Referenced by meshRefinement::subDict().
| Foam::dictionary::const_searcher search | ( | const word & | keyword, |
| enum keyType::option | matchOpt = keyType::REGEX |
||
| ) | const |
Search dictionary for given keyword.
| keyword | the keyword to search for |
| matchOpt | search mode (default: non-recursive with patterns) |
Definition at line 296 of file dictionarySearch.C.
Referenced by entry::New().
| Foam::dictionary::searcher search | ( | const word & | keyword, |
| enum keyType::option | matchOpt = keyType::REGEX |
||
| ) |
Search dictionary for given keyword.
| keyword | the keyword to search for |
| matchOpt | search mode (default: non-recursive with patterns) |
Definition at line 306 of file dictionarySearch.C.
| Foam::dictionary::const_searcher csearchScoped | ( | const word & | keyword, |
| enum keyType::option | matchOpt | ||
| ) | const |
Search using scoping.
There are two types of scoping available:
For dot-scoping, a leading '^' traverses to the top-level dictionary, leading dots mean use the parent dictionary and an intermediate dot separates a sub-dictionary or sub-entry. However, since the use of dots is ambiguous ("a.b.c" could be an entry itself or represent a "bc" entry from dictionary "a" etc), the heuristic backtracks and attempts successively longer top-level entries until a suitable match is found.
For slash-scoping, semantics similar to directory structures are used. A leading '/' traverses to the top-level dictionary, a single leading or intermediate '.' references the current dictionary level. A '..' pair references the parent dictionary. Any doubled slashes are silently ignored. Since a slash is not a valid keyword character, there is no ambiguity between separator and content.
| keyword | the keyword to search for |
| matchOpt | search mode |
Definition at line 318 of file dictionarySearch.C.
References string::contains(), dictionary::null, and keyType::RECURSIVE.
Referenced by entry::New().
| Foam::dictionary::const_searcher searchScoped | ( | const word & | keyword, |
| enum keyType::option | matchOpt | ||
| ) | const |
Search using dot or slash scoping.
| keyword | the keyword to search for |
| matchOpt | search mode |
Definition at line 348 of file dictionarySearch.C.
Referenced by removeEntry::execute(), and entry::New().
| Foam::dictionary::searcher searchScoped | ( | const word & | keyword, |
| enum keyType::option | matchOpt | ||
| ) |
Search using dot or slash scoping.
| keyword | the keyword to search for |
| matchOpt | search mode |
Definition at line 358 of file dictionarySearch.C.
| const Foam::dictionary * cfindScopedDict | ( | const fileName & | dictPath | ) | const |
Locate a sub-dictionary using slash-scoping.
Definition at line 370 of file dictionarySearch.C.
References fileName::clean(), entry::dictPtr(), Foam::exit(), Foam::FatalIOError, FatalIOErrorInFunction, entry::isDict(), Foam::nl, dictionary::null, path(), and Foam::stringOps::split().
| const Foam::dictionary * findScopedDict | ( | const fileName & | dictPath | ) | const |
Locate a sub-dictionary using slash-scoping.
Definition at line 459 of file dictionarySearch.C.
| Foam::dictionary * findScopedDict | ( | const fileName & | dictPath | ) |
Locate a sub-dictionary using slash-scoping.
Definition at line 468 of file dictionarySearch.C.
| Foam::dictionary * makeScopedDict | ( | const fileName & | dictPath | ) |
Locate existing or create sub-dictionary using slash-scoping.
Definition at line 477 of file dictionarySearch.C.
References dictionary::add(), fileName::clean(), entry::dictPtr(), Foam::exit(), Foam::FatalIOError, FatalIOErrorInFunction, entry::isDict(), Foam::nl, dictionary::null, path(), and Foam::stringOps::split().
Referenced by entry::New().
| Foam::dictionary::const_searcher csearchCompat | ( | const word & | keyword, |
| std::initializer_list< std::pair< const char *, int >> | compat, | ||
| enum keyType::option | matchOpt = keyType::REGEX |
||
| ) | const |
Search dictionary for given keyword and any compatibility names.
| keyword | the keyword to search for |
| compat | list of old compatibility keywords and the last OpenFOAM version for which they were used. Old version 1600=OpenFOAM-v3.0, 240=OpenFOAM-2.4.x, 170=OpenFOAM-1.7.x,... |
| matchOpt | search mode (default: non-recursive with patterns) |
Definition at line 27 of file dictionaryCompat.C.
References Foam::endl(), dictionary::Searcher< Const >::good(), Foam::nl, and Foam::stringOps::validate().
Referenced by functionObject::New().
| const Foam::entry * findCompat | ( | const word & | keyword, |
| std::initializer_list< std::pair< const char *, int >> | compat, | ||
| enum keyType::option | matchOpt | ||
| ) | const |
Find and return an entry pointer if present, or return a nullptr, using any compatibility names if needed.
| keyword | the keyword to search for |
| compat | list of old compatibility keywords and the last OpenFOAM version for which they were used. |
| matchOpt | search mode |
Definition at line 68 of file dictionaryCompat.C.
| bool foundCompat | ( | const word & | keyword, |
| std::initializer_list< std::pair< const char *, int >> | compat, | ||
| enum keyType::option | matchOpt = keyType::REGEX |
||
| ) | const |
Search dictionary for given keyword and any compatibility names.
| keyword | the keyword to search for |
| compat | list of old compatibility keywords and the last OpenFOAM version for which they were used. |
| matchOpt | search mode (default: non-recursive with patterns) |
Definition at line 79 of file dictionaryCompat.C.
| const Foam::entry & lookupEntryCompat | ( | const word & | keyword, |
| std::initializer_list< std::pair< const char *, int >> | compat, | ||
| enum keyType::option | matchOpt | ||
| ) | const |
Find and return an entry if present, otherwise FatalIOError, using any compatibility names if needed.
| keyword | the keyword to search for |
| compat | list of old compatibility keywords and the last OpenFOAM version for which they were used. |
| matchOpt | search mode |
Definition at line 90 of file dictionaryCompat.C.
References Foam::exit(), Foam::FatalIOError, and FatalIOErrorInFunction.
| Foam::ITstream & lookupCompat | ( | const word & | keyword, |
| std::initializer_list< std::pair< const char *, int >> | compat, | ||
| enum keyType::option | matchOpt = keyType::REGEX |
||
| ) | const |
Find and return an entry data stream, using any compatibility names if needed.
| keyword | the keyword to search for |
| compat | list of old compatibility keywords and the last OpenFOAM version for which they were used. |
| matchOpt | search mode (default: non-recursive with patterns) |
Definition at line 111 of file dictionaryCompat.C.
| T getCompat | ( | const word & | keyword, |
| std::initializer_list< std::pair< const char *, int >> | compat, | ||
| enum keyType::option | matchOpt = keyType::REGEX |
||
| ) | const |
Find and return a T using any compatibility names if needed. FatalIOError if not found, or if there are excess tokens.
| keyword | the keyword to search for |
| compat | list of old compatibility keywords and the last OpenFOAM version for which they were used. |
| matchOpt | search mode (default: non-recursive with patterns) |
Definition at line 127 of file dictionaryTemplates.C.
References Foam::T().
Referenced by faceZoneToCell::faceZoneToCell(), basicChemistryModel::New(), motionSolver::New(), patchToCell::patchToCell(), patchToFace::patchToFace(), plane::plane(), zoneToCell::zoneToCell(), zoneToFace::zoneToFace(), and zoneToPoint::zoneToPoint().
| T getOrDefaultCompat | ( | const word & | keyword, |
| std::initializer_list< std::pair< const char *, int >> | compat, | ||
| const T & | deflt, | ||
| enum keyType::option | matchOpt = keyType::REGEX |
||
| ) | const |
Find and return a T, or return the given default value using any compatibility names if needed.
| keyword | the keyword to search for |
| compat | list of old compatibility keywords and the last OpenFOAM version for which they were used. |
| deflt | the default value to use |
| matchOpt | search mode (default: non-recursive with patterns) |
Definition at line 453 of file dictionaryTemplates.C.
References entry::stream(), and Foam::T().
Referenced by sigmoidalHeaviside::computeNearBandWidth(), and Foam::getSurfaceName().
| bool readCompat | ( | const word & | keyword, |
| std::initializer_list< std::pair< const char *, int >> | compat, | ||
| T & | val, | ||
| enum keyType::option | matchOpt = keyType::REGEX, |
||
| IOobjectOption::readOption | readOpt = IOobjectOption::MUST_READ |
||
| ) | const |
Find entry and assign to T val using any compatibility names if needed. FatalIOError if there are excess tokens.
| keyword | the keyword to search for |
| compat | list of old compatibility keywords and the last OpenFOAM version for which they were used. |
| val | the value to read |
| matchOpt | search mode (default: non-recursive with patterns) |
| readOpt | the entry is required/optional (default: MUST_READ) |
Definition at line 375 of file dictionaryTemplates.C.
References Foam::exit(), Foam::FatalIOError, FatalIOErrorInFunction, IOobjectOption::isReadRequired(), Foam::name(), Foam::nl, IOobjectOption::NO_READ, and entry::stream().
Referenced by RASModelVariables::New().
| bool readIfPresentCompat | ( | const word & | keyword, |
| std::initializer_list< std::pair< const char *, int >> | compat, | ||
| T & | val, | ||
| enum keyType::option | matchOpt = keyType::REGEX |
||
| ) | const |
Find an entry if present, and assign to T val using any compatibility names if needed. FatalIOError if it is found and there are excess tokens.
| keyword | the keyword to search for |
| compat | list of old compatibility keywords and the last OpenFOAM version for which they were used. |
| val | the value to read |
| matchOpt | search mode (default: non-recursive with patterns) |
Definition at line 484 of file dictionaryTemplates.C.
References IOobjectOption::READ_IF_PRESENT.
Referenced by noiseModel::read(), and solidProperties::readIfPresent().
| void operator= | ( | const dictionary & | rhs | ) |
Copy assignment.
Definition at line 868 of file dictionary.C.
References Foam::add(), clear(), Foam::constant::electromagnetic::e, Foam::name(), and dictionary::name().
Referenced by dictionary::dictionary(), baseIOdictionary::operator=(), and meshState::reset().
| void operator+= | ( | const dictionary & | rhs | ) |
Include entries from the given dictionary.
Warn, but do not overwrite existing entries.
Definition at line 888 of file dictionary.C.
References Foam::abort(), Foam::add(), Foam::constant::electromagnetic::e, Foam::FatalIOError, FatalIOErrorInFunction, and Foam::nl.
| void operator|= | ( | const dictionary & | rhs | ) |
Conditionally include entries from the given dictionary.
Do not overwrite existing entries.
Definition at line 905 of file dictionary.C.
References Foam::abort(), Foam::add(), Foam::constant::electromagnetic::e, Foam::FatalIOError, FatalIOErrorInFunction, found, and Foam::nl.
| void operator<<= | ( | const dictionary & | rhs | ) |
Unconditionally include entries from the given dictionary.
Overwrite existing entries.
Definition at line 925 of file dictionary.C.
References Foam::abort(), Foam::constant::electromagnetic::e, Foam::FatalIOError, FatalIOErrorInFunction, and Foam::nl.
|
inline |
Same as get< bool >(const word&, keyType::option)
Definition at line 1663 of file dictionary.H.
|
inline |
Same as get< label >(const word&, keyType::option)
Definition at line 1664 of file dictionary.H.
|
inline |
Same as get< scalar >(const word&, keyType::option)
Definition at line 1665 of file dictionary.H.
Referenced by propellerInfo::setSampleDiskSurface().
|
inline |
Same as get< string >(const word&, keyType::option)
Definition at line 1666 of file dictionary.H.
|
inline |
Same as get< word >(const word&, keyType::option)
Definition at line 1667 of file dictionary.H.
Referenced by incompressibleInterPhaseTransportModel< Mixture >::incompressibleInterPhaseTransportModel().
|
inline |
Same as get< fileName >(const word&, keyType::option)
Definition at line 1668 of file dictionary.H.
|
inline |
Same as getOrDefault()
Definition at line 1681 of file dictionary.H.
|
inline |
Same as getOrAdd()
Definition at line 1697 of file dictionary.H.
Deprecated(2018-07) - use lookup() method.
Definition at line 1712 of file dictionary.H.
References dictionary::lookup().
|
inline |
Deprecated(2018-10)
Definition at line 1724 of file dictionary.H.
References dictionary::found().
Deprecated(2018-10)
Definition at line 1740 of file dictionary.H.
References dictionary::findEntry().
|
inline |
Deprecated(2018-10)
Definition at line 1756 of file dictionary.H.
References dictionary::findEntry().
|
inline |
Deprecated(2018-10)
Definition at line 1772 of file dictionary.H.
References dictionary::findScoped().
|
inline |
Deprecated(2018-10)
Find and return a sub-dictionary pointer if present (and a sub-dictionary) otherwise return nullptr.
Search type: non-recursive with patterns.
Definition at line 1791 of file dictionary.H.
References dictionary::findDict(), and keyType::REGEX.
|
inline |
Deprecated(2018-10) Find and return a sub-dictionary pointer if present.
(and a sub-dictionary) otherwise return nullptr.
Search type: non-recursive with patterns.
Definition at line 1806 of file dictionary.H.
References dictionary::findDict(), and keyType::REGEX.
Deprecated(2018-10)
Definition at line 1818 of file dictionary.H.
References dictionary::lookupEntry().
Deprecated(2018-10)
Definition at line 1834 of file dictionary.H.
References dictionary::lookup().
|
inline |
Deprecated(2018-10)
Definition at line 1851 of file dictionary.H.
References dictionary::getOrDefault().
|
inline |
Deprecated(2018-10)
Definition at line 1869 of file dictionary.H.
References dictionary::getOrAdd().
|
inline |
Deprecated(2018-10)
Definition at line 1887 of file dictionary.H.
References dictionary::readIfPresent().
|
inline |
Deprecated(2018-10) find and return a T.
Definition at line 1910 of file dictionary.H.
| Foam::wordList sortedToc | ( | const Compare & | comp | ) | const |
Definition at line 78 of file dictionaryTemplates.C.
| Foam::entry* add | ( | const keyType & | k, |
| const T & | v, | ||
| bool | overwrite | ||
| ) |
Definition at line 85 of file dictionaryTemplates.C.
References Foam::add(), and k.
| Foam::entry* set | ( | const keyType & | k, |
| const T & | v | ||
| ) |
Definition at line 92 of file dictionaryTemplates.C.
References k.
|
friend |
Declare friendship with the entry class for IO.
Definition at line 325 of file dictionary.H.
|
friend |
Read dictionary from Istream.
|
friend |
Write dictionary to Ostream.
| friend const_searcher |
Declare friendship with the searcher classes.
Definition at line 330 of file dictionary.H.
| friend searcher |
Definition at line 331 of file dictionary.H.
|
static |
Report optional keywords and values if not present in dictionary.
For value greater than 1: fatal. Set/unset via an InfoSwitch or -info-switch at the command-line
Definition at line 469 of file dictionary.H.
Referenced by dictionary::reportOptional().
|
static |
An empty dictionary, which is also the parent for all dictionaries.
Definition at line 474 of file dictionary.H.
Referenced by cellModel::cellModel(), dictionary::cfindScopedDict(), entry::clone(), codedFunctionObject::codeContext(), Stokes< BasicTurbulenceModel >::coeffDict(), dictionary::csearch(), dictionary::csearchScoped(), primitiveEntry::dict(), Foam::dimensionedConstant(), writerCaching::fieldsDict(), decompositionMethod::findCoeffsDict(), dynamicCodeContext::good(), dictionary::isNullDict(), dictionary::makeScopedDict(), RASModelVariables::New(), entry::New(), functionObjectList::New(), phase::iNew::operator()(), motionSolver::iNew::operator()(), phaseModel::iNew::operator()(), sizeGroup::iNew::operator()(), Foam::operator>>(), Foam::functionObjects::operator>>(), primitiveEntry::primitiveEntry(), meshRefinement::subDict(), triSurfaceMeshPointSet::triSurfaceMeshPointSet(), and dictionary::writeEntries().
|
static |
Output location when reporting default values.
Definition at line 479 of file dictionary.H.
1.8.14