unwatchedIOdictionary.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) 2015 OpenFOAM Foundation
9  Copyright (C) 2021-2022 OpenCFD Ltd.
10 -------------------------------------------------------------------------------
11 License
12  This file is part of OpenFOAM.
13 
14  OpenFOAM is free software: you can redistribute it and/or modify it
15  under the terms of the GNU General Public License as published by
16  the Free Software Foundation, either version 3 of the License, or
17  (at your option) any later version.
18 
19  OpenFOAM is distributed in the hope that it will be useful, but WITHOUT
20  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
21  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
22  for more details.
23 
24  You should have received a copy of the GNU General Public License
25  along with OpenFOAM. If not, see <http://www.gnu.org/licenses/>.
26 
27 \*---------------------------------------------------------------------------*/
28 
29 #include "unwatchedIOdictionary.H"
30 #include "objectRegistry.H"
31 #include "Pstream.H"
32 #include "Time.H"
33 
34 // * * * * * * * * * * * * * * * * Constructors * * * * * * * * * * * * * * //
35 
37 (
38  const IOobject& io,
39  const dictionary* fallback
40 )
41 :
43 {}
44 
45 
47 (
48  const IOobject& io,
49  const dictionary& dict
50 )
51 :
52  unwatchedIOdictionary(io, typeName, &dict)
53 {}
54 
55 
57 (
58  const IOobject& io,
59  const word& wantedType,
60  const dictionary* fallback
61 )
62 :
64 {
65  if (!readHeaderOk(IOstreamOption::ASCII, wantedType) && fallback)
66  {
68  }
69 
70  // For if MUST_READ_IF_MODIFIED
71  addWatch();
72 }
73 
74 
76 (
77  const IOobject& io,
78  Istream& is
79 )
80 :
81  baseIOdictionary(io, is)
82 {
83  // Default construct dictionary and read in afterwards
84  // so that if there is some fancy massaging due to a
85  // functionEntry in
86  // the dictionary at least the type information is already complete.
87  is >> *this;
88 
89  // For if MUST_READ_IF_MODIFIED
90  addWatch();
91 }
92 
93 
94 // * * * * * * * * * * * * * * * Members Functions * * * * * * * * * * * * * //
95 
97 {
98  label index = -1;
99 
100  if (readOpt() == IOobjectOption::READ_MODIFIED)
101  {
102  index = files_.find(f);
103 
104  if (index == -1)
105  {
106  index = files_.size();
107  files_.append(f);
108  }
109  }
110  return index;
111 }
112 
113 
115 {
116  if (readOpt() == IOobjectOption::READ_MODIFIED)
117  {
118  fileName f = filePath();
119  if (f.empty())
120  {
121  // We don't have this file but would like to re-read it.
122  // Possibly if master-only reading mode.
123  f = objectPath();
124  }
125 
126  if (files_.found(f))
127  {
129  << "Object " << objectPath() << " of type " << type()
130  << " already watched" << nl
131  << abort(FatalError);
132  }
133 
134  // If master-only reading only the master will have all dependencies
135  // so broadcast these to other ranks
136  const bool masterOnly
137  (
138  global()
140  );
141 
142  if (masterOnly && UPstream::parRun())
143  {
144  Pstream::broadcast(files_);
145  }
146 
147  addWatch(f);
148  }
149 }
150 
151 
152 // ************************************************************************* //
dictionary dict
unwatchedIOdictionary is like IOdictionary but stores dependencies as files instead of fileMonitor wa...
A class for handling file names.
Definition: fileName.H:72
baseIOdictionary is derived from dictionary and IOobject to give the dictionary automatic IO function...
error FatalError
Error stream (stdout output on all processes), with additional &#39;FOAM FATAL ERROR&#39; header text and sta...
A list of keyword definitions, which are a keyword followed by a number of values (eg...
Definition: dictionary.H:130
#define FatalErrorInFunction
Report an error message using Foam::FatalError.
Definition: error.H:652
An Istream is an abstract base class for all input systems (streams, files, token lists etc)...
Definition: Istream.H:57
constexpr char nl
The newline &#39;\n&#39; character (0x0a)
Definition: Ostream.H:50
"ascii" (normal default)
bool empty() const noexcept
True if List is empty (ie, size() is zero)
Definition: UList.H:702
static bool & parRun() noexcept
Test if this a parallel run.
Definition: UPstream.H:1774
static void broadcast(Type &value, const int communicator=UPstream::worldComm)
Broadcast content (contiguous or non-contiguous) to all communicator ranks. Does nothing in non-paral...
fileName::Type type(const fileName &name, const bool followLink=true)
Return the file type: DIRECTORY or FILE, normally following symbolic links.
Definition: POSIX.C:805
static bool fileModificationChecking_masterOnly() noexcept
Test fileModificationChecking for master-only.
Definition: IOobjectI.H:23
const auto & fallback
void operator=(const dictionary &rhs)
Copy assignment.
Definition: dictionary.C:886
A class for handling words, derived from Foam::string.
Definition: word.H:63
virtual void addWatch()
Add file watch on object (READ_IF_MODIFIED)
const auto & io
errorManip< error > abort(error &err)
Definition: errorManip.H:139
labelList f(nPoints)
Defines the attributes of an object for which implicit objectRegistry management is supported...
Definition: IOobject.H:188
bool readHeaderOk(const IOstreamOption::streamFormat fmt, const word &typeName)
Helper: check readOpt flags and read if necessary.
unwatchedIOdictionary(const IOobject &io, const dictionary *fallback=nullptr)
Construct given an IOobject and optional fallback dictionary content.