Scalar.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) 2011-2016 OpenFOAM Foundation
9  Copyright (C) 2016-2021 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 // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
30 
31 namespace Foam
32 {
33 
34 // * * * * * * * * * * * * * * Static Data Members * * * * * * * * * * * * * //
35 
36 const char* const pTraits<Scalar>::typeName = "scalar";
37 const char* const pTraits<Scalar>::componentNames[] = { "" };
38 
39 const Scalar pTraits<Scalar>::zero = 0.0;
40 const Scalar pTraits<Scalar>::one = 1.0;
46 
47 
48 // * * * * * * * * * * * * * * * * Constructors * * * * * * * * * * * * * * //
49 
50 pTraits<Scalar>::pTraits(const Scalar& val) noexcept
51 :
52  p_(val)
53 {}
54 
55 
57 {
58  is >> p_;
59 }
60 
61 
62 // * * * * * * * * * * * * * * * IO/Conversion * * * * * * * * * * * * * * * //
63 
64 word name(const Scalar val)
65 {
66  std::ostringstream buf;
67  buf << val;
68 
69  return word(buf.str(), false); // Needs no stripping
70 }
71 
72 
73 Scalar ScalarRead(const char* buf)
74 {
75  char* endptr = nullptr;
76  errno = 0;
77  const auto parsed = ScalarConvert(buf, &endptr);
78 
79  const parsing::errorType err =
80  (
81  (parsed < -ScalarVGREAT || parsed > ScalarVGREAT)
83  : parsing::checkConversion(buf, endptr)
84  );
85 
86  if (err != parsing::errorType::NONE)
87  {
88  FatalIOErrorInFunction("unknown")
89  << parsing::errorNames[err] << " '" << buf << "'"
90  << exit(FatalIOError);
91  }
92 
93  // Round underflow to zero
94  return
95  (
96  (parsed > -ScalarVSMALL && parsed < ScalarVSMALL)
97  ? 0
98  : Scalar(parsed)
99  );
100 }
101 
102 
103 bool ScalarRead(const char* buf, Scalar& val)
104 {
105  char* endptr = nullptr;
106  errno = 0;
107  const auto parsed = ScalarConvert(buf, &endptr);
108 
109  // Round underflow to zero
110  val =
111  (
112  (parsed >= -ScalarVSMALL && parsed <= ScalarVSMALL)
113  ? 0
114  : Scalar(parsed)
115  );
116 
117  return
118  (
119  (parsed < -ScalarVGREAT || parsed > ScalarVGREAT)
120  ? false
122  );
123 }
124 
125 
126 // * * * * * * * * * * * * * * * IOstream Operators * * * * * * * * * * * * //
127 
129 {
130  Scalar val(0);
131  is >> val;
132 
133  return val;
134 }
135 
136 
138 {
139  token t(is);
140 
141  if (!t.good())
142  {
144  << "Bad token - could not get scalar value"
145  << exit(FatalIOError);
146  is.setBad();
147  return is;
148  }
149 
150  // Accept separated '-' (or '+') while expecting a number.
151  // This can arise during dictionary expansions (Eg, -$value)
152 
153  char prefix = 0;
154  if (t.isPunctuation())
155  {
156  prefix = t.pToken();
157  if (prefix == token::PLUS || prefix == token::MINUS)
158  {
159  is >> t;
160  }
161  }
162 
163  if (t.isNumber())
164  {
165  val =
166  (
167  (prefix == token::MINUS)
168  ? (0 - t.number())
169  : t.number()
170  );
171  }
172  else
173  {
175  << "Wrong token type - expected scalar value, found ";
176  if (prefix == token::PLUS || prefix == token::MINUS)
177  {
178  FatalIOError << '\'' << prefix << "' followed by ";
179  }
180  FatalIOError << t.info() << exit(FatalIOError);
181  is.setBad();
182  return is;
183  }
184 
185  is.check(FUNCTION_NAME);
186  return is;
187 }
188 
189 
191 {
192  os.write(val);
194  return os;
195 }
196 
197 
198 // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
199 
200 } // End namespace Foam
201 
202 // ************************************************************************* //
Foam::pTraits< Scalar >::vsmall
static const Scalar vsmall
Definition: Scalar.H:107
Foam::pTraits::pTraits
pTraits(const Base &obj)
Copy construct from base class.
Definition: pTraits.H:65
Foam::word
A class for handling words, derived from Foam::string.
Definition: word.H:65
Foam::ScalarRead
Scalar ScalarRead(const char *buf)
Parse entire buffer as a float/double, skipping leading/trailing whitespace.
Definition: Scalar.C:73
Foam::parsing::checkConversion
errorType checkConversion(const char *buf, char *endptr)
Sanity check after strtof, strtod, etc.
Definition: parsingI.H:29
Foam::token::PLUS
Addition [isseparator].
Definition: token.H:138
Foam::parsing::errorType::RANGE
Range error.
Foam::pTraits< Scalar >::min
static const Scalar min
Definition: Scalar.H:104
Foam::FatalIOError
IOerror FatalIOError
Foam::operator>>
Istream & operator>>(Istream &, directionInfo &)
Definition: directionInfo.C:230
Foam::token
A token holds an item read from Istream.
Definition: token.H:68
Foam::OBJstream::write
virtual Ostream & write(const char c)
Write character.
Definition: OBJstream.C:78
Scalar
#define Scalar
Definition: doubleScalar.C:41
Foam::token::pToken
punctuationToken pToken() const
Return punctuation character.
Definition: tokenI.H:485
Foam::token::isNumber
bool isNumber() const noexcept
Token is LABEL, FLOAT or DOUBLE.
Definition: tokenI.H:587
Foam::token::MINUS
Subtract or start of negative number.
Definition: token.H:139
Foam::operator<<
Ostream & operator<<(Ostream &, const boundaryPatch &p)
Write boundaryPatch as dictionary entries (without surrounding braces)
Definition: boundaryPatch.C:83
Foam::parsing::errorType::NONE
No error encountered.
ScalarVSMALL
#define ScalarVSMALL
Definition: doubleScalar.C:43
Foam::token::number
scalar number() const
Return label, float or double value.
Definition: tokenI.H:593
Foam::token::info
InfoProxy< token > info() const
Return info proxy for printing token information to a stream.
Definition: token.H:586
Foam::Istream
An Istream is an abstract base class for all input systems (streams, files, token lists etc)....
Definition: Istream.H:61
Foam::pTraits< Scalar >::typeName
static const char *const typeName
Definition: Scalar.H:99
Foam::token::isPunctuation
bool isPunctuation() const noexcept
Token is PUNCTUATION.
Definition: tokenI.H:459
Foam::pTraits< Scalar >::rootMax
static const Scalar rootMax
Definition: Scalar.H:105
Foam::parsing::errorNames
const Foam::Enum< errorType > errorNames
Strings corresponding to the errorType.
ScalarROOTVGREAT
#define ScalarROOTVGREAT
Definition: doubleScalar.C:44
Foam::parsing::errorType
errorType
Enumeration for possible parsing error.
Definition: parsing.H:57
Foam::IOstream::check
virtual bool check(const char *operation) const
Check IOstream status for given operation.
Definition: IOstream.C:58
os
OBJstream os(runTime.globalPath()/outputName)
Foam
Namespace for OpenFOAM.
Definition: atmBoundaryLayer.C:33
Foam::exit
errorManipArg< error, int > exit(error &err, const int errNo=1)
Definition: errorManip.H:130
Foam::token::good
bool good() const noexcept
True if token is not UNDEFINED or ERROR.
Definition: tokenI.H:405
Foam::pTraits< Scalar >::one
static const Scalar one
Definition: Scalar.H:102
Foam::pTraits< Scalar >::max
static const Scalar max
Definition: Scalar.H:103
Foam::pTraits< Scalar >::componentNames
static const char *const componentNames[]
Definition: Scalar.H:100
ScalarVGREAT
#define ScalarVGREAT
Definition: doubleScalar.C:42
FUNCTION_NAME
#define FUNCTION_NAME
Definition: messageStream.H:295
Foam::name
word name(const expressions::valueTypeCode typeCode)
A word representation of a valueTypeCode. Empty for INVALID.
Definition: exprTraits.C:59
Foam::IOstream::setBad
void setBad()
Set stream state to be 'bad'.
Definition: IOstream.H:369
ScalarConvert
#define ScalarConvert
Definition: doubleScalar.C:48
FatalIOErrorInFunction
#define FatalIOErrorInFunction(ios)
Report an error message using Foam::FatalIOError.
Definition: error.H:473
Foam::Ostream
An Ostream is an abstract base class for all output systems (streams, files, token lists,...
Definition: Ostream.H:56
Foam::pTraits< Scalar >::rootMin
static const Scalar rootMin
Definition: Scalar.H:106
Foam::pTraits< Scalar >::zero
static const Scalar zero
Definition: Scalar.H:101