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 :
42  unwatchedIOdictionary(io, typeName, fallback)
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 :
63  baseIOdictionary(io, fallback)
64 {
65  if (!readHeaderOk(IOstreamOption::ASCII, wantedType) && fallback)
66  {
67  dictionary::operator=(*fallback);
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() == IOobject::MUST_READ_IF_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() == IOobject::MUST_READ_IF_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()
139  && (
142  )
143  );
144 
145  if (masterOnly && Pstream::parRun())
146  {
147  Pstream::broadcast(files_);
148  }
149 
150  addWatch(f);
151  }
152 }
153 
154 
155 // ************************************************************************* //
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:129
#define FatalErrorInFunction
Report an error message using Foam::FatalError.
Definition: error.H:598
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:666
static bool & parRun() noexcept
Test if this a parallel run.
Definition: UPstream.H:1049
static void broadcast(Type &value, const label comm=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:799
void operator=(const dictionary &rhs)
Copy assignment.
Definition: dictionary.C:868
A class for handling words, derived from Foam::string.
Definition: word.H:63
virtual void addWatch()
Add file watch on object (READ_IF_MODIFIED)
errorManip< error > abort(error &err)
Definition: errorManip.H:139
static fileCheckTypes fileModificationChecking
Type of file modification checking.
Definition: IOobject.H:343
labelList f(nPoints)
IOobject io("surfaceFilmProperties", mesh.time().constant(), mesh, IOobject::READ_IF_PRESENT, IOobject::NO_WRITE, IOobject::NO_REGISTER)
Defines the attributes of an object for which implicit objectRegistry management is supported...
Definition: IOobject.H:172
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.