includeEtcEntry.C
Go to the documentation of this file.
1 /*---------------------------------------------------------------------------*\
2  ========= |
3  \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
4  \\ / O peration | Website: https://openfoam.org
5  \\ / A nd | Copyright (C) 2011-2026 OpenFOAM Foundation
6  \\/ M anipulation |
7 -------------------------------------------------------------------------------
8 License
9  This file is part of OpenFOAM.
10 
11  OpenFOAM is free software: you can redistribute it and/or modify it
12  under the terms of the GNU General Public License as published by
13  the Free Software Foundation, either version 3 of the License, or
14  (at your option) any later version.
15 
16  OpenFOAM is distributed in the hope that it will be useful, but WITHOUT
17  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
18  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
19  for more details.
20 
21  You should have received a copy of the GNU General Public License
22  along with OpenFOAM. If not, see <http://www.gnu.org/licenses/>.
23 
24 \*---------------------------------------------------------------------------*/
25 
26 #include "includeEtcEntry.H"
27 #include "etcFiles.H"
28 #include "stringOps.H"
31 
32 // * * * * * * * * * * * * * * Static Data Members * * * * * * * * * * * * * //
33 
34 namespace Foam
35 {
36 namespace functionEntries
37 {
39 
41  (
45  );
46 
48  (
51  execute,
52  primitiveEntryIstream
53  );
54 }
55 }
56 
57 
58 // * * * * * * * * * * * Protected Member Functions * * * * * * * * * * * * //
59 
61 (
62  const fileName& dir,
63  const fileName& f,
64  const dictionary& dict
65 ) const
66 {
67  fileName fName(f);
68 
69  // Substitute dictionary and environment variables.
70  // Allow empty substitutions.
72 
73  if (fName.empty() || fName.isAbsolute())
74  {
75  return fName;
76  }
77  else
78  {
79  // Search the etc directories for the file
80  return findEtcFile(fName);
81  }
82 }
83 
84 
85 // * * * * * * * * * * * * * * * * Constructors * * * * * * * * * * * * * * //
86 
88 (
89  const label lineNumber,
90  const dictionary& parentDict,
91  Istream& is
92 )
93 :
94  includeEntry(typeName, lineNumber, parentDict, is)
95 {}
96 
97 
98 // * * * * * * * * * * * * * * * Member Functions * * * * * * * * * * * * * //
99 
101 (
102  dictionary& contextDict,
103  Istream& is
104 )
105 {
106  return includeEntry::execute(contextDict, is);
107 }
108 
109 
111 (
112  const dictionary& contextDict,
113  primitiveEntry& contextEntry,
114  Istream& is
115 )
116 {
117  return
118  includeEtcEntry(is.lineNumber(), contextDict, is)
119  .virtualExecute(contextDict, contextEntry, is);
120 }
121 
122 
123 // ************************************************************************* //
Macros for easy insertion into member function selection tables.
Macros for easy insertion into run-time selection tables.
label lineNumber() const
Return current stream line number.
Definition: IOstream.H:450
An Istream is an abstract base class for all input systems (streams, files, token lists etc)....
Definition: Istream.H:60
A list of keywords followed by any number of values (e.g. words and numbers) or sub-dictionaries.
Definition: dictionary.H:162
A class for handling file names.
Definition: fileName.H:82
Specify an include file when reading dictionaries.
Definition: includeEntry.H:78
virtual bool virtualExecute(const dictionary &contextDict, primitiveEntry &contextEntry, Istream &)
Expand the functionEntry into the contextEntry.
Definition: includeEntry.C:159
const string & fName() const
Return the file name.
Definition: includeEntry.H:104
virtual bool execute(dictionary &contextDict, Istream &)
Expand the functionEntry into the contextDict.
Definition: includeEntry.C:260
Specify an etc file to include when reading dictionaries, expects a single string to follow.
virtual fileName includeFileName(const fileName &dir, const fileName &, const dictionary &) const
Expand include fileName and return.
includeEtcEntry(const label lineNumber, const dictionary &parentDict, Istream &is)
Construct from line number, dictionary and Istream.
virtual bool execute(dictionary &contextDict, Istream &)
Expand the functionEntry into the contextDict.
A functionEntry causes entries to be added/manipulated on the specified dictionary given an input str...
Definition: functionEntry.H:66
A keyword and a list of tokens is a 'primitiveEntry'. An primitiveEntry can be read,...
const dictionary & dict() const
This entry is not a dictionary,.
Template function which returns the un-mangled name of a given type. Useful for types which do not ha...
Functions to search 'etc' directories for configuration files etc.
defineFunctionTypeNameAndDebug(includeFvConstraintEntry, 0)
addToMemberFunctionSelectionTable(functionEntry, calcEntry, execute, primitiveEntryIstream)
addToRunTimeSelectionTable(functionEntry, includeFvConstraintEntry, dictionary)
string & inplaceExpandEntry(string &s, const dictionary &dict, const bool allowEnvVars, const bool allowEmpty, const char sigil='$')
Inplace expand occurrences of variables according to the dictionary.
Definition: stringOps.C:760
Namespace for OpenFOAM.
intWM_LABEL_SIZE_t label
A label is an int32_t or int64_t as specified by the pre-processor macro WM_LABEL_SIZE.
Definition: label.H:59
fileName findEtcFile(const fileName &, bool mandatory=false)
Search for a file using findEtcFiles.
Definition: etcFiles.C:252
labelList f(nPoints)
dictionary dict