티스토리 수익 글 보기

Comparison for equality.

Parameters

x	first operand
y	second operand

Return values

true	if operands equal
false	else

Exceptions

FE_INVALID

if x or y is NaN

Comparison for inequality.

Parameters

x	first operand
y	second operand

Return values

true	if operands not equal
false	else

Exceptions

FE_INVALID

if x or y is NaN

Comparison for less than.

Parameters

x	first operand
y	second operand

Return values

true	if x less than y
false	else

Exceptions

FE_INVALID

if x or y is NaN

Comparison for greater than.

Parameters

x	first operand
y	second operand

Return values

true	if x greater than y
false	else

Exceptions

FE_INVALID

if x or y is NaN

Comparison for less equal.

Parameters

x	first operand
y	second operand

Return values

true	if x less equal y
false	else

Exceptions

FE_INVALID

if x or y is NaN

Comparison for greater equal.

Parameters

x	first operand
y	second operand

Return values

true	if x greater equal y
false	else

Exceptions

FE_INVALID

if x or y is NaN

Identity.

Parameters

arg

operand

Returns

unchanged operand

Negation.

Parameters

arg

operand

Returns

negated operand

Addition.

This operation is exact to rounding for all rounding modes.

Parameters

x	left operand
y	right operand

Returns

sum of half expressions

Exceptions

FE_INVALID	if x and y are infinities with different signs or signaling NaNs
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding

Subtraction.

This operation is exact to rounding for all rounding modes.

Parameters

x	left operand
y	right operand

Returns

difference of half expressions

Exceptions

FE_INVALID	if x and y are infinities with equal signs or signaling NaNs
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding

Multiplication.

This operation is exact to rounding for all rounding modes.

Parameters

x	left operand
y	right operand

Returns

product of half expressions

Exceptions

FE_INVALID	if multiplying 0 with infinity or if x or y is signaling NaN
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding

Division.

This operation is exact to rounding for all rounding modes.

Parameters

x	left operand
y	right operand

Returns

quotient of half expressions

Exceptions

FE_INVALID	if dividing 0s or infinities with each other or if x or y is signaling NaN
FE_DIVBYZERO	if dividing finite value by 0
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding

Output operator.

This uses the built-in functionality for streaming out floating-point numbers.

Parameters

out	output stream to write into
arg	half expression to write

Returns

reference to output stream

Input operator.

This uses the built-in functionality for streaming in floating-point numbers, specifically double precision floating point numbers (unless overridden with HALF_ARITHMETIC_TYPE). So the input string is first rounded to double precision using the underlying platform’s current floating-point rounding mode before being rounded to half-precision using the library’s half-precision rounding mode.

Parameters

in	input stream to read from
arg	half to read into

Returns

reference to input stream

Exceptions

FE_OVERFLOW,…UNDERFLOW,…INEXACT

according to rounding

Absolute value.

See also: Documentation for std::fabs.

Parameters

arg

operand

Returns

absolute value of arg

Absolute value.

See also: Documentation for std::abs.

Parameters

arg

operand

Returns

absolute value of arg

Remainder of division.

See also: Documentation for std::fmod.

Parameters

x	first operand
y	second operand

Returns

remainder of floating-point division.

Exceptions

FE_INVALID

if x is infinite or y is 0 or if x or y is signaling NaN

Remainder of division.

See also: Documentation for std::remainder.

Parameters

x	first operand
y	second operand

Returns

remainder of floating-point division.

Exceptions

FE_INVALID

if x is infinite or y is 0 or if x or y is signaling NaN

Remainder of division.

See also: Documentation for std::remquo.

Parameters

x	first operand
y	second operand
quo	address to store some bits of quotient at

Returns

remainder of floating-point division.

Exceptions

FE_INVALID

if x is infinite or y is 0 or if x or y is signaling NaN

Fused multiply add.

This function is exact to rounding for all rounding modes.

See also: Documentation for std::fma.

Parameters

x	first operand
y	second operand
z	third operand

Returns

( x * y ) + z rounded as one operation.

Exceptions

FE_INVALID	according to operator*() and operator+() unless any argument is a quiet NaN and no argument is a signaling NaN
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding the final addition

Maximum of half expressions.

See also: Documentation for std::fmax.

Parameters

x	first operand
y	second operand

Returns

maximum of operands, ignoring quiet NaNs

Exceptions

FE_INVALID

if x or y is signaling NaN

Minimum of half expressions.

See also: Documentation for std::fmin.

Parameters

x	first operand
y	second operand

Returns

minimum of operands, ignoring quiet NaNs

Exceptions

FE_INVALID

if x or y is signaling NaN

Positive difference.

This function is exact to rounding for all rounding modes.

See also: Documentation for std::fdim.

Parameters

x	first operand
y	second operand

Returns

x – y or 0 if difference negative

Exceptions

FE_…	according to operator-(half,half)

Get NaN value.

See also: Documentation for std::nan.

Parameters

arg	string code

Returns

quiet NaN

Exponential function.

This function is exact to rounding for all rounding modes.

See also: Documentation for std::exp.

Parameters

arg	function argument

Returns

e raised to arg

Exceptions

FE_INVALID	for signaling NaN
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding

Binary exponential.

This function is exact to rounding for all rounding modes.

See also: Documentation for std::exp2.

Parameters

arg	function argument

Returns

2 raised to arg

Exceptions

FE_INVALID	for signaling NaN
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding

Exponential minus one.

This function may be 1 ULP off the correctly rounded exact result in <0.05% of inputs for std::round_to_nearest and in <1% of inputs for any other rounding mode.

See also: Documentation for std::expm1.

Parameters

arg	function argument

Returns

e raised to arg and subtracted by 1

Exceptions

FE_INVALID	for signaling NaN
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding

Natural logarithm.

This function is exact to rounding for all rounding modes.

See also: Documentation for std::log.

Parameters

arg	function argument

Returns

logarithm of arg to base e

Exceptions

FE_INVALID	for signaling NaN or negative argument
FE_DIVBYZERO	for 0
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding

Common logarithm.

This function is exact to rounding for all rounding modes.

See also: Documentation for std::log10.

Parameters

arg	function argument

Returns

logarithm of arg to base 10

Exceptions

FE_INVALID	for signaling NaN or negative argument
FE_DIVBYZERO	for 0
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding

Binary logarithm.

This function is exact to rounding for all rounding modes.

See also: Documentation for std::log2.

Parameters

arg	function argument

Returns

logarithm of arg to base 2

Exceptions

FE_INVALID	for signaling NaN or negative argument
FE_DIVBYZERO	for 0
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding

Natural logarithm plus one.

This function may be 1 ULP off the correctly rounded exact result in <0.05% of inputs for std::round_to_nearest and in ~1% of inputs for any other rounding mode.

See also: Documentation for std::log1p.

Parameters

arg	function argument

Returns

logarithm of arg plus 1 to base e

Exceptions

FE_INVALID	for signaling NaN or argument <-1
FE_DIVBYZERO	for -1
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding

Square root.

This function is exact to rounding for all rounding modes.

See also: Documentation for std::sqrt.

Parameters

arg	function argument

Returns

square root of arg

Exceptions

FE_INVALID	for signaling NaN and negative arguments
FE_INEXACT	according to rounding

Inverse square root.

This function is exact to rounding for all rounding modes and thus generally more accurate than directly computing 1 / sqrt(arg) in half-precision, in addition to also being faster.

Parameters

arg	function argument

Returns

reciprocal of square root of arg

Exceptions

FE_INVALID	for signaling NaN and negative arguments
FE_INEXACT	according to rounding

Cubic root.

This function is exact to rounding for all rounding modes.

See also: Documentation for std::cbrt.

Parameters

arg	function argument

Returns

cubic root of arg

Exceptions

FE_INVALID	for signaling NaN
FE_INEXACT	according to rounding

Hypotenuse function.

This function is exact to rounding for all rounding modes.

See also: Documentation for std::hypot.

Parameters

x	first argument
y	second argument

Returns

square root of sum of squares without internal over- or underflows

Exceptions

FE_INVALID	if x or y is signaling NaN
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding of the final square root

Hypotenuse function.

This function is exact to rounding for all rounding modes.

See also: Documentation for std::hypot.

Parameters

x	first argument
y	second argument
z	third argument

Returns

square root of sum of squares without internal over- or underflows

Exceptions

FE_INVALID	if x, y or z is signaling NaN
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding of the final square root

Power function.

This function may be 1 ULP off the correctly rounded exact result for any rounding mode in ~0.00025% of inputs.

See also: Documentation for std::pow.

Parameters

x	base
y	exponent

Returns

x raised to y

Exceptions

FE_INVALID	if x or y is signaling NaN or if x is finite an negative and y is finite and not integral
FE_DIVBYZERO	if x is 0 and y is negative
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding

Compute sine and cosine simultaneously.

This returns the same results as sin() and cos() but is faster than calling each function individually.

This function is exact to rounding for all rounding modes.

Parameters

arg	function argument
sin	variable to take sine of arg
cos	variable to take cosine of arg

Exceptions

FE_INVALID	for signaling NaN or infinity
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding

Sine function.

This function is exact to rounding for all rounding modes.

See also: Documentation for std::sin.

Parameters

arg	function argument

Returns

sine value of arg

Exceptions

FE_INVALID	for signaling NaN or infinity
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding

Cosine function.

This function is exact to rounding for all rounding modes.

See also: Documentation for std::cos.

Parameters

arg	function argument

Returns

cosine value of arg

Exceptions

FE_INVALID	for signaling NaN or infinity
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding

Tangent function.

This function is exact to rounding for all rounding modes.

See also: Documentation for std::tan.

Parameters

arg	function argument

Returns

tangent value of arg

Exceptions

FE_INVALID	for signaling NaN or infinity
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding

Arc sine.

This function is exact to rounding for all rounding modes.

See also: Documentation for std::asin.

Parameters

arg	function argument

Returns

arc sine value of arg

Exceptions

FE_INVALID	for signaling NaN or if abs(arg) > 1
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding

Arc cosine function.

This function is exact to rounding for all rounding modes.

See also: Documentation for std::acos.

Parameters

arg	function argument

Returns

arc cosine value of arg

Exceptions

FE_INVALID	for signaling NaN or if abs(arg) > 1
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding

Arc tangent function.

This function is exact to rounding for all rounding modes.

See also: Documentation for std::atan.

Parameters

arg	function argument

Returns

arc tangent value of arg

Exceptions

FE_INVALID	for signaling NaN
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding

Arc tangent function.

This function may be 1 ULP off the correctly rounded exact result in ~0.005% of inputs for std::round_to_nearest, in ~0.1% of inputs for std::round_toward_zero and in ~0.02% of inputs for any other rounding mode.

See also: Documentation for std::atan2.

Parameters

y	numerator
x	denominator

Returns

arc tangent value

Exceptions

FE_INVALID	if x or y is signaling NaN
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding

Hyperbolic sine.

This function is exact to rounding for all rounding modes.

See also: Documentation for std::sinh.

Parameters

arg	function argument

Returns

hyperbolic sine value of arg

Exceptions

FE_INVALID	for signaling NaN
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding

Hyperbolic cosine.

This function is exact to rounding for all rounding modes.

See also: Documentation for std::cosh.

Parameters

arg	function argument

Returns

hyperbolic cosine value of arg

Exceptions

FE_INVALID	for signaling NaN
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding

Hyperbolic tangent.

This function is exact to rounding for all rounding modes.

See also: Documentation for std::tanh.

Parameters

arg	function argument

Returns

hyperbolic tangent value of arg

Exceptions

FE_INVALID	for signaling NaN
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding

Hyperbolic area sine.

This function is exact to rounding for all rounding modes.

See also: Documentation for std::asinh.

Parameters

arg	function argument

Returns

area sine value of arg

Exceptions

FE_INVALID	for signaling NaN
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding

Hyperbolic area cosine.

This function is exact to rounding for all rounding modes.

See also: Documentation for std::acosh.

Parameters

arg	function argument

Returns

area cosine value of arg

Exceptions

FE_INVALID	for signaling NaN or arguments <1
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding

Hyperbolic area tangent.

This function is exact to rounding for all rounding modes.

See also: Documentation for std::atanh.

Parameters

arg	function argument

Returns

area tangent value of arg

Exceptions

FE_INVALID	for signaling NaN or if abs(arg) > 1
FE_DIVBYZERO	for +/-1
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding

Error function.

This function may be 1 ULP off the correctly rounded exact result for any rounding mode in <0.5% of inputs.

See also: Documentation for std::erf.

Parameters

arg	function argument

Returns

error function value of arg

Exceptions

FE_INVALID	for signaling NaN
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding

Complementary error function.

This function may be 1 ULP off the correctly rounded exact result for any rounding mode in <0.5% of inputs.

See also: Documentation for std::erfc.

Parameters

arg	function argument

Returns

1 minus error function value of arg

Exceptions

FE_INVALID	for signaling NaN
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding

Natural logarithm of gamma function.

This function may be 1 ULP off the correctly rounded exact result for any rounding mode in ~0.025% of inputs.

See also: Documentation for std::lgamma.

Parameters

arg	function argument

Returns

natural logarith of gamma function for arg

Exceptions

FE_INVALID	for signaling NaN
FE_DIVBYZERO	for 0 or negative integer arguments
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding

Gamma function.

This function may be 1 ULP off the correctly rounded exact result for any rounding mode in <0.25% of inputs.

See also: Documentation for std::tgamma.

Parameters

arg	function argument

Returns

gamma function value of arg

Exceptions

FE_INVALID	for signaling NaN, negative infinity or negative integer arguments
FE_DIVBYZERO	for 0
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding

Nearest integer not less than half value.

See also: Documentation for std::ceil.

Parameters

arg	half to round

Returns

nearest integer not less than arg

Exceptions

FE_INVALID	for signaling NaN
FE_INEXACT	if value had to be rounded

Nearest integer not greater than half value.

See also: Documentation for std::floor.

Parameters

arg	half to round

Returns

nearest integer not greater than arg

Exceptions

FE_INVALID	for signaling NaN
FE_INEXACT	if value had to be rounded

Nearest integer not greater in magnitude than half value.

See also: Documentation for std::trunc.

Parameters

arg	half to round

Returns

nearest integer not greater in magnitude than arg

Exceptions

FE_INVALID	for signaling NaN
FE_INEXACT	if value had to be rounded

Nearest integer.

See also: Documentation for std::round.

Parameters

arg	half to round

Returns

nearest integer, rounded away from zero in half-way cases

Exceptions

FE_INVALID	for signaling NaN
FE_INEXACT	if value had to be rounded

Nearest integer.

See also: Documentation for std::lround.

Parameters

arg	half to round

Returns

nearest integer, rounded away from zero in half-way cases

Exceptions

FE_INVALID

if value is not representable as long

Nearest integer using half’s internal rounding mode.

See also: Documentation for std::rint.

Parameters

arg	half expression to round

Returns

nearest integer using default rounding mode

Exceptions

FE_INVALID	for signaling NaN
FE_INEXACT	if value had to be rounded

Nearest integer using half’s internal rounding mode.

See also: Documentation for std::lrint.

Parameters

arg	half expression to round

Returns

nearest integer using default rounding mode

Exceptions

FE_INVALID	if value is not representable as long
FE_INEXACT	if value had to be rounded

Nearest integer using half’s internal rounding mode.

See also: Documentation for std::nearbyint.

Parameters

arg	half expression to round

Returns

nearest integer using default rounding mode

Exceptions

FE_INVALID

for signaling NaN

Nearest integer.

See also: Documentation for std::llround.

Parameters

arg	half to round

Returns

nearest integer, rounded away from zero in half-way cases

Exceptions

FE_INVALID

if value is not representable as long long

Nearest integer using half’s internal rounding mode.

See also: Documentation for std::llrint.

Parameters

arg	half expression to round

Returns

nearest integer using default rounding mode

Exceptions

FE_INVALID	if value is not representable as long long
FE_INEXACT	if value had to be rounded

Decompress floating-point number.

See also: Documentation for std::frexp.

Parameters

arg	number to decompress
exp	address to store exponent at

Returns

significant in range [0.5, 1)

Exceptions

FE_INVALID

for signaling NaN

Multiply by power of two.

This function is exact to rounding for all rounding modes.

See also: Documentation for std::scalbln.

Parameters

arg	number to modify
exp	power of two to multiply with

Returns

arg multplied by 2 raised to exp

Exceptions

FE_INVALID	for signaling NaN
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding

Multiply by power of two.

This function is exact to rounding for all rounding modes.

See also: Documentation for std::scalbn.

Parameters

arg	number to modify
exp	power of two to multiply with

Returns

arg multplied by 2 raised to exp

Exceptions

FE_INVALID	for signaling NaN
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding

Multiply by power of two.

This function is exact to rounding for all rounding modes.

See also: Documentation for std::ldexp.

Parameters

arg	number to modify
exp	power of two to multiply with

Returns

arg multplied by 2 raised to exp

Exceptions

FE_INVALID	for signaling NaN
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding

Extract integer and fractional parts.

See also: Documentation for std::modf.

Parameters

arg	number to decompress
iptr	address to store integer part at

Returns

fractional part

Exceptions

FE_INVALID

for signaling NaN

Extract exponent.

See also: Documentation for std::ilogb.

Parameters

arg	number to query

Returns

floating-point exponent

Return values

FP_ILOGB0	for zero
FP_ILOGBNAN	for NaN
INT_MAX	for infinity

Exceptions

FE_INVALID

for 0 or infinite values

Extract exponent.

See also: Documentation for std::logb.

Parameters

arg	number to query

Returns

floating-point exponent

Exceptions

FE_INVALID	for signaling NaN
FE_DIVBYZERO	for 0

Next representable value.

See also: Documentation for std::nextafter.

Parameters

from	value to compute next representable value for
to	direction towards which to compute next value

Returns

next representable value after from in direction towards to

Exceptions

FE_INVALID	for signaling NaN
FE_OVERFLOW	for infinite result from finite argument
FE_UNDERFLOW	for subnormal result

Next representable value.

See also: Documentation for std::nexttoward.

Parameters

from	value to compute next representable value for
to	direction towards which to compute next value

Returns

next representable value after from in direction towards to

Exceptions

FE_INVALID	for signaling NaN
FE_OVERFLOW	for infinite result from finite argument
FE_UNDERFLOW	for subnormal result

Take sign.

See also: Documentation for std::copysign.

Parameters

x	value to change sign for
y	value to take sign from

Returns

value equal to x in magnitude and to y in sign

Classify floating-point value.

See also: Documentation for std::fpclassify.

Parameters

arg	number to classify

Return values

FP_ZERO	for positive and negative zero
FP_SUBNORMAL	for subnormal numbers
FP_INFINITY	for positive and negative infinity
FP_NAN	for NaNs
FP_NORMAL	for all other (normal) values

Check if finite number.

See also: Documentation for std::isfinite.

Parameters

arg	number to check

Return values

true	if neither infinity nor NaN
false	else

Check for infinity.

See also: Documentation for std::isinf.

Parameters

arg	number to check

Return values

true	for positive or negative infinity
false	else

Check for NaN.

See also: Documentation for std::isnan.

Parameters

arg	number to check

Return values

true	for NaNs
false	else

Check if normal number.

See also: Documentation for std::isnormal.

Parameters

arg	number to check

Return values

true	if normal number
false	if either subnormal, zero, infinity or NaN

Check sign.

See also: Documentation for std::signbit.

Parameters

arg	number to check

Return values

true	for negative number
false	for positive number

Quiet comparison for greater than.

See also: Documentation for std::isgreater.

Parameters

x	first operand
y	second operand

Return values

true	if x greater than y
false	else

Quiet comparison for greater equal.

See also: Documentation for std::isgreaterequal.

Parameters

x	first operand
y	second operand

Return values

true	if x greater equal y
false	else

Quiet comparison for less than.

See also: Documentation for std::isless.

Parameters

x	first operand
y	second operand

Return values

true	if x less than y
false	else

Quiet comparison for less equal.

See also: Documentation for std::islessequal.

Parameters

x	first operand
y	second operand

Return values

true	if x less equal y
false	else

Quiet comarison for less or greater.

See also: Documentation for std::islessgreater.

Parameters

x	first operand
y	second operand

Return values

true	if either less or greater
false	else

Quiet check if unordered.

See also: Documentation for std::isunordered.

Parameters

x	first operand
y	second operand

Return values

true	if unordered (one or two NaN operands)
false	else

Cast to or from half-precision floating-point number.

This casts between half and any built-in arithmetic type. The values are converted directly using the default rounding mode, without any roundtrip over float that a static_cast would otherwise do.

Using this cast with neither of the two types being a half or with any of the two types not being a built-in arithmetic type (apart from half, of course) results in a compiler error and casting between halfs returns the argument unmodified.

Template Parameters

T	destination type (half or built-in arithmetic type)
U	source type (half or built-in arithmetic type)

Parameters

arg	value to cast

Returns

arg converted to destination type

Exceptions

FE_INVALID	if T is integer type and result is not representable as T
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding

Cast to or from half-precision floating-point number.

This casts between half and any built-in arithmetic type. The values are converted directly using the specified rounding mode, without any roundtrip over float that a static_cast would otherwise do.

Using this cast with neither of the two types being a half or with any of the two types not being a built-in arithmetic type (apart from half, of course) results in a compiler error and casting between halfs returns the argument unmodified.

Template Parameters

T	destination type (half or built-in arithmetic type)
R	rounding mode to use.
U	source type (half or built-in arithmetic type)

Parameters

arg	value to cast

Returns

arg converted to destination type

Exceptions

FE_INVALID	if T is integer type and result is not representable as T
FE_OVERFLOW,…UNDERFLOW,…INEXACT	according to rounding

Clear exception flags.

This function works even if automatic exception flag handling is disabled, but in that case manual flag management is the only way to raise flags.

See also: Documentation for std::feclearexcept.

Parameters

excepts

OR of exceptions to clear

Return values

0	all selected flags cleared successfully

Test exception flags.

This function works even if automatic exception flag handling is disabled, but in that case manual flag management is the only way to raise flags.

See also: Documentation for std::fetestexcept.

Parameters

excepts

OR of exceptions to test

Returns

OR of selected exceptions if raised

Raise exception flags.

This raises the specified floating point exceptions and also invokes any additional automatic exception handling as configured with the HALF_ERRHANDLIG_… preprocessor symbols. This function works even if automatic exception flag handling is disabled, but in that case manual flag management is the only way to raise flags.

See also: Documentation for std::feraiseexcept.

Parameters

excepts

OR of exceptions to raise

Return values

0	all selected exceptions raised successfully

Save exception flags.

This function works even if automatic exception flag handling is disabled, but in that case manual flag management is the only way to raise flags.

See also: Documentation for std::fegetexceptflag.

Parameters

flagp	adress to store flag state at
excepts	OR of flags to save

Return values

0	for success

Restore exception flags.

This only copies the specified exception state (including unset flags) without incurring any additional exception handling. This function works even if automatic exception flag handling is disabled, but in that case manual flag management is the only way to raise flags.

See also: Documentation for std::fesetexceptflag.

Parameters

flagp	adress to take flag state from
excepts	OR of flags to restore

Return values

0	for success

Throw C++ exceptions based on set exception flags.

This function manually throws a corresponding C++ exception if one of the specified flags is set, no matter if automatic throwing (via HALF_ERRHANDLING_THROW_…) is enabled or not. This function works even if automatic exception flag handling is disabled, but in that case manual flag management is the only way to raise flags.

Parameters

excepts	OR of exceptions to test
msg	error message to use for exception description

Exceptions

std::domain_error	if FE_INVALID or FE_DIVBYZERO is selected and set
std::overflow_error	if FE_OVERFLOW is selected and set
std::underflow_error	if FE_UNDERFLOW is selected and set
std::range_error	if FE_INEXACT is selected and set