Scalar bounds to be used as a unary predicate. More...

Collaboration diagram for scalarRange:

Public Types
typedef scalar	value_type
	Type of values the range contains. More...

Public Member Functions
	scalarRange () noexcept
	Construct an empty (inverse) range. More...

	scalarRange (const scalar value) noexcept
	Construct an exact value matcher. More...

	scalarRange (const scalar minVal, const scalar maxVal) noexcept
	Construct a range from min-value to max-value. More...

	scalarRange (const MinMax< label > &range) noexcept
	Copy construct from a min/max range. More...

	scalarRange (const MinMax< scalar > &range) noexcept
	Copy construct from a min/max range. More...

void	clear () noexcept
	Reset to an empty (inverse) range. More...

bool	empty () const noexcept
	True if range is empty (eg, inverted) More...

bool	valid () const noexcept
	True if range is non-empty. More...

bool	single () const noexcept
	True if the range bounds represent a single value. More...

scalar	min () const noexcept
	The min value of the range. More...

scalar	max () const noexcept
	The max value of the range. More...

scalar	value () const
	A representative (average) value for the range. More...

bool	match (const scalar &val) const
	True if the value matches the condition. More...

bool	operator() (const scalar &val) const
	Identical to match(), for use as a predicate. More...

bool	operator== (const scalarRange &rhs) const noexcept

bool	operator!= (const scalarRange &rhs) const noexcept

Static Public Member Functions
static bool	parse (const std::string &str, scalarRange &range)
	Construct by parsing string content. More...

static scalarRange	parse (const std::string &str)
	Construct by parsing string content. More...

static scalarRange	ge (const scalar minVal) noexcept
	Construct a greater-equals bound. More...

static scalarRange	gt (const scalar minVal) noexcept
	Construct a greater-than bound. More...

static scalarRange	ge0 () noexcept
	Construct a greater-equals zero bound. More...

static scalarRange	gt0 () noexcept
	Construct a greater-than zero bound. More...

static scalarRange	le (const scalar maxVal) noexcept
	Construct a less-equals bound. More...

static scalarRange	lt (const scalar maxVal) noexcept
	Construct a less-than bound. More...

static scalarRange	zero_one () noexcept
	Construct a greater-equals 0, less-equals 1 bound. More...

Static Public Attributes
static const scalarRange	null
	An empty/inverted range that never matches. More...

static const scalarRange	always
	A range that always matches. More...

Friends
Ostream &	operator<< (Ostream &os, const scalarRange &range)
	Print information about the range. More...

Detailed Description

Scalar bounds to be used as a unary predicate.

The bound can be specified as an "MIN:MAX" range, as a "MIN:" or ":MAX" bound or simply as a single "VALUE".

When defined via the parse() method, the special string "none" can be used to define an empty (inverse) range.

See also: Foam::MinMax Foam::predicates::scalars

Source files

Definition at line 67 of file scalarRange.H.

Member Typedef Documentation

◆ value_type

typedef scalar value_type

Type of values the range contains.

Definition at line 108 of file scalarRange.H.

Constructor & Destructor Documentation

◆ scalarRange() [1/5]

scalarRange ( )

inlinenoexcept

Construct an empty (inverse) range.

Definition at line 43 of file scalarRangeI.H.

Referenced by scalarRange::parse().

Here is the caller graph for this function:

◆ scalarRange() [2/5]

scalarRange ( const scalar value )

inlineexplicitnoexcept

Construct an exact value matcher.

Definition at line 49 of file scalarRangeI.H.

◆ scalarRange() [3/5]

scalarRange	(	const scalar	minVal,
		const scalar	maxVal
	)

inlinenoexcept

Construct a range from min-value to max-value.

Definition at line 56 of file scalarRangeI.H.

References clear(), and Foam::equal().

Here is the call graph for this function:

◆ scalarRange() [4/5]

scalarRange ( const MinMax< label > & range )

explicitnoexcept

Copy construct from a min/max range.

Automatically decides if this is a GE_LE or NONE range

Definition at line 140 of file scalarRange.C.

◆ scalarRange() [5/5]

scalarRange ( const MinMax< scalar > & range )

explicitnoexcept

Copy construct from a min/max range.

Automatically decides if this is a GE_LE or NONE range

Definition at line 148 of file scalarRange.C.

Member Function Documentation

◆ parse() [1/2]

bool parse	(	const std::string &	str,
		scalarRange &	range
	)

static

Construct by parsing string content.

A colon (:) is used as a range marker or when specifying greater-than or less-than bounds.

Note: The special string "none" can be used define an empty (inverse) range

Returns: True if no parse problems were encountered.

Definition at line 48 of file scalarRange.C.

References scalarRange::always, scalarRange::ge(), scalarRange::le(), range, scalarRange::scalarRange(), Foam::val, and Switch::valid().

Here is the call graph for this function:

◆ parse() [2/2]

Foam::scalarRange parse ( const std::string & str )

static

Construct by parsing string content.

Any parse problems are emitted as information and the returned range is of type empty().

Returns: The parsed range, which is empty() on any problems

Definition at line 125 of file scalarRange.C.

References Foam::endl(), Foam::Info, and range.

Here is the call graph for this function:

◆ ge()

Foam::scalarRange ge ( const scalar minVal )

inlinestaticnoexcept

Construct a greater-equals bound.

Definition at line 74 of file scalarRangeI.H.

Referenced by scalarRange::parse().

Here is the caller graph for this function:

◆ gt()

Foam::scalarRange gt ( const scalar minVal )

inlinestaticnoexcept

Construct a greater-than bound.

Definition at line 80 of file scalarRangeI.H.

◆ ge0()

Foam::scalarRange ge0 ( )

inlinestaticnoexcept

Construct a greater-equals zero bound.

Definition at line 86 of file scalarRangeI.H.

◆ gt0()

Foam::scalarRange gt0 ( )

inlinestaticnoexcept

Construct a greater-than zero bound.

Definition at line 92 of file scalarRangeI.H.

◆ le()

Foam::scalarRange le ( const scalar maxVal )

inlinestaticnoexcept

Construct a less-equals bound.

Definition at line 98 of file scalarRangeI.H.

Referenced by scalarRange::parse().

Here is the caller graph for this function:

◆ lt()

Foam::scalarRange lt ( const scalar maxVal )

inlinestaticnoexcept

Construct a less-than bound.

Definition at line 103 of file scalarRangeI.H.

◆ zero_one()

Foam::scalarRange zero_one ( )

inlinestaticnoexcept

Construct a greater-equals 0, less-equals 1 bound.

Definition at line 109 of file scalarRangeI.H.

◆ clear()

void clear ( )

inlinenoexcept

Reset to an empty (inverse) range.

Definition at line 117 of file scalarRangeI.H.

◆ empty()

bool empty ( ) const

inlinenoexcept

True if range is empty (eg, inverted)

Definition at line 125 of file scalarRangeI.H.

◆ valid()

bool valid ( ) const

inlinenoexcept

True if range is non-empty.

Definition at line 131 of file scalarRangeI.H.

◆ single()

bool single ( ) const

inlinenoexcept

True if the range bounds represent a single value.

Definition at line 137 of file scalarRangeI.H.

◆ min()

Foam::scalar min ( ) const

inlinenoexcept

The min value of the range.

Definition at line 143 of file scalarRangeI.H.

◆ max()

Foam::scalar max ( ) const

inlinenoexcept

The max value of the range.

Definition at line 149 of file scalarRangeI.H.

◆ value()

Foam::scalar value ( ) const

inline

A representative (average) value for the range.

For GE, LE bounds it is the min/max value, respectively.

Definition at line 155 of file scalarRangeI.H.

◆ match()

bool match ( const scalar & val ) const

inline

True if the value matches the condition.

Definition at line 178 of file scalarRangeI.H.

References Foam::equal(), and Foam::val.

Here is the call graph for this function:

◆ operator()()

bool operator() ( const scalar & val ) const

inline

Identical to match(), for use as a predicate.

Definition at line 196 of file scalarRangeI.H.

References Foam::stringOps::match(), and Foam::val.

Here is the call graph for this function:

◆ operator==()

bool operator== ( const scalarRange & rhs ) const

inlinenoexcept

Definition at line 203 of file scalarRangeI.H.

◆ operator!=()

bool operator!= ( const scalarRange & rhs ) const

inlinenoexcept

Definition at line 212 of file scalarRangeI.H.

References Foam::operator==().

Here is the call graph for this function:

Friends And Related Function Documentation

◆ operator<<

Ostream& operator<<	(	Ostream &	os,
		const scalarRange &	range
	)

friend

Print information about the range.

Member Data Documentation

◆ null

const Foam::scalarRange null

static

An empty/inverted range that never matches.

Definition at line 114 of file scalarRange.H.

◆ always

const Foam::scalarRange always

static

A range that always matches.

Definition at line 117 of file scalarRange.H.

Referenced by scalarRange::parse().

The documentation for this class was generated from the following files:

src/OpenFOAM/primitives/ranges/scalarRange/scalarRange.H
src/OpenFOAM/primitives/ranges/scalarRange/scalarRange.C
src/OpenFOAM/primitives/ranges/scalarRange/scalarRangeI.H

Public Types

Public Member Functions

Static Public Member Functions

Static Public Attributes

Friends

Detailed Description

Member Typedef Documentation

◆ value_type

Constructor & Destructor Documentation

◆ scalarRange() [1/5]

◆ scalarRange() [2/5]

◆ scalarRange() [3/5]

◆ scalarRange() [4/5]

◆ scalarRange() [5/5]

Member Function Documentation

◆ parse() [1/2]

◆ parse() [2/2]

◆ ge()

◆ gt()

◆ ge0()

◆ gt0()

◆ le()

◆ lt()

◆ zero_one()

◆ clear()

◆ empty()

◆ valid()

◆ single()

◆ min()

◆ max()

◆ value()

◆ match()

◆ operator()()

◆ operator==()

◆ operator!=()

Friends And Related Function Documentation

◆ operator<<

Member Data Documentation

◆ null

◆ always