wordDirective.C
Go to the documentation of this file.
1/*---------------------------------------------------------------------------*\
2 ========= |
3 \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
4 \\ / O peration |
5 \\ / A nd | www.openfoam.com
6 \\/ M anipulation |
7-------------------------------------------------------------------------------
8 Copyright (C) 2021 OpenCFD Ltd.
9-------------------------------------------------------------------------------
10License
11 This file is part of OpenFOAM.
12
13 OpenFOAM is free software: you can redistribute it and/or modify it
14 under the terms of the GNU General Public License as published by
15 the Free Software Foundation, either version 3 of the License, or
16 (at your option) any later version.
17
18 OpenFOAM is distributed in the hope that it will be useful, but WITHOUT
19 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
20 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
21 for more details.
22
23 You should have received a copy of the GNU General Public License
24 along with OpenFOAM. If not, see <http://www.gnu.org/licenses/>.
25
26\*---------------------------------------------------------------------------*/
27
28#include "wordDirective.H"
29#include "dictionary.H"
30#include "stringOps.H"
32
33// * * * * * * * * * * * * * * Static Data Members * * * * * * * * * * * * * //
34
35namespace Foam
36{
37namespace functionEntries
38{
40 (
43 execute,
44 dictionaryIstream,
45 word
46 );
47
49 (
52 execute,
53 primitiveEntryIstream,
54 word
55 );
56
57} // End namespace functionEntries
58} // End namespace Foam
59
60
61// * * * * * * * * * * * * * Private Member Functions * * * * * * * * * * * //
62
64(
65 const dictionary& parentDict,
66 Istream& is
67)
68{
69 token tok(is);
70
71 // The string to evaluate
72 string str;
73
74 if (tok.isStringType()) // Also accepts a single bare word
75 {
76 // - #word expr
77 // - #word "expr"
78 // - #word #{ expr #}
79 str = tok.stringToken();
80 }
81 else if (tok.isPunctuation(token::BEGIN_BLOCK))
82 {
83 // - #word { expr }
84 // strip comments
85 if (!continueReadUntilRightBrace(is, str, true))
86 {
88 (
89 is,
90 "Premature end while reading #word - missing '}'?"
91 );
92 }
93 }
94 else
95 {
97 << "Invalid input for #word."
98 " Expecting a string or block to expand, but found" << nl
99 << tok.info() << endl
100 << exit(FatalIOError);
101 }
102
103 stringOps::inplaceExpand(str, parentDict);
104
105 word result(word::validate(str)); // Includes trimming etc.
106
107 if (!result.empty())
108 {
109 tok = std::move(result);
110 return tok;
111 }
112
113 // Expanded to nothing - treat as a no-op
115}
116
117
118// * * * * * * * * * * * * * * * Member Functions * * * * * * * * * * * * * //
119
121(
122 const dictionary& parentDict,
124 Istream& is
125)
126{
127 token tok(evaluate(parentDict, is));
128
129 if (tok.good())
130 {
131 // Can add evaluated value directly into primitiveEntry
132 entry.append(std::move(tok), true); // Lazy resizing
133 }
134
135 return true;
136}
137
138
140(
141 dictionary& parentDict,
142 Istream& is
143)
144{
145 token tok(evaluate(parentDict, is));
146
147 if (tok.good())
148 {
149 // Using putBack to insert evaluated value into stream
150 is.putBack(tok);
151 }
152
153 return true;
154}
155
156
157// ************************************************************************* //
Macros for easy insertion into member function selection tables.
#define addNamedToMemberFunctionSelectionTable(baseType, thisType, funcName, argNames, lookupName)
Add to hash-table of functions with 'lookupName' as the key.
void evaluate()
Evaluate boundary conditions.
An Istream is an abstract base class for all input systems (streams, files, token lists etc)....
Definition: Istream.H:64
void putBack(const token &tok)
Put back a token. Only a single put back is permitted.
Definition: Istream.C:70
A list of keyword definitions, which are a keyword followed by a number of values (eg,...
Definition: dictionary.H:126
A keyword and a list of tokens is an 'entry'.
Definition: entry.H:70
static void reportReadWarning(const IOstream &, const std::string &)
Report a read warning (on std::cerr)
Definition: entry.C:48
Converts/expands string content to a word. This can be useful for composition of names.
Definition: wordDirective.H:68
A functionEntry causes entries to be added/manipulated on the specified dictionary given an input str...
Definition: functionEntry.H:69
static bool continueReadUntilRightBrace(Istream &is, std::string &str, const bool stripComments=true)
Slurp a string until a closing '}' is found.
Definition: functionEntry.C:66
virtual bool execute()
Calculate the output fields.
virtual void validate()
Validate the turbulence fields after construction.
Definition: kkLOmega.C:597
A keyword and a list of tokens comprise a primitiveEntry. A primitiveEntry can be read,...
A token holds an item read from Istream.
Definition: token.H:69
@ BEGIN_BLOCK
Begin block [isseparator].
Definition: token.H:159
bool good() const noexcept
True if token is not UNDEFINED or ERROR.
Definition: tokenI.H:405
static const token undefinedToken
An undefined token.
Definition: token.H:294
A class for handling words, derived from Foam::string.
Definition: word.H:68
#define FatalIOErrorInFunction(ios)
Report an error message using Foam::FatalIOError.
Definition: error.H:473
void inplaceExpand(std::string &s, const HashTable< string > &mapping, const char sigil='$')
Definition: stringOps.C:731
Namespace for OpenFOAM.
Ostream & endl(Ostream &os)
Add newline and flush stream.
Definition: Ostream.H:372
IOerror FatalIOError
errorManipArg< error, int > exit(error &err, const int errNo=1)
Definition: errorManip.H:130
constexpr char nl
The newline '\n' character (0x0a)
Definition: Ostream.H:53