Classes
class	nearest_cast_fn< A, R >

Functions
template<typename R, typename A>
R	nearest_cast (const A &x)
double	round_half_up (double x)
float	round_half_up (float x)
long	lround_half_up (double x)
long	lround_half_up (float x)

Detailed Description

<adobe/cmath.hpp> provides type definitions and functions based on the 1999 C Standard header <math.h> wrapped in namespace adobe. Currently, the set of provided types and functions is limited, please request extensions to this file as needed.

The C99/TR1 extensions supplied here for compatibility are:

- adobe::double_t - A type at least as wide as double.
- adobe::float_t - A type at least as wide as float.

- adobe::trunc - Returns the truncated integer value.
- adobe::round - Returns nearest integer value in floating-point format, rounding halfway cases away from zero, regardless of the current rounding direction.
- adobe::lround - Same as <code>round()</code>, but returns a long int.

The implementation may #include <math.h>.

There are also additions in this file not related to the C99 but are nevertheless appropriate as cmath extensions.

Function Documentation

◆ nearest_cast()

template<typename R, typename A>

R nearest_cast ( const A & x )

This function addresses the problem where a value of a floating-point type is to be converted to an unknown user-defined type. If the unknown type is an integral type, the argument should be rounded. If not, the argument should be cast directly to the return type. nearest_cast performs the rounding if necessary using round_half_up().

adobe::nearest_cast_fn is the function object form of adobe::nearest_cast and may be specialized to with a user defined type to customize adobe::nearest_cast.

Requirements: Type A should be convertible to type R. If R is an integral type, it should be large enough to store the value in x after rounding.

Example: int i = nearest_cast<int>(9.5);

assert(i == 10);

float f = nearest_cast<float>(9.5);

assert(f == 9.5);

template <typename Result, typename Argument>

Result half(const Argument& x)

{

return nearest_cast<Result>(x/2.0);

}

template <typename II, // II models Input Iterator

typename OI> // OI models Output Iterator

void nearest_sequence(II first, II last, OI result)

{

std::transform(first, last, result,

nearest_cast_fn<typename II::value_type, typename OI::value_type>());

}

adobe::nearest_cast
R nearest_cast(const A &x)
Definition cmath.hpp:66

Definition at line 66 of file cmath.hpp.

◆ round_half_up() [1/2]

double round_half_up ( double x )

Returns: The nearest integer value in floating-point format, rounding halfway cases towards positive infinity, regardless of the current rounding direction.

Definition at line 46 of file cmath.hpp.

◆ round_half_up() [2/2]

float round_half_up ( float x )

See: adobe::round_half_up(double x).

Definition at line 48 of file cmath.hpp.

◆ lround_half_up() [1/2]

long lround_half_up ( double x )

Returns: The nearest integer value, rounding halfway cases towards positive infinity, regardless of the current rounding direction. If the rounded value is outside the range of the return type, the numeric result is unspecified. A range error may occur if the magnitude of x is too large.

Definition at line 50 of file cmath.hpp.

◆ lround_half_up() [2/2]

long lround_half_up ( float x )

See: adobe::lround_half_up(double x)

Definition at line 52 of file cmath.hpp.

Classes