IPstreams.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) 2022-2023 OpenCFD Ltd.
9 -------------------------------------------------------------------------------
10 License
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 "UIPstream.H"
29 #include "IPstream.H"
30 #include "IOstreams.H"
31 
32 // * * * * * * * * * * * * * * * * Constructor * * * * * * * * * * * * * * * //
33 
35 (
36  const UPstream::commsTypes commsType,
37  const int fromProcNo,
38  DynamicList<char>& receiveBuf,
39  label& receiveBufPosition,
40  const int tag,
41  const label comm,
42  const bool clearAtEnd,
44 )
45 :
47  (
48  commsType,
49  fromProcNo,
50  receiveBuf,
51  receiveBufPosition,
52  tag,
53  comm,
54  clearAtEnd,
55  fmt
56  )
57 {
59  {
60  // Message is already received into buffer
61  }
62  else
63  {
64  bufferIPCrecv();
65  }
66 }
67 
68 
69 Foam::UIPstream::UIPstream(const int fromProcNo, PstreamBuffers& buffers)
70 :
71  UIPstreamBase(fromProcNo, buffers)
72 {
74  {
75  // Message is already received into buffer
77 
78  if (debug)
79  {
80  Pout<< "UIPstream::UIPstream PstreamBuffers :"
81  << " fromProcNo:" << fromProcNo_
82  << " tag:" << tag_ << " comm:" << comm_
83  << " receive buffer size:" << messageSize_
84  << Foam::endl;
85  }
86  }
87  else
88  {
89  bufferIPCrecv();
90  }
91 }
92 
93 
95 (
96  const DynamicList<char>& recvBuf,
98 )
99 :
100  UIPstreamBase(recvBuf, fmt)
101 {}
102 
103 
105 (
106  const UPstream::commsTypes commsType,
107  const int fromProcNo,
108  const label bufSize,
109  const int tag,
110  const label comm,
112 )
113 :
114  Pstream(commsType, bufSize),
115  UIPstream
116  (
117  commsType,
118  fromProcNo,
119  Pstream::transferBuf_,
120  UIPstreamBase::storedRecvBufPos_, // Internal only
121  tag,
122  comm,
123  false, // Do not clear Pstream::transferBuf_ if at end
124  fmt
125  )
126 {}
127 
128 
129 // ************************************************************************* //
UIPstream(const UPstream::commsTypes commsType, const int fromProcNo, DynamicList< char > &receiveBuf, label &receiveBufPosition, const int tag=UPstream::msgType(), const label comm=UPstream::worldComm, const bool clearAtEnd=false, IOstreamOption::streamFormat fmt=IOstreamOption::BINARY)
Construct given process index to read from using the given attached receive buffer, optional communication characteristics and IO format.
Definition: IPstreams.C:28
void size(const label n)
Older name for setAddressableSize.
Definition: UList.H:116
IPstream(const UPstream::commsTypes commsType, const int fromProcNo, const label bufSize=0, const int tag=UPstream::msgType(), const label comm=UPstream::worldComm, IOstreamOption::streamFormat fmt=IOstreamOption::BINARY)
Construct given process index to read from and optional buffer size, read format. ...
Definition: IPstreams.C:98
commsTypes
Communications types.
Definition: UPstream.H:72
Base class for input inter-processor communications stream (ie, parallel streams). Not to be used directly, thus contructors are protected.
Definition: UIPstream.H:54
Ostream & endl(Ostream &os)
Add newline and flush stream.
Definition: Ostream.H:531
const int fromProcNo_
Source rank for the data.
Definition: UIPstream.H:98
int messageSize_
The message size, read on bufferIPCrecv or set directly.
Definition: UIPstream.H:113
Useful combination of include files which define Sin, Sout and Serr and the use of IO streams general...
Input inter-processor communications stream using MPI send/recv etc. - operating on external buffer...
Definition: UIPstream.H:287
Inter-processor communications stream.
Definition: Pstream.H:57
commsTypes commsType() const noexcept
Get the communications type of the stream.
Definition: UPstream.H:1261
int debug
Static debugging option.
DynamicList< char > & recvBuf_
Reference to the receive buffer data.
Definition: UIPstream.H:129
const int tag_
Message tag for communication.
Definition: UIPstream.H:103
streamFormat
Data format (ascii | binary)
"nonBlocking" : (MPI_Isend, MPI_Irecv)
const int comm_
The communicator index.
Definition: UIPstream.H:108
prefixOSstream Pout
OSstream wrapped stdout (std::cout) with parallel prefix.