Loading...
Searching...
No Matches
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-2023 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"
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
63Foam::token Foam::functionEntries::wordDirective::evaluate
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.add_tokens(std::move(tok)); // Add at tokenIndex
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.
An Istream is an abstract base class for all input systems (streams, files, token lists etc)....
Definition Istream.H:60
void putBack(const token &tok)
Put back a token (copy). Only a single put back is permitted.
Definition Istream.C:71
A list of keyword definitions, which are a keyword followed by a number of values (eg,...
Definition dictionary.H:133
A keyword and a list of tokens is an 'entry'.
Definition entry.H:66
entry(const keyType &keyword)
Construct from keyword.
Definition entry.C:62
static void reportReadWarning(const IOstream &, const std::string &)
Report a read warning (on std::cerr).
Definition entry.C:41
Converts/expands string content to a word. This can be useful for composition of names.
static bool execute(const dictionary &parentDict, primitiveEntry &entry, Istream &is)
Execute in a primitiveEntry context.
A functionEntry causes entries to be added/manipulated on the specified dictionary given an input str...
static bool continueReadUntilRightBrace(Istream &is, std::string &str, const bool stripComments=true)
Slurp a string until a closing '}' is found.
A keyword and a list of tokens comprise a primitiveEntry. A primitiveEntry can be read,...
primitiveEntry(const keyType &key)
Construct from keyword and no tokens.
A token holds an item read from Istream.
Definition token.H:70
@ BEGIN_BLOCK
Begin block [isseparator].
Definition token.H:178
bool good() const noexcept
True if token is not UNDEFINED or ERROR.
Definition tokenI.H:584
static const token undefinedToken
An undefined token.
Definition token.H:570
A class for handling words, derived from Foam::string.
Definition word.H:66
static word validate(const std::string &s, const bool prefix=false)
Construct validated word (no invalid characters).
Definition word.C:39
#define FatalIOErrorInFunction(ios)
Report an error message using Foam::FatalIOError.
Definition error.H:629
Namespace for containing a functionEntry.
Definition calcEntry.C:33
void inplaceExpand(std::string &s, const HashTable< string > &mapping, const char sigil='$')
Inplace expand occurrences of variables according to the mapping. Does not use environment values.
Namespace for OpenFOAM.
Ostream & endl(Ostream &os)
Add newline and flush stream.
Definition Ostream.H:519
IOerror FatalIOError
Error stream (stdout output on all processes), with additional 'FOAM FATAL IO ERROR' header text and ...
errorManipArg< error, int > exit(error &err, const int errNo=1)
Definition errorManip.H:125
constexpr char nl
The newline '\n' character (0x0a).
Definition Ostream.H:50