MATH

Overview

Provides math functions, such as trigonometric, exponential, logarithmic functions,and perform operations on complex numbers.

Since:

1.0

Version:

1.0

Summary

Files

File Name

Description

complex.h

Declares functions to perform operations on complex numbers.

fenv.h

Declares specific functions for performing operations for floating-point exceptions and rounding modes.

math.h

Provides common math functions.

Data Structures

Data Structure Name

Description

fenv_t

Defines the floating-point environment.

Macros

Macro Name and Value

Description

complex    _Complex

Indicates the type of a complex number.

FE_INVALID    1

Indicates an invalid floating-point exception. At least one parameter value is not defined in the function.

FE_DIVBYZERO    2

Indicates a pole error exception. The return value is asymptotically infinite when the divisor is zero or the input is asymptotic to zero.

FE_OVERFLOW    4

Indicates an overflow floating-point exception. The result is too large to be represented in the normal return value.

FE_UNDERFLOW    8

Indicates an underflow floating-point exception. The result is too small to be represented in the normal return value.

FE_INEXACT    16

Indicates an inexact floating-point exception.

FE_ALL_EXCEPT    31

Indicates bitwise OR of all the preceding supported floating-point exceptions.

FE_TONEAREST    0

Indicates rounding towards the nearest integer.

FE_DOWNWARD    0x800000

Indicates rounding towards negative infinity.

FE_UPWARD    0x400000

Indicates rounding towards positive infinity.

FE_TOWARDZERO    0xc00000

Indicates rounding towards zero.

FE_DFL_ENV    ((const fenv_t) -1)

Defines the default floating-point environment.

NAN    (0.0f/0.0f)

Indicates an undefined or unrepresentable value.

INFINITY    1e5000f

Indicates an infinity.

HUGE_VALF    INFINITY

Indicates a float infinity.

HUGE_VAL    ((double)INFINITY)

Indicates a double infinity.

HUGE_VALL    ((long double)INFINITY)

Indicates a long double infinity.

MATH_ERRNO    1

Indicates an error that occurs in floating-point operations.

MATH_ERREXCEPT    2

Indicates a floating-point exception.

math_errhandling    2

Indicates the error handling mechanism employed by math functions.

FP_ILOGBNAN    (-1-0x7fffffff)

Indicates the calculation result of ilogb(NAN).

FP_ILOGB0    FP_ILOGBNAN

Indicates the calculation result of ilogb(0).

FP_NAN    0

Indicates a Not-a-Number (NaN) value.

FP_INFINITE    1

Indicates an infinity.

FP_ZERO    2

Indicates value 0.

FP_SUBNORMAL    3

Indicates a subnormal.

FP_NORMAL    4

Indicates a normal value.

isinf(x)

Checks whether the floating-point value x is an infinity.

isnan(x)

Checks whether the floating-point value x is a NaN value.

isnormal(x)

Checks whether the floating-point value x is a normal value.

isfinite(x)

Checks whether the floating-point value x is finite.

signbit(x)

Checks whether the sign of the floating-point value x is negative.

isunordered(x, y)   (isnan((x)) ? ((void)(y),1) : isnan((y)))

Checks whether floating-point value x or y is unordered.

isless(x, y)   tg_pred_2(x, y, isless)

Checks whether floating-point value x is less than y.

islessequal(x, y)   tg_pred_2(x, y, islessequal)

Checks whether floating-point value x is less than or equal to y.

islessgreater(x, y)   tg_pred_2(x, y, islessgreater)

Checks whether floating-point value x is either less than or greater than y.

isgreater(x, y)   tg_pred_2(x, y, isgreater)

Checks whether floating-point value x is greater than y.

isgreaterequal(x, y)   tg_pred_2(x, y, isgreaterequal)

Checks whether floating-point value x is greater than or equal to y.

MAXFLOAT    3.40282346638528859812e+38F

Maximum value of type float.

M_E    2.7182818284590452354 / e /

Base e of natural logarithms.

M_LOG2E    1.4426950408889634074 / log_2 e /

Logarithm to base 2 of M_E

M_LOG10E    0.43429448190325182765 / log_10 e /

Logarithm to base 10 of M_E

M_LN2    0.69314718055994530942 / log_e 2 /

Natural logarithm of 2

M_LN10    2.30258509299404568402 / log_e 10 /

Natural logarithm of 10

M_PI    3.14159265358979323846 / pi /

Ratio of a circle’s circumference to its diameter.

M_PI_2    1.57079632679489661923 / pi/2 /

Pi divided by 2

M_PI_4    0.78539816339744830962 / pi/4 /

Pi divided by 4

M_1_PI    0.31830988618379067154 / 1/pi /

Reciprocal of pi.

M_2_PI    0.63661977236758134308 / 2/pi /

Two times the reciprocal of pi.

M_2_SQRTPI    1.12837916709551257390 / 2/sqrt(pi) /

Two times the reciprocal of the square root of pi.

M_SQRT2    1.41421356237309504880 / sqrt(2) /

Square root of 2

M_SQRT1_2    0.70710678118654752440 / 1/sqrt(2) */

Reciprocal of the square root of 2

Typedefs

Typedef Name

Description

fexcept_t

typedef unsigned long 

Floating-point exception type.

Functions

Function Name

Description

cacos (double complex z)

double complex 

Calculates the arc cosine of the complex number z.

cacosf (float complex z)

float complex 

Calculates the arc cosine of the complex number z.

cacosl (long double complex z)

long double complex 

Calculates the arc cosine of the complex number z.

casin (double complex z)

double complex 

Calculates the arc sine of the complex number z.

casinf (float complex z)

float complex 

Calculates the arc sine of the complex number z.

casinl (long double complex z)

long double complex 

Calculates the arc sine of the complex number z.

catan (double complex z)

double complex 

Calculates the arc tangent of the complex number z.

catanf (float complex z)

float complex 

Calculates the arc tangent of the complex number z.

catanl (long double complex z)

long double complex 

Calculates the arc tangent of the complex number z.

ccos (double complex z)

double complex 

Calculates the cosine of the complex number z.

ccosf (float complex z)

float complex 

Calculates the cosine of the complex number z.

ccosl (long double complex z)

long double complex 

Calculates the cosine of the complex number z.

csin (double complex z)

double complex 

Calculates the sine of the complex number z.

csinf (float complex z)

float complex 

Calculates the sine of the complex number z.

csinl (long double complex z)

long double complex 

Calculates the sine of the complex number z.

ctan (double complex z)

double complex 

Calculates the tangent of the complex number z.

ctanf (float complex z)

float complex 

Calculates the tangent of the complex number z.

ctanl (long double complex z)

long double complex 

Calculates the tangent of the complex number z.

cacosh (double complex z)

double complex 

Calculates the inverse hyperbolic cosine of the complex number z.

cacoshf (float complex z)

float complex 

Calculates the inverse hyperbolic cosine of the complex number z.

cacoshl (long double complex z)

long double complex 

Calculates the inverse hyperbolic cosine of the complex number z.

casinh (double complex z)

double complex 

Calculates the inverse hyperbolic sine of the complex number z.

casinhf (float complex z)

float complex 

Calculates the inverse hyperbolic sine of the complex number z.

casinhl (long double complex z)

long double complex 

Calculates the inverse hyperbolic sine of the complex number z.

catanh (double complex z)

double complex 

Calculates the inverse hyperbolic tangent of the complex number z.

catanhf (float complex z)

float complex 

Calculates the inverse hyperbolic tangent of the complex number z.

catanhl (long double complex z)

long double complex 

Calculates the inverse hyperbolic tangent of the complex number z.

ccosh (double complex z)

double complex 

Calculates the hyperbolic cosine of the complex number z.

ccoshf (float complex z)

float complex 

Calculates the hyperbolic cosine of the complex number z.

ccoshl (long double complex z)

long double complex 

Calculates the hyperbolic cosine of the complex number z.

csinh (double complex z)

double complex 

Calculates the hyperbolic sine of the complex number z.

csinhf (float complex z)

float complex 

Calculates the hyperbolic sine of the complex number z.

csinhl (long double complex z)

long double complex 

Calculates the hyperbolic sine of the complex number z.

ctanh (double complex z)

double complex 

Calculates the hyperbolic tangent of the complex number z.

ctanhf (float complex z)

float complex 

Calculates the hyperbolic tangent of the complex number z.

ctanhl (long double complex z)

long double complex 

Calculates the hyperbolic tangent of the complex number z.

cexp (double complex z)

double complex 

Calculates the base-e exponential of the complex number z.

cexpf (float complex z)

float complex 

Calculates the base-e exponential of the complex number z.

cexpl (long double complex z)

long double complex 

Calculates the base-e exponential of the complex number z.

clog (double complex z)

double complex 

Calculates the natural (base-e) logarithm of the complex number z.

clogf (float complex z)

float complex 

Calculates the natural (base-e) logarithm of the complex number z.

clogl (long double complex z)

long double complex 

Calculates the natural (base-e) logarithm of the complex number z.

cabs (double complex z)

double 

Calculates the absolute value of the complex number z.

cabsf (float complex z)

float 

Calculates the absolute value of the complex number z.

cabsl (long double complex z)

long double 

Calculates the absolute value of the complex number z.

cpow (double complex x, double complex z)

double complex 

Calculates the value of x raised to the z power.

cpowf (float complex x, float complex z)

float complex 

Calculates the value of x raised to the z power.

cpowl (long double complex x, long double complex z)

long double complex 

Calculates the value of x raised to the z power.

csqrt (double complex z)

double complex 

Calculates the square root of the complex number z.

csqrtf (float complex z)

float complex 

Calculates the square root of the complex number z.

csqrtl (long double complex z)

long double complex 

Calculates the square root of the complex number z.

carg (double complex z)

double 

Calculates the phase angle of the complex number z.

cargf (float complex z)

float 

Calculates the phase angle of the complex number z.

cargl (long double complex z)

long double 

Calculates the phase angle of the complex number z.

cimag (double complex z)

double 

Calculates the imaginary part of the complex number z.

cimagf (float complex z)

float 

Calculates the imaginary part of the complex number z.

cimagl (long double complex z)

long double 

Calculates the imaginary part of the complex number z.

conj (double complex z)

double complex 

Calculates the conjugate of the complex number z.

conjf (float complex z)

float complex 

Calculates the conjugate of the complex number z.

conjl (long double complex z)

long double complex 

Calculates the conjugate of the complex number z.

cproj (double complex z)

double complex 

Calculates the projection of the complex number z onto the Riemann sphere.

cprojf (float complex z)

float complex 

Calculates the projection of the complex number z onto the Riemann sphere.

cprojl (long double complex z)

long double complex 

Calculates the projection of the complex number z onto the Riemann sphere.

creal (double complex z)

double 

Calculates the real part of the complex number z.

crealf (float complex z)

float 

Calculates the real part of the complex number z.

creall (long double complex z)

long double 

Calculates the real part of the complex number z.

feclearexcept (int excepts)

int 

Clears floating-point exceptions specified by excepts.

fegetexceptflag (fexcept_tflagp, int excepts)

int 

Stores the floating-point exceptions specified by excepts into the flagp variable address.

feraiseexcept (int excepts)

int 

Obtains the floating-point exceptions specified by excepts.

fesetexceptflag (const fexcept_t flagp, int excepts)

int 

Sets the exception status flag by copying the floating-point exceptions stored in the flagp address to the excepts parameter.

fetestexcept (int excepts)

int 

Checks whether the floating-point exceptions specified by excepts have been raised.

fegetround (void)

int 

Obtains the macro corresponding to the current rounding mode.

fesetround (int rounding_mode)

int 

Sets the rounding mode.

fegetenv (fenv_tenvp)

int 

Stores the current floating-point environment into the object specified by envp.

feholdexcept (fenv_t envp)

int 

Stores the current floating-point environment into the object specified by envp, with all status flags cleared.

fesetenv (const fenv_tenvp)

int 

Sets the current floating-point environment.

feupdateenv (const fenv_t envp)

int 

Updates the current floating-point environment from the object specified by envp.

acos (double x)

double 

Calculates the arc cosine of the double value x.

acosf (float x)

float 

Calculates the arc cosine of the float value x.

acosl (long double x)

long double 

Calculates the arc cosine of the long double value x.

acosh (double x)

double 

Calculates the inverse hyperbolic cosine of the double value x.

acoshf (float x)

float 

Calculates the inverse hyperbolic cosine of float value x.

acoshl (long double x)

long double 

Calculates the inverse hyperbolic cosine of the long double value x.

asin (double x)

double 

Calculates the arc sine of the double value x.

asinf (float x)

float 

Calculates the arc sine of the float value x.

asinl (long double x)

long double 

Calculates the arc sine of the long double value x.

asinh (double x)

double 

Calculates the inverse hyperbolic sine of the double value x.

asinhf (float x)

float 

Calculates the inverse hyperbolic sine of the float value x.

asinhl (long double x)

long double 

Calculates the inverse hyperbolic sine of the long double value x.

atan (double x)

double 

Calculates the arc tangent of the double value x.

atanf (float x)

float 

Calculates the arc tangent of the float value x.

atanl (long double x)

long double 

Calculates the arc tangent of the long double value x.

atan2 (double y, double x)

double 

Calculates the arc tangent of two double values x and y.

atan2f (float y, float x)

float 

Calculates the arc tangent of two float values x and y.

atan2l (long double y, long double x)

long double 

Calculates the arc tangent of two long double values x and y.

atanh (double x)

double 

Calculates the inverse hyperbolic tangent of the double value x.

atanhf (float x)

float 

Calculates the inverse hyperbolic tangent of the float value x.

atanhl (long double x)

long double 

Calculates the inverse hyperbolic tangent of the long double value x.

cbrt (double x)

double 

Calculates the cube root of the double value x.

cbrtf (float x)

float 

Calculates the cube root of the float value x.

cbrtl (long double x)

long double 

Calculates the cube root of the long double value x.

ceil (double x)

double 

Calculates the minimum integer greater than or equal to the double value x.

ceilf (float x)

float 

Calculates the minimum integer greater than or equal to the float value x.

ceill (long double x)

long double 

Calculates the minimum integer greater than or equal to the long double value x.

copysign (double x, double y)

double 

Generates a value by combining the magnitude of the double value x and the sign of the double value y.

copysignf (float x, float y)

float 

Generates a value by combining the magnitude of the float value x and the sign of the float value y.

copysignl (long double x, long double y)

long double 

Generates a value by combining the magnitude of the long double value x and the sign of the long double value y.

cos (double x)

double 

Calculates the cosine of the double value x.

cosf (float x)

float 

Calculates the cosine of the float value x.

cosl (long double x)

long double 

Calculates the cosine of the long double value x.

cosh (double x)

double 

Calculates the hyperbolic cosine of the double value x.

coshf (float x)

float 

Calculates the hyperbolic cosine of the float value x.

coshl (long double x)

long double 

Calculates the hyperbolic cosine of the long double value x.

erf (double x)

double 

Calculates the error function of the double value x.

erff (float x)

float 

Calculates the error function of the float value x.

erfl (long double x)

long double 

Calculates the error function of the long double value x.

erfc (double x)

double 

Calculates the complementary error function of the double value x.

erfcf (float x)

float 

Calculates the complementary error function of the float value x.

erfcl (long double x)

long double 

Calculates the complementary error function of the long double value x.

exp (double x)

double 

Calculates the base-e exponential function of the double value x.

expf (float x)

float 

Calculates the base-e exponential function of the float value x.

expl (long double x)

long double 

Calculates the base-e exponential function of the long double value x.

exp2 (double x)

double 

Calculates the base-2 exponential function of the double value x.

exp2f (float x)

float 

Calculates the base-2 exponential function of the float value x.

exp2l (long double x)

long double 

Calculates the base-2 exponential function of the long double value x.

expm1 (double x)

double 

Calculates e raised to the power of the double value x minus one, that is, (e^x)-1.

expm1f (float x)

float 

Calculates e raised to the power of the float value x minus one.

expm1l (long double x)

long double 

Calculates e raised to the power of the long double value x minus one.

fabs (double x)

double 

Calculates the absolute value of the double value x.

fabsf (float x)

float 

Calculates the absolute value of the float value x.

fabsl (long double x)

long double 

Calculates the absolute value of the long double value x.

fdim (double x, double y)

double 

Calculates the positive difference between the double value x and y.

fdimf (float x, float y)

float 

Calculates the positive difference between the float value x and y.

fdiml (long double x, long double y)

long double 

Calculates the positive difference between the long double value x and y.

floor (double x)

double 

Obtains the largest integer less than or equal to the double value x.

floorf (float x)

float 

Obtains the largest integer less than or equal to the float value x.

floorl (long double x)

long double 

Obtains the largest integer less than or equal to the long double value x.

fma (double x, double y, double z)

double 

Calculates the value of xy+z and rounds the result up.

fmaf (float x, float y, float z)

float 

Calculates the value of xy+z and rounds the result up.

fmal (long double x, long double y, long double z)

long double 

Calculates the value of xy+z and rounds the result up.

fmax (double x, double y)

double 

Obtains the larger value of two double values x and y.

fmaxf (float x, float y)

float 

Obtains the larger value of two float values x and y.

fmaxl (long double x, long double y)

long double 

Obtains the larger value of two long double values x and y.

fmin (double x, double y)

double 

Obtains the smaller value of two double values x and y.

fminf (float x, float y)

float 

Obtains the smaller value of two float values x and y.

fminl (long double x, long double y)

long double 

Obtains the smaller value of two long double values x and y.

fmod (double x, double y)

double 

Calculates the remainder of the double value x divided by the double value y.

fmodf (float x, float y)

float 

Calculates the remainder of the float value x divided by the float value y.

fmodl (long double x, long double y)

long double 

Calculates the remainder of the long double value x divided by the long double value y.

frexp (double x, int exp)

double 

Decomposes the double value x into a significand and an integral exponent for 2.

frexpf (float x, int exp)

float 

Decomposes float value x into a binary significand and an integral exponent for 2.

frexpl (long double x, int exp)

long double 

Decomposes long double value x into a binary significand and an integral exponent for 2.

hypot (double x, double y)

double 

Calculates the hypotenuse of a right triangle whose legs are x and y.

hypotf (float x, float y)

float 

Calculates the hypotenuse of a right triangle whose legs are x and y.

hypotl (long double x, long double y)

long double 

Calculates the hypotenuse of a right triangle whose legs are x and y.

ilogb (double x)

int 

Obtains the integral part of the logarithm of double value x.

ilogbf (float x)

int 

Obtains the integral part of the logarithm of float value x.

ilogbl (long double x)

int 

Obtains the integral part of the logarithm of the long double value x.

ldexp (double x, int exp)

double 

Multiplies the double value x by 2 raised to the power of exp.

ldexpf (float x, int exp)

float 

Multiplies the float value x by 2 raised to the power of exp.

ldexpl (long double x, int exp)

long double 

Multiplies the long double value x by 2 raised to the power of exp.

lgamma (double x)

double 

Calculates the natural logarithm of the absolute value of the gamma function of the double value x.

lgammaf (float x)

float 

Calculates the natural logarithm of the absolute value of the gamma function of the float value x.

lgammal (long double x)

long double 

Calculates the natural logarithm of the absolute value of the gamma function of the long double value x.

llrint (double x)

long long int 

Rounds double value x to the nearest integer.

llrintf (float x)

long long int 

Rounds float value x to the nearest integer.

llrintl (long double x)

long long int 

Rounds long double value x to the nearest integer.

llround (double x)

long long int 

Rounds double value x to the nearest integer, rounding away from 0.

llroundf (float x)

long long int 

Rounds float value x to the nearest integer, rounding away from 0.

llroundl (long double x)

long long int 

Rounds long double value x to the nearest integer, rounding away from 0.

log (double x)

double 

Calculates the natural logarithm of the double value x.

logf (float x)

float 

Calculates the natural logarithm of the float value x.

logl (long double x)

long double 

Calculates the natural logarithm of the long double value x.

log10 (double x)

double 

Calculates the common logarithm (logarithm with base 10) of the double value x.

log10f (float x)

float 

Calculates the common logarithm (logarithm with base 10) of the float value x.

log10l (long double x)

long double 

Calculates the common logarithm (logarithm with base 10) of the long double value x.

log1p (double x)

double 

Calculates the natural logarithm of one plus the double value x.

log1pf (float x)

float 

Calculates the natural logarithm of one plus the float value x.

log1pl (long double x)

long double 

Calculates the natural logarithm of one plus the long double value x.

log2 (double x)

double 

Calculates the binary logarithm (logarithm with base 2) of the double value x.

log2f (float x)

float 

Calculates the binary logarithm (logarithm with base 2) of the float value x.

log2l (long double x)

long double 

Calculates the binary logarithm (logarithm with base 2) of the long double value x.

logb (double x)

double 

Calculates the logarithm of the absolute value of the double value x.

logbf (float x)

float 

Calculates the logarithm of the absolute value of the float value x.

logbl (long double x)

long double 

Calculates the logarithm of the absolute value of the long double value x.

lrint (double x)

long int 

Rounds the double value x to the nearest integer.

lrintf (float x)

long int 

Rounds the float value x to the nearest integer.

lrintl (long double x)

long int 

Rounds the long double value x to the nearest integer.

lround (double x)

long int 

Rounds double value x to the nearest integer, rounding away from 0.

lroundf (float x)

long int 

Rounds the float value x to the nearest integer, rounding away from 0.

lroundl (long double x)

long int 

Rounds the long double value x to the nearest integer, rounding away from 0.

modf (double x, double iptr)

double 

Breaks the double value x into a signed integral and a fractional part.

modff (float x, float iptr)

float 

Breaks the float value x into a signed integral and a fractional part.

modfl (long double x, long double iptr)

long double 

Breaks the long double value x into a signed integral and a fractional part.

nan (const char tagp)

double 

Obtains a quiet NaN value of the double type.

nanf (const char tagp)

float 

Obtains a quiet NaN value of the float type.

nanl (const char tagp)

long double 

Obtains a quiet NaN value of the long double type.

nearbyint (double x)

double 

Rounds the double value x to an integer in floating-point format.

nearbyintf (float x)

float 

Rounds the float value x to an integer in floating-point format.

nearbyintl (long double x)

long double 

Rounds the long double value x to an integer in floating-point format.

nextafter (double x, double y)

double 

Obtains the next representable value following the double value x in the direction of the double value y.

nextafterf (float x, float y)

float 

Obtains the next representable value following the float value x in the direction of the float value y.

nextafterl (long double x, long double y)

long double 

Obtains the next representable value following the long double value x in the direction of the long double value y.

nexttoward (double x, long double y)

double 

Obtains the next representable value following the double value x in the direction of the long double value y.

nexttowardf (float x, long double y)

float 

Obtains the next representable value following the float value x in the direction of the long double value y.

nexttowardl (long double x, long double y)

long double 

Obtains the next representable value following the long double value x in the direction of the long double value y.

pow (double x, double y)

double 

Obtains the double value x raised to the power of the double value y.

powf (float x, float y)

float 

Obtains the float value x raised to the power of the float value y.

powf10 (float x)

float 

Calculates the xth power of 10.

powl (long double x, long double y)

long double 

Obtains the long double value x raised to the power of the long double value y.

powl10 (long double x)

long double 

Calculates the xth power of 10.

remainder (double x, double y)

double 

Calculates the remainder of the double value x divided by the double value y.

remainderf (float x, float y)

float 

Calculates the remainder of the float value x divided by the float value y.

remainderl (long double x, long double y)

long double 

Calculates the remainder of the long double value x divided by the long double value y.

remquo (double x, double y, int quo)

double 

Calculates the quotient and remainder of the double value x divided by the double value y.

remquof (float x, float y, int quo)

float 

Calculates the quotient and remainder of the float value x divided by the float value y.

remquol (long double x, long double y, int quo)

long double 

Calculates the quotient and remainder of the long double value x divided by the long double value y.

rint (double x)

double 

Rounds the double value x to the nearest integer.

rintf (float x)

float 

Rounds the float value x to the nearest integer.

rintl (long double x)

long double 

Rounds the long double value x to the nearest integer.

round (double x)

double 

Rounds the double value x to the nearest integer, rounding away from 0.

roundf (float x)

float 

Rounds the float value x to the nearest integer, rounding away from 0.

roundl (long double x)

long double 

Rounds the long double value x to the nearest integer, rounding away from 0.

scalbln (double x, long int exp)

double 

Multiplies the double value x by FLT_RADIX raised to the power of the long int value exp, that is, x(FLT_RADIX)^exp.

scalblnf (float x, long int exp)

float 

Multiplies the float value x by FLT_RADIX raised to the power of the long int value exp, that is, x(FLT_RADIX)^exp.

scalblnl (long double x, long int exp)

long double 

Multiplies the long double value x by FLT_RADIX raised to the power of the long int value exp, that is, x(FLT_RADIX)^exp.

scalbn (double x, int exp)

double 

Multiplies the double value x by FLT_RADIX raised to the power of the int value exp, that is, x(FLT_RADIX)^exp.

scalbnf (float x, int exp)

float 

Multiplies the float value x by FLT_RADIX raised to the power of the int value exp, that is, x(FLT_RADIX)^exp.

scalbnl (long double x, int exp)

long double 

Multiplies the long double value x by FLT_RADIX raised to the power of the int value exp, that is, x(FLT_RADIX)^exp.

sin (double x)

double 

Calculates the sine of the double value x.

sinf (float x)

float 

Calculates the sine of the float value x.

sinl (long double x)

long double 

Calculates the sine of the long double value x.

sinh (double x)

double 

Calculates the hyperbolic sine of the double value x.

sinhf (float x)

float 

Calculates the hyperbolic sine of the float value x.

sinhl (long double x)

long double 

Calculates the hyperbolic sine of the long double value x.

sqrt (double x)

double 

Calculates the square root of double value x.

sqrtf (float x)

float 

Calculates the square root of the float value x.

sqrtl (long double x)

long double 

Calculates the square root of the long double value x.

tan (double x)

double 

Calculates the tangent of the double value x.

tanf (float x)

float 

Calculates the tangent of the float value x.

tanl (long double x)

long double 

Calculates the tangent of the long double value x.

tanh (double x)

double 

Calculates the hyperbolic tangent of the double value x.

tanhf (float x)

float 

Calculates the hyperbolic tangent of the float value x.

tanhl (long double x)

long double 

Calculates the hyperbolic tangent of the long double value x.

tgamma (double x)

double 

Calculates the gamma function of the double value x.

tgammaf (float x)

float 

Calculates the gamma function of the float value x.

tgammal (long double x)

long double 

Calculates the gamma function of the long double value x.

trunc (double x)

double 

Obtains the nearest integer whose absolute value is less than or equal to the absolute value of the double value x.

truncf (float x)

float 

Obtains the nearest integer whose absolute value is less than or equal to the absolute value of the float value x.

truncl (long double x)

long double 

Obtains the nearest integer whose absolute value is less than or equal to the absolute value of the long double value x.

j0 (double x)

double 

Calculates the Bessel function of the first kind of order 0 for the double value x.

j1 (double x)

double 

Calculates the Bessel function of the first kind of order 1 for the double value x.

jn (int n, double x)

double 

Calculates the Bessel function of the first kind of order n for the double value x.

y0 (double x)

double 

Calculates the Bessel function of the second kind of order 0 for the double value x.

y1 (double x)

double 

Calculates the Bessel function of the second kind of order 1 for the double value x.

yn (int n, double x)

double 

Calculates the Bessel function of the second kind of order n for the double value x.

finite (double x)

int 

Checks whether the double value x is an infinity or a NaN value.

finitef (float x)

int 

Checks whether the float value x is an infinity or a NaN value.

scalb (double x, double exp)

double 

Multiplies the double value x by FLT_RADIX raised to the power of the double value exp, that is, xFLT_RADIX^exp.

scalbf (float x, float exp)

float 

Multiplies the float value x by FLT_RADIX raised to the power of the float value exp, that is, xFLT_RADIX^exp.

significand (double x)

double 

Obtains the significand of the double value x scaled to the range [1,2).

significandf (float x)

float 

Obtains the significand of the float value x scaled to the range [1,2).

j0f (float x)

float 

Calculates the Bessel function of the first kind of order 0 for the float value x.

j1f (float x)

float 

Calculates the Bessel function of the first kind of order 1 for the float value x.

jnf (int n, float x)

float 

Calculates the Bessel function of the first kind of order n for the float value x.

y0f (float x)

float 

Calculates the Bessel function of the second kind of order 0 for the float value x.

y1f (float x)

float 

Calculates the Bessel function of the second kind of order 1 for the float value x.

ynf (int n, float x)

float 

Calculates the Bessel function of the second kind of order n for the float value x.

lgammal_r (long double x, int signp)

long double 

Calculates the natural logarithm of the absolute value of the gamma function of the double value x.

sincos (double x, double sin, double cos)

void 

Calculates the sine and cosine of the double value x.

sincosf (float x, float sin, float cos)

void 

Calculates the sine and cosine of the float value x.

sincosl (long double x, long double sin, long double cos)

void 

Calculates the sine and cosine of the long double value x.

exp10 (double x)

double 

Calculates the base-10 exponential function of the double value x.

exp10f (float x)

float 

Calculates the base-10 exponential function of the float value x.

exp10l (long double x)

long double 

Calculates the base-10 exponential function of the long double value x.

pow10 (double x)

double 

Calculates the value of 10 raised to the power x, which is a double value.

pow10f (float x)

float 

Calculates the value of 10 raised to the power x, which is a float value.

pow10l (long double x)

long double 

Calculates the value of 10 raised to the power x, which is a long double value.

Details

Macro Definition Documentation

isfinite

  1. #define isfinite( x)
  1. Values:( \
  2. sizeof(x)==sizeof(float)?(__FLOAT_BITS(x)&0x7fffffff)<0x7f800000: \
  3. sizeof(x)==sizeof(double)?(__DOUBLE_BITS(x)&-1ULL>>1)<0x7ffULL<<52: \
  4. __fpclassifyl(x)>[FP_INFINITE](MATH.md#ga4f64bcc64f8b84dd9daf5a4e56abf0ca))

Description:

Checks whether the floating-point value x is finite.

A finite value is any value that is neither an infinity nor a NaN value.

Parameters:

Name

Description

xIndicates the floating-point value x to check.

Returns:

Returns 1 if x is finite; returns 0 otherwise.

isgreater

  1. #define isgreater( x, y ) __tg_pred_2(x, y, __isgreater)

Description:

Checks whether floating-point value x is greater than y.

Parameters:

Name

Description

xIndicates the floating-point value x to check.
yIndicates the floating-point value y to check.

Attention:

If either or both of x and y are a NaN value, an exception occurs. This function requires hardware support.

Returns:

Returns 1 if x is greater than y; returns 0 otherwise.

isgreaterequal

  1. #define isgreaterequal( x, y ) __tg_pred_2(x, y, __isgreaterequal)

Description:

Checks whether floating-point value x is greater than or equal to y.

Parameters:

Name

Description

xIndicates the floating-point value x to check.
yIndicates the floating-point value y to check.

Attention:

If either or both of x and y are a NaN value, an exception occurs. This function requires hardware support.

Returns:

Returns 1 if x is greater than or equal to y; returns 0 otherwise.

isinf

  1. #define isinf( x)
  1. Values:( \
  2. sizeof(x)==sizeof(float)?(__FLOAT_BITS(x)&0x7fffffff)==0x7f800000: \
  3. sizeof(x)==sizeof(double)?(__DOUBLE_BITS(x)&-1ULL>>1)==0x7ffULL<<52: \
  4. __fpclassifyl(x)==[FP_INFINITE](MATH.md#ga4f64bcc64f8b84dd9daf5a4e56abf0ca))

Description:

Checks whether the floating-point value x is an infinity.

Parameters:

Name

Description

xIndicates the floating-point value x to check.

Returns:

Returns 1 if x is an infinity; returns 0 otherwise.

isless

  1. #define isless( x, y ) __tg_pred_2(x, y, __isless)

Description:

Checks whether floating-point value x is less than y.

Parameters:

Name

Description

xIndicates the floating-point value x to check.
yIndicates the floating-point value y to check.

Attention:

If either or both of x and y are a NaN value, an exception occurs. This function requires hardware support.

Returns:

Returns 1 if x is less than y; returns 0 otherwise.

islessequal

  1. #define islessequal( x, y ) __tg_pred_2(x, y, __islessequal)

Description:

Checks whether floating-point value x is less than or equal to y.

Parameters:

Name

Description

xIndicates the floating-point value x to check.
yIndicates the floating-point value y to check.

Attention:

If either or both of x and y are a NaN value, an exception occurs. This function requires hardware support.

Returns:

Returns 1 if x is less than or equal to y; returns 0 otherwise.

islessgreater

  1. #define islessgreater( x, y ) __tg_pred_2(x, y, __islessgreater)

Description:

Checks whether floating-point value x is either less than or greater than y.

Parameters:

Name

Description

xIndicates the floating-point value x to check.
yIndicates the floating-point value y to check.

Attention:

If either or both of x and y are a NaN value, an exception occurs. This function requires hardware support.

Returns:

Returns 1 if x is either less than or greater than y; returns 0 otherwise.

isnan

  1. #define isnan( x)
  1. Values:( \
  2. sizeof(x)==sizeof(float)?(__FLOAT_BITS(x)&0x7fffffff)>0x7f800000: \
  3. sizeof(x)==sizeof(double)?(__DOUBLE_BITS(x)&-1ULL>>1)>0x7ffULL<<52: \
  4. __fpclassifyl(x)==[FP_NAN](MATH.md#ga1d481cc6e6a8ff729147ed46e61a4c9f))

Description:

Checks whether the floating-point value x is a NaN value.

Parameters:

Name

Description

xIndicates the floating-point value x to check.

Returns:

Returns a non-zero value if x is a NaN value; returns 0 otherwise.

isnormal

  1. #define isnormal( x)
  1. Values:( \
  2. sizeof(x)==sizeof(float)?((__FLOAT_BITS(x)+0x00800000)&0x7fffffff)>=0x01000000: \
  3. sizeof(x)==sizeof(double)?((__DOUBLE_BITS(x)+(1ULL<<52))&-1ULL>>1)>=1ULL<<53: \
  4. __fpclassifyl(x)==[FP_NORMAL](MATH.md#gab9e29bb9e853934c4ba647c840b7e5de))

Description:

Checks whether the floating-point value x is a normal value.

A normal value refers to any value that is not an infinity, a NaN value, or 0.

Parameters:

Name

Description

xIndicates the floating-point value x to check.

Returns:

Returns a non-zero value if x is a normal value; returns 0 otherwise.

isunordered

  1. #define isunordered( x, y )([isnan]($api-api-SmartVision-Devices-MATH.md#ga2e1baae9134e580910322362dc23290e)((x)) ? ((void)(y),1) : [isnan]($api-api-SmartVision-Devices-MATH.md#ga2e1baae9134e580910322362dc23290e)((y)))

Description:

Checks whether floating-point value x or y is unordered.

An unordered value refers to a NaN value.

Parameters:

Name

Description

xIndicates the floating-point value x to check.
yIndicates the floating-point value y to check.

Returns:

Returns 1 if either x or y is unordered; returns 0 otherwise.

signbit

  1. #define signbit( x)
  1. Values:( \
  2. sizeof(x)==sizeof(float)?(int)(__FLOAT_BITS(x)>>31): \
  3. sizeof(x)==sizeof(double)?(int)(__DOUBLE_BITS(x)>>63): \
  4. __signbitl(x))

Description:

Checks whether the sign of the floating-point value x is negative.

Parameters:

Name

Description

xIndicates the floating-point value x to check.

Returns:

Returns a non-zero value if the sign of x is negative; returns 0 otherwise.

Function Documentation

acos()

  1. double acos (double x)

Description:

Calculates the arc cosine of the double value x.

Parameters:

Name

Description

xIndicates the double value whose arc cosine is to be calculated.

Returns:

Returns the arc cosine of x in radians, ranging from 0 to M_PI. If x is a NaN value, this function returns a NaN value. If x is +1, this function returns +0. If x is a positive or negative infinity, this function returns a NaN value and reports a domain error. If x is out of the range [-1, 1], this function returns a NaN value, reports a domain error, sets errno to EDOM, and throws the FE_INVALID exception.

acosf()

  1. float acosf (float x)

Description:

Calculates the arc cosine of the float value x.

Parameters:

Name

Description

xIndicates the float value whose arc cosine is to be calculated.

Returns:

Returns the arc cosine of x in radians, ranging from 0 to M_PI. If x is a NaN value, this function returns a NaN value. If x is +1, this function returns +0. If x is a positive or negative infinity, this function returns a NaN value and reports a domain error. If x is out of the range [-1, 1], this function returns a NaN value, reports a domain error, sets errno to EDOM, and throws the FE_INVALID exception.

acosh()

  1. double acosh (double x)

Description:

Calculates the inverse hyperbolic cosine of the double value x.

Parameters:

Name

Description

xIndicates the double value whose inverse hyperbolic cosine is to be calculated.

Returns:

Returns the inverse hyperbolic cosine of x. If x is a NaN value, this function returns a NaN value. If x is +1, this function returns +0. If x is a positive infinity, this function returns a positive infinity. If x is less than 1, this function returns a NaN value, reports a domain error, sets errno to EDOM, and throws the FE_INVALID exception.

acoshf()

  1. float acoshf (float x)

Description:

Calculates the inverse hyperbolic cosine of float value x.

Parameters:

Name

Description

xIndicates the float value whose inverse hyperbolic cosine is to be calculated.

Returns:

Returns the inverse hyperbolic cosine of x. If x is a NaN value, this function returns a NaN value. If x is +1, this function returns +0. If x is a positive infinity, this function returns a positive infinity. If x is less than 1, this function returns a NaN value, reports a domain error, sets errno to EDOM, and throws the FE_INVALID exception.

acoshl()

  1. longdouble acoshl (longdouble x)

Description:

Calculates the inverse hyperbolic cosine of the long double value x.

Parameters:

Name

Description

xIndicates the long double value whose inverse hyperbolic cosine is to be calculated.

Returns:

Returns the inverse hyperbolic cosine of x. If x is a NaN value, this function returns a NaN value. If x is +1, this function returns +0. If x is a positive infinity, this function returns a positive infinity. If x is less than 1, this function returns a NaN value, reports a domain error, sets errno to EDOM, and throws the FE_INVALID exception.

acosl()

  1. longdouble acosl (longdouble x)

Description:

Calculates the arc cosine of the long double value x.

Parameters:

Name

Description

xIndicates the long double value whose arc cosine is to be calculated.

Returns:

Returns the arc cosine of x in radians, ranging from 0 to M_PI. If x is a NaN value, this function returns a NaN value. If x is +1, this function returns +0. If x is a positive or negative infinity, this function returns a NaN value and reports a domain error. If x is out of the range [-1, 1], this function returns a NaN value, reports a domain error, sets errno to EDOM, and throws the FE_INVALID exception.

asin()

  1. double asin (double x)

Description:

Calculates the arc sine of the double value x.

Parameters:

Name

Description

xIndicates the double value whose arc sine is to be calculated.

Returns:

Returns the arc sine of x in radians, ranging from -M_PI_2 to M_PI_2. If x is a NaN value, this function returns a NaN value. If x is +0 or -0, this function returns +0 or -0. If x is out of the range [-1, 1], this function returns a NaN value, reports a domain error, sets errno to EDOM, and throws the FE_INVALID exception.

asinf()

  1. float asinf (float x)

Description:

Calculates the arc sine of the float value x.

Parameters:

Name

Description

xIndicates the float value whose arc sine is to be calculated.

Returns:

Returns the arc sine of x in radians, ranging from -M_PI_2 to M_PI_2. If x is a NaN value, this function returns a NaN value. If x is +0 or -0, this function returns +0 or -0. If x is out of the range [-1, 1], this function returns a NaN value, reports a domain error, sets errno to EDOM, and throws the FE_INVALID exception.

asinh()

  1. double asinh (double x)

Description:

Calculates the inverse hyperbolic sine of the double value x.

Parameters:

Name

Description

xIndicates the double value whose inverse hyperbolic sine is to be calculated.

Returns:

Returns the inverse hyperbolic sine of x. If x is a NaN value, this function returns a NaN value. If x is +0 or -0, this function returns +0 or -0. If x is a positive or negative infinity, this function returns a positive or negative infinity.

asinhf()

  1. float asinhf (float x)

Description:

Calculates the inverse hyperbolic sine of the float value x.

Parameters:

Name

Description

xIndicates the float value whose inverse hyperbolic sine is to be calculated.

Returns:

Returns the inverse hyperbolic sine of x. If x is a NaN value, this function returns a NaN value. If x is +0 or -0, this function returns +0 or -0. If x is a positive or negative infinity, this function returns a positive or negative infinity.

asinhl()

  1. longdouble asinhl (longdouble x)

Description:

Calculates the inverse hyperbolic sine of the long double value x.

Parameters:

Name

Description

xIndicates the long double value whose inverse hyperbolic sine is to be calculated.

Returns:

Returns the inverse hyperbolic sine of x. If x is a NaN value, this function returns a NaN value. If x is +0 or -0, this function returns +0 or -0. If x is a positive or negative infinity, this function returns a positive or negative infinity.

asinl()

  1. longdouble asinl (longdouble x)

Description:

Calculates the arc sine of the long double value x.

Parameters:

Name

Description

xIndicates the long double value whose arc sine is to be calculated.

Returns:

Returns the arc sine of x in radians, ranging from -M_PI_2 to M_PI_2. If x is a NaN value, this function returns a NaN value. If x is +0 or -0, this function returns +0 or -0. If x is out of the range [-1, 1], this function returns a NaN value, reports a domain error, sets errno to EDOM, and throws the FE_INVALID exception.

atan()

  1. double atan (double x)

Description:

Calculates the arc tangent of the double value x.

Parameters:

Name

Description

xIndicates the double value whose arc tangent is to be calculated.

Returns:

Returns the principal value of the arc tangent of x in radians, ranging from -M_PI_2 to M_PI_2. If x is a NaN value, this function returns a NaN value. If x is +0 or -0, this function returns +0 or -0, respectively. If x is a positive or negative infinity, this function returns M_PI_2.

atan2()

  1. double atan2 (double y,double x )

Description:

Calculates the arc tangent of two double values x and y.

Parameters:

Name

Description

yIndicates the double value y for calculating the arc tangent.
xIndicates the double value x for calculating the arc tangent.

Returns:

Returns the principal value of the arc tangent of y/x in radians, ranging from -M_PI to M_PI. If y is +0 or -0, and x is less than 0, this function returns +M_PI or -M_PI, respectively. If y is +0 or -0, and x is greater than 0, this function returns +0 or -0, respectively. If y is less than 0 and x is either +0 or -0, this function returns -M_PI_2. If y is greater than 0 and x is either +0 or -0, this function returns M_PI_2. If x or y is a NaN value, this function returns a NaN value. If y is +0 or -0, and x is -0, this function returns +M_PI or -M_PI, respectively. If y is +0 or -0, and x is +0, this function returns +0 or -0, respectively. If y is a finite value greater than or less than 0, and x is a negative infinity, this function returns +M_PI or -M_PI, respectively. If y is a finite value greater than or less than 0, and x is a positive infinity, this function returns +0 or -0, respectively. If y is a positive or negative infinity, and x is a finite value, this function returns M_PI_2 or -M_PI_2, respectively. If y is a positive or negative infinity, and x is a negative infinity, this function returns +3*M_PI_4 or -3*M_PI_4, respectively. If y is a positive or negative infinity, and x is a positive infinity, this function returns +M_PI_4 or -M_PI_4, respectively.

atan2f()

  1. float atan2f (float y,float x )

Description:

Calculates the arc tangent of two float values x and y.

Parameters:

Name

Description

yIndicates the float value y for calculating the arc tangent.
xIndicates the float value x for calculating the arc tangent.

Returns:

Returns the principal value of the arc tangent of y/x in radians, ranging from -M_PI to M_PI. If y is +0 or -0, and x is less than 0, this function returns +M_PI or -M_PI, respectively. If y is +0 or -0, and x is greater than 0, this function returns +0 or -0, respectively. If y is less than 0 and x is either +0 or -0, this function returns -M_PI_2. If y is greater than 0 and x is either +0 or -0, this function returns M_PI_2. If x or y is a NaN value, this function returns a NaN value. If y is +0 or -0, and x is -0, this function returns +M_PI or -M_PI, respectively. If y is +0 or -0, and x is +0, this function returns +0 or -0, respectively. If y is a finite value greater than or less than 0, and x is a negative infinity, this function returns +M_PI or -M_PI, respectively. If y is a finite value greater than or less than 0, and x is a positive infinity, this function returns +0 or -0, respectively. If y is a positive or negative infinity, and x is a finite value, this function returns M_PI_2 or -M_PI_2, respectively. If y is a positive or negative infinity, and x is a negative infinity, this function returns +3*M_PI_4 or -3*M_PI_4, respectively. If y is a positive or negative infinity, and x is a positive infinity, this function returns +M_PI_4 or -M_PI_4, respectively.

atan2l()

  1. longdouble atan2l (longdouble y,longdouble x )

Description:

Calculates the arc tangent of two long double values x and y.

Parameters:

Name

Description

yIndicates the long double value y for calculating the arc tangent.
xIndicates the long double value x for calculating the arc tangent.

Returns:

Returns the principal value of the arc tangent of y/x in radians, ranging from -M_PI to M_PI. If y is +0 or -0, and x is less than 0, this function returns +M_PI or -M_PI, respectively. If y is +0 or -0, and x is greater than 0, this function returns +0 or -0, respectively. If y is less than 0 and x is either +0 or -0, this function returns -M_PI_2. If y is greater than 0 and x is either +0 or -0, this function returns M_PI_2. If x or y is a NaN value, this function returns a NaN value. If y is +0 or -0, and x is -0, this function returns +M_PI or -M_PI, respectively. If y is +0 or -0, and x is +0, this function returns +0 or -0, respectively. If y is a finite value greater than or less than 0, and x is a negative infinity, this function returns +M_PI or -M_PI, respectively. If y is a finite value greater than or less than 0, and x is a positive infinity, this function returns +0 or -0, respectively. If y is a positive or negative infinity, and x is a finite value, this function returns M_PI_2 or -M_PI_2, respectively. If y is a positive or negative infinity, and x is a negative infinity, this function returns +3*M_PI_4 or -3*M_PI_4, respectively. If y is a positive or negative infinity, and x is a positive infinity, this function returns +M_PI_4 or -M_PI_4, respectively.

atanf()

  1. float atanf (float x)

Description:

Calculates the arc tangent of the float value x.

Parameters:

Name

Description

xIndicates the float value whose arc tangent is to be calculated.

Returns:

Returns the principal value of the arc tangent of x in radians, ranging from -M_PI_2 to M_PI_2. If x is a NaN value, this function returns a NaN value. If x is +0 or -0, this function returns +0 or -0, respectively. If x is a positive or negative infinity, this function returns M_PI_2 or -M_PI_2, respectively.

atanh()

  1. double atanh (double x)

Description:

Calculates the inverse hyperbolic tangent of the double value x.

Parameters:

Name

Description

xIndicates the double value whose inverse hyperbolic tangent is to be calculated.

Returns:

Returns the inverse hyperbolic tangent of x. If x is a NaN value, this function returns a NaN value. If x is +0 or -0, this function returns +0 or -0, respectively. If x is +1 or -1, this function returns HUGE_VAL, reports a pole error, sets errno to EDOM, and throws the FE_INVALID exception. If the absolute value of x is greater than 1, this function returns a NaN value, reports a domain error, sets errno to ERANGE, and throws the FE_DIVBYZERO exception.

atanhf()

  1. float atanhf (float x)

Description:

Calculates the inverse hyperbolic tangent of the float value x.

Parameters:

Name

Description

xIndicates the float value whose inverse hyperbolic tangent is to be calculated.

Returns:

Returns the inverse hyperbolic tangent of x. If x is a NaN value, this function returns a NaN value. If x is +0 or -0, this function returns +0 or -0, respectively. If x is +1 or -1, this function returns HUGE_VAL, reports a pole error, sets errno to EDOM, and throws the FE_INVALID exception. If the absolute value of x is greater than 1, this function returns a NaN value, reports a domain error, sets errno to ERANGE, and throws the FE_DIVBYZERO exception.

atanhl()

  1. longdouble atanhl (longdouble x)

Description:

Calculates the inverse hyperbolic tangent of the long double value x.

Parameters:

Name

Description

xIndicates the long double value whose inverse hyperbolic tangent is to be calculated.

Returns:

Returns the inverse hyperbolic tangent of x. If x is a NaN value, this function returns a NaN value. If x is +0 or -0, this function returns +0 or -0, respectively. If x is +1 or -1, this function returns HUGE_VAL, reports a pole error, sets errno to EDOM, and throws the FE_INVALID exception. If the absolute value of x is greater than 1, this function returns a NaN value, reports a domain error, sets errno to ERANGE, and throws the FE_DIVBYZERO exception.

atanl()

  1. longdouble atanl (longdouble x)

Description:

Calculates the arc tangent of the long double value x.

Parameters:

Name

Description

xIndicates the long double value whose arc tangent is to be calculated.

Returns:

Returns the principal value of the arc tangent of x in radians, ranging from -M_PI_2 to M_PI_2. If x is a NaN value, this function returns a NaN value. If x is +0 or -0, this function returns +0 or -0, respectively. If x is a positive or negative infinity, this function returns M_PI_2 or -M_PI_2, respectively.

cabs()

  1. double cabs (double[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the absolute value of the complex number z.

Parameters:

Name

Description

zIndicates the complex number (a double value) whose absolute value is to be obtained.

Attention:

If an error occurs or z is a positive or negative infinity or NAN, the returned value is calculated based on the formula hypot(cimag(z) + creal(z)).

Returns:

Returns the absolute value of z if the operation is successful.

cabsf()

  1. float cabsf (float[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the absolute value of the complex number z.

Parameters:

Name

Description

zIndicates the complex number (a float value) whose absolute value is to be obtained.

Attention:

If an error occurs or z is a positive or negative infinity or NAN, the returned value is calculated based on the formula hypot(cimag(z) + creal(z)).

Returns:

Returns the absolute value of z if the operation is successful.

cabsl()

  1. longdouble cabsl (longdouble[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the absolute value of the complex number z.

Parameters:

Name

Description

zIndicates the complex number (a long double value) whose absolute value is to be obtained.

Attention:

If an error occurs or z is a positive or negative infinity or NAN, the returned value is calculated based on the formula hypot(cimag(z) + creal(z)).

Returns:

Returns the absolute value of z if the operation is successful.

cacos()

  1. double[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) cacos (double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the arc cosine of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a double value) whose arc cosine is to be obtained.

Returns:

Returns the arc cosine of z if the operation is successful. If x is +0 or -0 and y is 0, this function returns M_PI_2 - 0i. If x is +0 or -0 and y is NAN, this function returns M_PI_2 + NANi. If x is not an infinity and y is an infinity, this function returns M_PI_2 - HUGE_VALi. If x is neither an infinity nor 0 and y is NAN, this returns NAN + NANi and throws the FE_INVALID exception. If x is a negative infinity and y is a positive finite value, this function returns M_PI - HUGE_VALi. If x is a negative infinity and y is a positive infinity, this function returns 3*M_PI_4 - HUGE_VALi. If x and y are both positive infinity, this function returns M_PI_4 - HUGE_VALi. If x is a positive or negative infinity and y is NAN, this function returns NAN +(-) HUGE_VALi (the sign bit of the imaginary part of the returned value is uncertain). If x is NAN and y is not an infinity, this function returns NAN + NANi and throws the FE_INVALID exception. If x is NAN and y is a positive infinity, this function returns NAN - HUGE_VALi. If x and y are both NAN, this function returns NAN + NANi.

cacosf()

  1. float[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) cacosf (float [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the arc cosine of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a float value) whose arc cosine is to be obtained.

Returns:

Returns the arc cosine of z if the operation is successful. If x is +0 or -0 and y is 0, this function returns M_PI_2 - 0i. If x is +0 or -0 and y is NAN, this function returns M_PI_2 + NANi. If x is not an infinity and y is an infinity, this function returns M_PI_2-HUGE_VALFi. If x is neither an infinity nor 0 and y is NAN, this returns NAN + NANi and throws the FE_INVALID exception. If x is a negative infinity and y is a positive finite value, this function returns M_PI - HUGE_VALFi. If x is a negative infinity and y is a positive infinity, this function returns 3*M_PI_4 - HUGE_VALFi. If x and y are both positive infinity, this function returns M_PI_4 - HUGE_VALFi. If x is a positive or negative infinity and y is NAN, this function returns NAN +(-) HUGE_VALFi (the sign bit of the imaginary part of the returned value is uncertain). If x is NAN and y is not an infinity, this function returns NAN + NANi and throws the FE_INVALID exception. If x is NAN and y is a positive infinity, this function returns NAN - HUGE_VALFi. If x and y are both NAN, this function returns NAN + NANi.

cacosh()

  1. double[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) cacosh (double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the inverse hyperbolic cosine of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a double value) whose inverse hyperbolic cosine is to be obtained.

Returns:

Returns the inverse hyperbolic cosine of z if the operation is successful. If x is 0 and y is 0, this function returns M_PI_2i. If x is 0 and y is NAN, this function returns NAN +(-) M_PI_2i (the sign bit of the imaginary part of the returned value is uncertain). If x is not an infinity and y is a positive infinity, this function returns HUGE_VAL + M_PI_2i. If x is neither an infinity nor 0 and y is NAN, this function returns NAN + NANi and may throw the FE_INVALID exception. If x is a negative infinity and y is a positive finite value, this function returns HUGE_VAL + M_PIi. If x is a positive infinity and y is a positive finite value, this function returns HUGE_VAL. If x is a negative infinity and y is a positive infinity, this function returns HUGE_VAL + 3*M_PI_4i. If x is an infinity and y is NAN, this function returns HUGE_VAL + NANi. If x is NAN and y is not an infinity, this function returns NAN + NANi and may throw the FE_INVALID exception. If x is NAN and y is a positive infinity, this function returns HUGE_VAL + NANi. If x and y are both NAN, this function returns NAN + NANi.

cacoshf()

  1. float[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) cacoshf (float [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the inverse hyperbolic cosine of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a float value) whose inverse hyperbolic cosine is to be obtained.

Returns:

Returns the inverse hyperbolic cosine of z if the operation is successful. If x is 0 and y is 0, this function returns M_PI_2i. If x is 0 and y is NAN, this function returns NAN +(-) M_PI_2i (the sign bit of the imaginary part of the returned value is uncertain). If x is not an infinity and y is a positive infinity, this function returns HUGE_VALF + M_PI_2i. If x is neither an infinity nor 0 and y is NAN, this function returns NAN + NANi and may throw the FE_INVALID exception. If x is a negative infinity and y is a positive finite value, this function returns HUGE_VALF + M_PIi. If x is a positive infinity and y is a positive finite value, this function returns HUGE_VALF. If x is a negative infinity and y is a positive infinity, this function returns HUGE_VALF + 3*M_PI_4i. If x is an infinity and y is NAN, this function returns HUGE_VALF + NANi. If x is NAN and y is not an infinity, this function returns NAN + NANi and may throw the FE_INVALID exception. If x is NAN and y is a positive infinity, this function returns HUGE_VALF + NANi. If x and y are both NAN, this function returns NAN + NANi.

cacoshl()

  1. longdouble[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) cacoshl (long double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the inverse hyperbolic cosine of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a long double value) whose inverse hyperbolic cosine is to be obtained.

Returns:

Returns the inverse hyperbolic cosine of z if the operation is successful. If x is 0 and y is 0, this function returns M_PI_2i. If x is 0 and y is NAN, this function returns NAN +(-) M_PI_2i (the sign bit of the imaginary part of the returned value is uncertain). If x is not an infinity and y is a positive infinity, this function returns HUGE_VALL + M_PI_2i. If x is neither an infinity nor 0 and y is NAN, this function returns NAN + NANi and may throw the FE_INVALID exception. If x is a negative infinity and y is a positive finite value, this function returns HUGE_VALL + M_PIi. If x is a positive infinity and y is a positive finite value, this function returns HUGE_VALL. If x is a negative infinity and y is a positive infinity, this function returns HUGE_VALL + 3*M_PI_4i. If x is an infinity and y is NAN, this function returns HUGE_VALL + NANi. If x is NAN and y is not an infinity, this function returns NAN + NANi and may throw the FE_INVALID exception. If x is NAN and y is a positive infinity, this function returns HUGE_VALL + NANi. If x and y are both NAN, this function returns NAN + NANi.

cacosl()

  1. longdouble[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) cacosl (long double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the arc cosine of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a long double value) whose arc cosine is to be obtained.

Returns:

Returns the arc cosine of z if the operation is successful. If x is +0 or -0 and y is 0, this function returns M_PI_2 - 0i. If x is +0 or -0 and y is NAN, this function returns M_PI_2 + NANi. If x is not an infinity and y is an infinity, this function returns M_PI_2-HUGE_VALLi. If x is neither an infinity nor 0 and y is NAN, this returns NAN + NANi and throws the FE_INVALID exception. If x is a negative infinity and y is a positive finite value, this function returns M_PI - HUGE_VALLi. If x is a negative infinity and y is a positive infinity, this function returns 3*M_PI_4 - HUGE_VALLi. If x and y are both positive infinity, this function returns M_PI_4 - HUGE_VALLi. If x is a positive or negative infinity and y is NAN, this function returns NAN +(-) HUGE_VALLi (the sign bit of the imaginary part of the returned value is uncertain). If x is NAN and y is not an infinity, this function returns NAN + NANi and throws the FE_INVALID exception. If x is NAN and y is a positive infinity, this function returns NAN - HUGE_VALLi. If x and y are both NAN, this function returns NAN + NANi.

carg()

  1. double carg (double[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the phase angle of the complex number z.

Parameters:

Name

Description

zIndicates the complex number (a double value) whose phase angle is to be obtained.

Attention:

If an error occurs or z is a positive or negative infinity or NAN, the returned value is calculated based on the formula atan2(cimag(z) + creal(z)).

Returns:

Returns the phase angle of z if the operation is successful.

cargf()

  1. float cargf (float[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the phase angle of the complex number z.

Parameters:

Name

Description

zIndicates the complex number (a float value) whose phase angle is to be obtained.

Attention:

If an error occurs or z is a positive or negative infinity or NAN, the returned value is calculated based on the formula atan2(cimag(z) + creal(z)).

Returns:

Returns the phase angle of z if the operation is successful.

cargl()

  1. longdouble cargl (longdouble[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the phase angle of the complex number z.

Parameters:

Name

Description

zIndicates the complex number (a long double value) whose hyperbolic sine is to be obtained.

Attention:

If an error occurs or z is a positive or negative infinity or NAN, the returned value is calculated based on the formula atan2(cimag(z) + creal(z)).

Returns:

Returns the phase angle of z if the operation is successful.

casin()

  1. double[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) casin (double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the arc sine of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a double value) whose arc sine is to be obtained.

Returns:

Returns the arc sine of z if the operation is successful. If x and y are both 0, this function returns 0. If x is a positive finite value and y is a positive infinity, this function returns HUGE_VAL + M_PI_2i. If x is not an infinity and y is NAN, this function returns NAN + NANi and may throw the FE_INVALID exception. If x is a positive infinity and y is a positive finite value, this function returns HUGE_VAL. If x and y are both positive infinity, this function returns HUGE_VAL + M_PI_4i. If x is a positive infinity and y is NAN, this function returns HUGE_VAL + NANi. If x is NAN and y is 0, this function returns NAN. If x is NAN and y is not 0, this function returns NAN + NANi and throws the FE_INVALID exception. If x is NAN and y is a positive infinity, this function returns +(-)HUGE_VAL + NANi (the sign bit of the real part of the returned value is uncertain. If x and y are both NAN, this function returns NAN + NANi.

casinf()

  1. float[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) casinf (float [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the arc sine of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a float value) whose arc sine is to be obtained.

Returns:

Returns the arc sine of z if the operation is successful. If x and y are both 0, this function returns 0. If x is a positive finite value and y is a positive infinity, this function returns HUGE_VALF + M_PI_2i. If x is not an infinity and y is NAN, this function returns NAN + NANi and may throw the FE_INVALID exception. If x is a positive infinity and y is a positive finite value, this function returns HUGE_VALF. If x and y are both positive infinity, this function returns HUGE_VALF + M_PI_4i. If x is a positive infinity and y is NAN, this function returns HUGE_VALF + NANi. If x is NAN and y is 0, this function returns NAN. If x is NAN and y is not 0, this function returns NAN + NANi and throws the FE_INVALID exception. If x is NAN and y is a positive infinity, this function returns +(-)HUGE_VALF + NANi (the sign bit of the real part of the returned value is uncertain. If x and y are both NAN, this function returns NAN + NANi.

casinh()

  1. double[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) casinh (double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the inverse hyperbolic sine of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a double value) whose inverse hyperbolic sine is to be obtained.

Returns:

Returns the inverse hyperbolic sine of z if the operation is successful. If x and y are both 0, this function returns 0. If x is a positive finite value and y is a positive infinity, this function returns HUGE_VAL + M_PI_2i. If x is not an infinity and y is NAN, this function returns NAN + NANi and may throw the FE_INVALID exception. If x is a positive infinity and y is a positive finite value, this function returns HUGE_VAL. If x and y are both positive infinity, this function returns HUGE_VAL + M_PI_4i. If x is a positive infinity and y is NAN, this function returns HUGE_VAL + NANi. If x is NAN and y is 0, this function returns NAN. If x is NAN and y is not 0, this function returns NAN + NANi and throws the FE_INVALID exception. If x is NAN and y is a positive infinity, this function returns +(-)HUGE_VAL + NANi (the sign bit of the real part of the returned value is uncertain. If x and y are both NAN, this function returns NAN + NANi.

casinhf()

  1. float[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) casinhf (float [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the inverse hyperbolic sine of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a float value) whose inverse hyperbolic sine is to be obtained.

Returns:

Returns the inverse hyperbolic sine of z if the operation is successful. If x and y are both 0, this function returns 0. If x is a positive finite value and y is a positive infinity, this function returns HUGE_VALF + M_PI_2i. If x is not an infinity and y is NAN, this function returns NAN + NANi and may throw the FE_INVALID exception. If x is a positive infinity and y is a positive finite value, this function returns HUGE_VALF. If x and y are both positive infinity, this function returns HUGE_VALF + M_PI_4i. If x is a positive infinity and y is NAN, this function returns HUGE_VALF + NANi. If x is NAN and y is 0, this function returns NAN. If x is NAN and y is not 0, this function returns NAN + NANi and throws the FE_INVALID exception. If x is NAN and y is a positive infinity, this function returns +(-)HUGE_VALF + NANi (the sign bit of the real part of the returned value is uncertain. If x and y are both NAN, this function returns NAN + NANi.

casinhl()

  1. longdouble[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) casinhl (long double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the inverse hyperbolic sine of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a long double value) whose inverse hyperbolic sine is to be obtained.

Returns:

Returns the inverse hyperbolic sine of z if the operation is successful. If x and y are both 0, this function returns 0. If x is a positive finite value and y is a positive infinity, this function returns HUGE_VALL + M_PI_2i. If x is not an infinity and y is NAN, this function returns NAN + NANi and may throw the FE_INVALID exception. If x is a positive infinity and y is a positive finite value, this function returns HUGE_VALL. If x and y are both positive infinity, this function returns HUGE_VALL + M_PI_4i. If x is a positive infinity and y is NAN, this function returns HUGE_VALL + NANi. If x is NAN and y is 0, this function returns NAN. If x is NAN and y is not 0, this function returns NAN + NANi and throws the FE_INVALID exception. If x is NAN and y is a positive infinity, this function returns +(-)HUGE_VALL + NANi (the sign bit of the real part of the returned value is uncertain. If x and y are both NAN, this function returns NAN + NANi.

casinl()

  1. longdouble[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) casinl (long double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the arc sine of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a long double value) whose arc sine is to be obtained.

Returns:

Returns the arc sine of z if the operation is successful. If x and y are both 0, this function returns 0. If x is a positive finite value and y is a positive infinity, this function returns HUGE_VALL + M_PI_2i. If x is not an infinity and y is NAN, this function returns NAN + NANi and may throw the FE_INVALID exception. If x is a positive infinity and y is a positive finite value, this function returns HUGE_VALL. If x and y are both positive infinity, this function returns HUGE_VALL + M_PI_4i. If x is a positive infinity and y is NAN, this function returns HUGE_VALL + NANi. If x is NAN and y is 0, this function returns NAN. If x is NAN and y is not 0, this function returns NAN + NANi and throws the FE_INVALID exception. If x is NAN and y is a positive infinity, this function returns +(-)HUGE_VALL + NANi (the sign bit of the real part of the returned value is uncertain. If x and y are both NAN, this function returns NAN + NANi.

catan()

  1. double[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) catan (double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the arc tangent of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a double value) whose arc tangent is to be obtained.

Returns:

Returns the arc tangent of z if the operation is successful. If x and y are both 0, this function returns 0. If x is 0 and y is NAN, this function returns NANi. If x is 1 and y is 0, this function returns HUGE_VAL and throws the FE_DIVBYZERO exception. If x is a positive finite value and y is a positive infinity, this function returns M_PI_2i. If x is neither an infinity nor 0 and y is NAN, this returns NAN + NANi and throws the FE_INVALID exception. If x is a positive infinity and y is a positive finite value, this function returns M_PI_2i. If x and y are both positive infinity, this function returns M_PI_2i. If x is a positive infinity and y is NAN, this function returns NANi. If x is NAN and y is not an infinity, this function returns NAN + NANi and may throw the FE_INVALID exception. If x is NAN and y is a positive infinity, this function returns M_PI_2i. If x and y are both NAN, this function returns NAN + NANi.

catanf()

  1. float[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) catanf (float [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the arc tangent of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a float value) whose arc tangent is to be obtained.

Returns:

Returns the arc tangent of z if the operation is successful. If x and y are both 0, this function returns 0. If x is 0 and y is NAN, this function returns NANi. If x is 1 and y is 0, this function returns HUGE_VALF and throws the FE_DIVBYZERO exception. If x is a positive finite value and y is a positive infinity, this function returns M_PI_2i. If x is neither an infinity nor 0 and y is NAN, this returns NAN + NANi and throws the FE_INVALID exception. If x is a positive infinity and y is a positive finite value, this function returns M_PI_2i. If x and y are both positive infinity, this function returns M_PI_2i. If x is a positive infinity and y is NAN, this function returns NANi. If x is NAN and y is not an infinity, this function returns NAN + NANi and may throw the FE_INVALID exception. If x is NAN and y is a positive infinity, this function returns M_PI_2i. If x and y are both NAN, this function returns NAN + NANi.

catanh()

  1. double[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) catanh (double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the inverse hyperbolic tangent of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a double value) whose inverse hyperbolic tangent is to be obtained.

Returns:

Returns the inverse hyperbolic tangent of z if the operation is successful. If x and y are both 0, this function returns 0. If x is 0 and y is NAN, this function returns NANi. If x is 1 and y is 0, this function returns HUGE_VAL and throws the FE_DIVBYZERO exception. If x is a positive finite value and y is a positive infinity, this function returns M_PI_2i. If x is neither an infinity nor 0 and y is NAN, this returns NAN + NANi and throws the FE_INVALID exception. If x is a positive infinity and y is a positive finite value, this function returns M_PI_2i. If x and y are both positive infinity, this function returns M_PI_2i. If x is a positive infinity and y is NAN, this function returns NANi. If x is NAN and y is not an infinity, this function returns NAN + NANi and may throw the FE_INVALID exception. If x is NAN and y is a positive infinity, this function returns M_PI_2i. If x and y are both NAN, this function returns NAN + NANi.

catanhf()

  1. float[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) catanhf (float [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the inverse hyperbolic tangent of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a float value) whose inverse hyperbolic tangent is to be obtained.

Returns:

Returns the inverse hyperbolic tangent of z if the operation is successful. If x and y are both 0, this function returns 0. If x is 0 and y is NAN, this function returns NANi. If x is 1 and y is 0, this function returns HUGE_VALF and throws the FE_DIVBYZERO exception. If x is a positive finite value and y is a positive infinity, this function returns M_PI_2i. If x is neither an infinity nor 0 and y is NAN, this returns NAN + NANi and throws the FE_INVALID exception. If x is a positive infinity and y is a positive finite value, this function returns M_PI_2i. If x and y are both positive infinity, this function returns M_PI_2i. If x is a positive infinity and y is NAN, this function returns NANi. If x is NAN and y is not an infinity, this function returns NAN + NANi and may throw the FE_INVALID exception. If x is NAN and y is a positive infinity, this function returns M_PI_2i. If x and y are both NAN, this function returns NAN + NANi.

catanhl()

  1. longdouble[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) catanhl (long double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the inverse hyperbolic tangent of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a long double value) whose inverse hyperbolic tangent is to be obtained.

Returns:

Returns the inverse hyperbolic tangent of z if the operation is successful. If x and y are both 0, this function returns 0. If x is 0 and y is NAN, this function returns NANi. If x is 1 and y is 0, this function returns HUGE_VALL and throws the FE_DIVBYZERO exception. If x is a positive finite value and y is a positive infinity, this function returns M_PI_2i. If x is neither an infinity nor 0 and y is NAN, this returns NAN + NANi and throws the FE_INVALID exception. If x is a positive infinity and y is a positive finite value, this function returns M_PI_2i. If x and y are both positive infinity, this function returns M_PI_2i. If x is a positive infinity and y is NAN, this function returns NANi. If x is NAN and y is not an infinity, this function returns NAN + NANi and may throw the FE_INVALID exception. If x is NAN and y is a positive infinity, this function returns M_PI_2i. If x and y are both NAN, this function returns NAN + NANi.

catanl()

  1. longdouble[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) catanl (long double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the arc tangent of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a long double value) whose arc tangent is to be obtained.

Returns:

Returns the arc tangent of z if the operation is successful. If x and y are both 0, this function returns 0. If x is 0 and y is NAN, this function returns NANi. If x is 1 and y is 0, this function returns HUGE_VALL and throws the FE_DIVBYZERO exception. If x is a positive finite value and y is a positive infinity, this function returns M_PI_2i. If x is neither an infinity nor 0 and y is NAN, this returns NAN + NANi and throws the FE_INVALID exception. If x is a positive infinity and y is a positive finite value, this function returns M_PI_2i. If x and y are both positive infinity, this function returns M_PI_2i. If x is a positive infinity and y is NAN, this function returns NANi. If x is NAN and y is not an infinity, this function returns NAN + NANi and may throw the FE_INVALID exception. If x is NAN and y is a positive infinity, this function returns M_PI_2i. If x and y are both NAN, this function returns NAN + NANi.

cbrt()

  1. double cbrt (double x)

Description:

Calculates the cube root of the double value x.

Parameters:

Name

Description

xIndicates the double value whose cube root is to be calculated.

Returns:

Returns the cube root if the operation is successful; returns the passed x if x is +0, -0, a positive or negative infinity, or a NaN value.

cbrtf()

  1. float cbrtf (float x)

Description:

Calculates the cube root of the float value x.

Parameters:

Name

Description

xIndicates the float value whose cube root is to be calculated.

Returns:

Returns the cube root if the operation is successful; returns the passed x if x is +0, -0, a positive or negative infinity, or a NaN value.

cbrtl()

  1. longdouble cbrtl (longdouble x)

Description:

Calculates the cube root of the long double value x.

Parameters:

Name

Description

xIndicates the long double value whose cube root is to be calculated.

Returns:

Returns the cube root if the operation is successful; returns the passed x if x is +0, -0, a positive or negative infinity, or a NaN value.

ccos()

  1. double[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) ccos (double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the cosine of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a double value) whose cosine is to be obtained.

Returns:

Returns the cosine of z if the operation is successful. If x and y are both 0, this function returns 1. If x is 0 and y is a positive infinity, this function returns HUGE_VAL. If x is 0 and y is NAN, this function returns NAN. If x is a negative infinity and y is 0, this function returns NAN and throws the FE_INVALID exception. If x is a negative infinity and y is a positive infinity, this function returns +(-)HUGE_VAL + NANi (the sign bit of the real part of the returned value is uncertain) and throws the FE_INVALID exception. If x is a negative infinity and y is neither an infinity nor 0, this function returns NAN + NANi and throws the FE_INVALID exception. If x is NAN and y is 0, this function returns NAN. If x is NAN and y is a positive infinity, this function returns NAN + NANi and throws the FE_INVALID exception. If x is NAN and y is a positive or negative infinity, this function returns HUGE_VAL + NANi. If x is neither an infinity nor 0 and y is NAN, this returns NAN + NANi and throws the FE_INVALID exception. If x and y are both NAN, this function returns NAN + NANi.

ccosf()

  1. float[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) ccosf (float [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the cosine of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a float value) whose cosine is to be obtained.

Returns:

Returns the cosine of z if the operation is successful. If x and y are both 0, this function returns 1. If x is 0 and y is a positive infinity, this function returns HUGE_VALF. If x is 0 and y is NAN, this function returns NAN. If x is a negative infinity and y is 0, this function returns NAN and throws the FE_INVALID exception. If x is a negative infinity and y is a positive infinity, this function returns +(-)HUGE_VALF + NANi (the sign bit of the real part of the returned value is uncertain) and throws the FE_INVALID exception. If x is a negative infinity and y is neither an infinity nor 0, this function returns NAN + NANi and throws the FE_INVALID exception. If x is NAN and y is 0, this function returns NAN. If x is NAN and y is a positive infinity, this function returns NAN + NANi and throws the FE_INVALID exception. If x is NAN and y is a positive or negative infinity, this function returns HUGE_VALF + NANi. If x is neither an infinity nor 0 and y is NAN, this returns NAN + NANi and throws the FE_INVALID exception. If x and y are both NAN, this function returns NAN + NANi.

ccosh()

  1. double[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) ccosh (double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the hyperbolic cosine of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a double value) whose hyperbolic cosine is to be obtained.

Returns:

Returns the hyperbolic cosine of z if the operation is successful. If x and y are both 0, this function returns 1. If x is 0 and y is a positive infinity, this function returns NAN and throws the FE_INVALID exception. If x is 0 and y is NAN, this function returns NAN. If x is neither an infinity nor 0 and y is a positive infinity, this function returns NAN + NANi and throws the FE_INVALID exception. If x is a negative infinity and y is NAN, this function returns NAN + NANi and throws the FE_INVALID exception. If x is a positive infinity and y is 0, this function returns HUGE_VAL. If x is a positive infinity and y is a positive infinity, this function returns +(-)HUGE_VAL + NANi (the sign bit of the real part of the returned value is uncertain) and throws the FE_INVALID exception. If x is a positive or negative infinity and y is NAN, this function returns HUGE_VAL + NANi. If x is NAN and y is 0, this function returns NAN. If x is NAN and y is neither an infinity nor 0, this function returns NAN + NANi and throws the FE_INVALID exception. If x and y are both NAN, this function returns NAN + NANi.

ccoshf()

  1. float[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) ccoshf (float [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the hyperbolic cosine of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a float value) whose hyperbolic cosine is to be obtained.

Returns:

Returns the hyperbolic cosine of z if the operation is successful. If x and y are both 0, this function returns 1. If x is 0 and y is a positive infinity, this function returns NAN and throws the FE_INVALID exception. If x is 0 and y is NAN, this function returns NAN. If x is neither an infinity nor 0 and y is a positive infinity, this function returns NAN + NANi and throws the FE_INVALID exception. If x is a negative infinity and y is NAN, this function returns NAN + NANi and throws the FE_INVALID exception. If x is a positive infinity and y is 0, this function returns HUGE_VALF. If x is a positive infinity and y is a positive infinity, this function returns +(-)HUGE_VALF + NANi (the sign bit of the real part of the returned value is uncertain) and throws the FE_INVALID exception. If x is a positive or negative infinity and y is NAN, this function returns HUGE_VALF + NANi. If x is NAN and y is 0, this function returns NAN. If x is NAN and y is neither an infinity nor 0, this function returns NAN + NANi and throws the FE_INVALID exception. If x and y are both NAN, this function returns NAN + NANi.

ccoshl()

  1. longdouble[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) ccoshl (long double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the hyperbolic cosine of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a long double value) whose hyperbolic cosine is to be obtained.

Returns:

Returns the hyperbolic cosine of z if the operation is successful. If x and y are both 0, this function returns 1. If x is 0 and y is a positive infinity, this function returns NAN and throws the FE_INVALID exception. If x is 0 and y is NAN, this function returns NAN. If x is neither an infinity nor 0 and y is a positive infinity, this function returns NAN + NANi and throws the FE_INVALID exception. If x is a negative infinity and y is NAN, this function returns NAN + NANi and throws the FE_INVALID exception. If x is a positive infinity and y is 0, this function returns HUGE_VALL. If x is a positive infinity and y is a positive infinity, this function returns +(-)HUGE_VALL + NANi (the sign bit of the real part of the returned value is uncertain) and throws the FE_INVALID exception. If x is a positive or negative infinity and y is NAN, this function returns HUGE_VALL + NANi. If x is NAN and y is 0, this function returns NAN. If x is NAN and y is neither an infinity nor 0, this function returns NAN + NANi and throws the FE_INVALID exception. If x and y are both NAN, this function returns NAN + NANi.

ccosl()

  1. longdouble[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) ccosl (long double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the cosine of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a long double value) whose cosine is to be obtained.

Returns:

Returns the cosine of z if the operation is successful. If x and y are both 0, this function returns 1. If x is 0 and y is a positive infinity, this function returns HUGE_VALL. If x is 0 and y is NAN, this function returns NAN. If x is a negative infinity and y is 0, this function returns NAN and throws the FE_INVALID exception. If x is a negative infinity and y is a positive infinity, this function returns +(-)HUGE_VALL + NANi (the sign bit of the real part of the returned value is uncertain) and throws the FE_INVALID exception. If x is a negative infinity and y is neither an infinity nor 0, this function returns NAN + NANi and throws the FE_INVALID exception. If x is NAN and y is 0, this function returns NAN. If x is NAN and y is a positive infinity, this function returns NAN + NANi and throws the FE_INVALID exception. If x is NAN and y is a positive or negative infinity, this function returns HUGE_VALL + NANi. If x is neither an infinity nor 0 and y is NAN, this returns NAN + NANi and throws the FE_INVALID exception. If x and y are both NAN, this function returns NAN + NANi.

ceil()

  1. double ceil (double x)

Description:

Calculates the minimum integer greater than or equal to the double value x.

Parameters:

Name

Description

xIndicates the double value x to compare with.

Returns:

Returns the minimum integer greater than or equal to x if the operation is successful; returns the passed x if x is an integer, +0, -0, a NaN value, or an infinity.

ceilf()

  1. float ceilf (float x)

Description:

Calculates the minimum integer greater than or equal to the float value x.

Parameters:

Name

Description

xIndicates the float value x to compare with.

Returns:

Returns the minimum integer greater than or equal to x if the operation is successful; returns the passed x if x is an integer, +0, -0, a NaN value, or an infinity.

ceill()

  1. longdouble ceill (longdouble x)

Description:

Calculates the minimum integer greater than or equal to the long double value x.

Parameters:

Name

Description

xIndicates the long double value x to compare with.

Returns:

Returns the minimum integer greater than or equal to x if the operation is successful; returns the passed x if x is an integer, +0, -0, a NaN value, or an infinity.

cexp()

  1. double[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) cexp (double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the base-e exponential of the complex number z.

The mathematical formula is e^z. z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a double value) whose base-e exponential is to be obtained.

Returns:

Returns the base-e exponential of z if the operation is successful. If x and y are both 0, this function returns 1. If x is not an infinity and y is a positive infinity, this function returns NAN + NANi and throws the FE_INVALID exception. If x is not an infinity and y is NAN, this function returns NAN + NANi and may throw the FE_INVALID exception. If x is a positive infinity and y is 0, this function returns HUGE_VAL. If x is a negative infinity and y is an infinity or NAN, this function returns 0. If x is a positive infinity and y is neither an infinity nor 0, this function returns HUGE_VAL*(cos(y) + isin(y)). If x and y are both positive infinity, this function returns +(-)HUGE_VAL + NANi (the sign bit of the real part of the returned value is uncertain) and throws the FE_INVALID exception. If x is a positive infinity and y is NAN, this function returns +(-)HUGE_VAL + NANi (the sign bit of the real part of the returned value is uncertain). If x is NAN and y is 0, this function returns NAN. If x is NAN and y is not 0, this function returns HUGE_VAL + NANi and throws the FE_INVALID exception. If x and y are both NAN, this function returns NAN + NANi.

cexpf()

  1. float[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) cexpf (float [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the base-e exponential of the complex number z.

The mathematical formula is e^z. z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a float value) whose base-e exponential is to be obtained.

Returns:

Returns the base-e exponential of z if the operation is successful. If x and y are both 0, this function returns 1. If x is not an infinity and y is a positive infinity, this function returns NAN + NANi and throws the FE_INVALID exception. If x is not an infinity and y is NAN, this function returns NAN + NANi and may throw the FE_INVALID exception. If x is a positive infinity and y is 0, this function returns HUGE_VALF. If x is a negative infinity and y is an infinity or NAN, this function returns 0. If x is a positive infinity and y is neither an infinity nor 0, this function returns HUGE_VALF*(cos(y) + isin(y)). If x and y are both positive infinity, this function returns +(-)HUGE_VALF + NANi (the sign bit of the real part of the returned value is uncertain) and throws the FE_INVALID exception. If x is a positive infinity and y is NAN, this function returns +(-) HUGE_VALF + NANi (the sign bit of the real part of the returned value is uncertain). If x is NAN and y is 0, this function returns NAN. If x is NAN and y is not 0, this function returns HUGE_VALF + NANi and throws the FE_INVALID exception. If x and y are both NAN, this function returns NAN + NANi.

cexpl()

  1. longdouble[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) cexpl (long double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the base-e exponential of the complex number z.

The mathematical formula is e^z. z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a long double value) whose base-e exponential is to be obtained.

Returns:

Returns the base-e exponential of z if the operation is successful. If x and y are both 0, this function returns 1. If x is not an infinity and y is a positive infinity, this function returns NAN + NANi and throws the FE_INVALID exception. If x is not an infinity and y is NAN, this function returns NAN + NANi and may throw the FE_INVALID exception. If x is a positive infinity and y is 0, this function returns HUGE_VALL. If x is a negative infinity and y is an infinity or NAN, this function returns 0. If x is a positive infinity and y is neither an infinity nor 0, this function returns HUGE_VALL*(cos(y) + isin(y)). If x and y are both positive infinity, this function returns +(-)HUGE_VALL + NANi (the sign bit of the real part of the returned value is uncertain) and throws the FE_INVALID exception. If x is a positive infinity and y is NAN, this function returns +(-)HUGE_VALL + NANi (the sign bit of the real part of the returned value is uncertain). If x is NAN and y is 0, this function returns NAN. If x is NAN and y is not 0, this function returns HUGE_VALL + NANi and throws the FE_INVALID exception. If x and y are both NAN, this function returns NAN + NANi.

cimag()

  1. double cimag (double[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the imaginary part of the complex number z.

Parameters:

Name

Description

zIndicates the complex number (a double value) whose imaginary part is to be obtained.

Returns:

Returns the imaginary part of z if the operation is successful.

cimagf()

  1. float cimagf (float[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the imaginary part of the complex number z.

Parameters:

Name

Description

zIndicates the complex number (a float value) whose imaginary part is to be obtained.

Returns:

Returns the imaginary part of z if the operation is successful.

cimagl()

  1. longdouble cimagl (longdouble[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the imaginary part of the complex number z.

Parameters:

Name

Description

zIndicates the complex number (a long double value) whose imaginary part is to be obtained.

Returns:

Returns the imaginary part of z if the operation is successful.

clog()

  1. double[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) clog (double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the natural (base-e) logarithm of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a double value) whose natural (base-e) logarithm is to be obtained.

Returns:

Returns the natural (base-e) logarithm of z if the operation is successful. If x is -0 and y is +0, this function returns -HUGE_VAL + M_PIi and throws the FE_DIVBYZERO exception. If x and y are both +0, this function returns -HUGE_VAL + 0i and throws the FE_DIVBYZERO exception. If x is not an infinity and y is a positive infinity, this function returns HUGE_VAL + M_PI_2i. If x is not an infinity and y is NAN, this function returns NAN + NANi and may throw the FE_INVALID exception. If x is a negative infinity and y is a positive finite value, this function returns HUGE_VAL + M_PIi. If x is a negative infinity and y is a positive infinity, this function returns HUGE_VAL + 3*M_PI_4i. If x is a positive infinity and y is a positive finite value, this function returns HUGE_VAL + 0i. If x and y are both positive infinity, this function returns HUGE_VAL + M_PI_4i. If x is an infinity and y is NAN, this function returns HUGE_VAL + NANi. If x is NAN and y is not an infinity, this function returns NAN + NANi and may throw the FE_INVALID exception. If x is NAN and y is a positive infinity, this function returns HUGE_VAL + NANi. If x and y are both NAN, this function returns NAN + NANi.

clogf()

  1. float[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) clogf (float [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the natural (base-e) logarithm of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a float value) whose natural (base-e) logarithm is to be obtained.

Returns:

Returns the natural (base-e) logarithm of z if the operation is successful. If x is -0 and y is +0, this function returns -HUGE_VALF + M_PIi and throws the FE_DIVBYZERO exception. If x and y are both +0, this function returns -HUGE_VALF + 0i and throws the FE_DIVBYZERO exception. If x is not an infinity and y is a positive infinity, this function returns HUGE_VALF + M_PI_2i. If x is not an infinity and y is NAN, this function returns NAN + NANi and may throw the FE_INVALID exception. If x is a negative infinity and y is a positive finite value, this function returns HUGE_VALF + M_PIi. If x is a negative infinity and y is a positive infinity, this function returns HUGE_VALF + 3*M_PI_4i. If x is a positive infinity and y is a positive finite value, this function returns HUGE_VALF + 0i. If x and y are both positive infinity, this function returns HUGE_VALF + M_PI_4i. If x is an infinity and y is NAN, this function returns HUGE_VALF + NANi. If x is NAN and y is not an infinity, this function returns NAN + NANi and may throw the FE_INVALID exception. If x is NAN and y is a positive infinity, this function returns HUGE_VALF + NANi. If x and y are both NAN, this function returns NAN + NANi.

clogl()

  1. longdouble[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) clogl (long double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the natural (base-e) logarithm of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a long double value) whose natural (base-e) logarithm is to be obtained.

Returns:

Returns the natural (base-e) logarithm of z if the operation is successful. If x is -0 and y is +0, this function returns -HUGE_VALL + M_PIi and throws the FE_DIVBYZERO exception. If x and y are both +0, this function returns -HUGE_VALL + 0i and throws the FE_DIVBYZERO exception. If x is not an infinity and y is a positive infinity, this function returns HUGE_VALL + M_PI_2i. If x is not an infinity and y is NAN, this function returns NAN + NANi and may throw the FE_INVALID exception. If x is a negative infinity and y is a positive finite value, this function returns HUGE_VALL + M_PIi. If x is a negative infinity and y is a positive infinity, this function returns HUGE_VALL + 3*M_PI_4i. If x is a positive infinity and y is a positive finite value, this function returns HUGE_VALL + 0i. If x and y are both positive infinity, this function returns HUGE_VALL + M_PI_4i. If x is an infinity and y is NAN, this function returns HUGE_VALL + NANi. If x is NAN and y is not an infinity, this function returns NAN + NANi and may throw the FE_INVALID exception. If x is NAN and y is a positive infinity, this function returns HUGE_VALL + NANi. If x and y are both NAN, this function returns NAN + NANi.

conj()

  1. double[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) conj (double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the conjugate of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a double value) whose conjugate is to be obtained.

Returns:

Returns the conjugate of z, which is equal to x - yi.

conjf()

  1. float[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) conjf (float [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the conjugate of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a float value) whose conjugate is to be obtained.

Returns:

Returns the conjugate of z, which is equal to x - yi.

conjl()

  1. longdouble[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) conjl (long double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the conjugate of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a long double value) whose conjugate is to be obtained.

Returns:

Returns the conjugate of z, which is equal to x - yi.

copysign()

  1. double copysign (double x,double y )

Description:

Generates a value by combining the magnitude of the double value x and the sign of the double value y.

For example, if x is 42.0 and y is -1.0, value -42.0 will be generated.

Parameters:

Name

Description

xIndicates the double value x whose magnitude will be used.
yIndicates the double value y whose sign will be used.

Returns:

Returns the generated value if the operation is successful; returns a NaN value with the sign of y if x is a NaN value.

copysignf()

  1. float copysignf (float x,float y )

Description:

Generates a value by combining the magnitude of the float value x and the sign of the float value y.

For example, if x is 42.0 and y is -1.0, value -42.0 will be generated.

Parameters:

Name

Description

xIndicates the float value x whose magnitude will be used.
yIndicates the float value y whose sign will be used.

Returns:

Returns the generated value if the operation is successful; returns a NaN value with the sign of y if x is a NaN value.

copysignl()

  1. longdouble copysignl (longdouble x,longdouble y )

Description:

Generates a value by combining the magnitude of the long double value x and the sign of the long double value y.

For example, if x is 42.0 and y is -1.0, value -42.0 will be generated.

Parameters:

Name

Description

xIndicates the long double value x whose magnitude will be used.
yIndicates the long double value y whose magnitude will be used.

Returns:

Returns the generated value if the operation is successful; returns a NaN value with the sign of y if x is a NaN value.

cos()

  1. double cos (double x)

Description:

Calculates the cosine of the double value x.

Parameters:

Name

Description

xIndicates the double value.

Returns:

Returns the cosine of x if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is a positive or negative infinity, this function returns a NaN value, reports a domain error, sets errno to EDOM, and throws the FE_INVALID exception.

cosf()

  1. float cosf (float x)

Description:

Calculates the cosine of the float value x.

Parameters:

Name

Description

xIndicates the float value.

Returns:

Returns the cosine of x if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is a positive or negative infinity, this function returns a NaN value, reports a domain error, sets errno to EDOM, and throws the FE_INVALID exception.

cosh()

  1. double cosh (double x)

Description:

Calculates the hyperbolic cosine of the double value x.

Parameters:

Name

Description

xIndicates the double value.

Returns:

Returns the hyperbolic cosine of x if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is +0 or -0, this function returns 1. If x is a positive or negative infinity, this function returns a positive infinity. If an overflow range error occurs, this function returns HUGE_VAL, sets errno to ERANGE, and throws the FE_OVERFLOW exception.

coshf()

  1. float coshf (float x)

Description:

Calculates the hyperbolic cosine of the float value x.

Parameters:

Name

Description

xIndicates the float value.

Returns:

Returns the hyperbolic cosine of x if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is +0 or -0, this function returns 1. If x is a positive or negative infinity, this function returns a positive infinity. If an overflow range error occurs, this function returns HUGE_VALF, sets errno to ERANGE, and throws the FE_OVERFLOW exception.

coshl()

  1. longdouble coshl (longdouble x)

Description:

Calculates the hyperbolic cosine of the long double value x.

Parameters:

Name

Description

xIndicates the long double value.

Returns:

Returns the hyperbolic cosine of x if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is +0 or -0, this function returns 1. If x is a positive or negative infinity, this function returns a positive infinity. If an overflow range error occurs, this function returns HUGE_VALL, sets errno to ERANGE, and throws the FE_OVERFLOW exception.

cosl()

  1. longdouble cosl (longdouble x)

Description:

Calculates the cosine of the long double value x.

Parameters:

Name

Description

xIndicates the long double value.

Returns:

Returns the cosine of x if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is a positive or negative infinity, this function returns a NaN value, reports a domain error, sets errno to EDOM, and throws the FE_INVALID exception.

cpow()

  1. double[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) cpow (double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) x, double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z )

Description:

Calculates the value of x raised to the z power.

The mathematical formula is x^z.

Parameters:

Name

Description

xIndicates the base (a double complex number).
zIndicates the exponent (a double complex number).

Attention:

If an error occurs or x or z is a positive or negative infinity or NAN, the returned value is calculated based on the formula cexp(z*clog(x)).

Returns:

Returns the value of x raised to the z power if the operation is successful.

cpowf()

  1. float[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) cpowf (float [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) x, float [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z )

Description:

Calculates the value of x raised to the z power.

The mathematical formula is x^z.

Parameters:

Name

Description

xIndicates the base (a float complex number).
zIndicates the exponent (a float complex number).

Attention:

If an error occurs or x or z is a positive or negative infinity or NAN, the returned value is calculated based on the formula cexp(z*clog(x)).

Returns:

Returns the value of x raised to the z power if the operation is successful.

cpowl()

  1. longdouble[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) cpowl (long double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) x, long double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z )

Description:

Calculates the value of x raised to the z power.

The mathematical formula is x^z.

Parameters:

Name

Description

xIndicates the base (a long double complex number).
zIndicates the exponent (a long double complex number).

Attention:

If an error occurs or x or z is a positive or negative infinity or NAN, the returned value is calculated based on the formula cexp(z*clog(x)).

Returns:

Returns the value of x raised to the z power if the operation is successful.

cproj()

  1. double[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) cproj (double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the projection of the complex number z onto the Riemann sphere.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a double value) whose projection onto the Riemann sphere is to be obtained.

Returns:

Returns the projection of z onto the Riemann sphere if the operation is successful. If x is NAN and y is an infinity, this function returns HUGE_VAL. If x is an infinity, this function returns HUGE_VAL + i*copysign(0.0, cimag(z)).

cprojf()

  1. float[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) cprojf (float [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the projection of the complex number z onto the Riemann sphere.

Parameters:

Name

Description

zIndicates the complex number (a float value) whose projection onto the Riemann sphere is to be obtained.

Returns:

Returns the projection of z onto the Riemann sphere if the operation is successful. If x is NAN and y is an infinity, this function returns HUGE_VALF. If x is an infinity, this function returns HUGE_VALF + i*copysign(0.0, cimag(z)).

cprojl()

  1. longdouble[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) cprojl (long double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the projection of the complex number z onto the Riemann sphere.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a long double value) whose projection onto the Riemann sphere is to be obtained.

Returns:

Returns the projection of z onto the Riemann sphere if the operation is successful. If x is NAN and y is an infinity, this function returns HUGE_VALL. If x is an infinity, this function returns HUGE_VALL + i*copysign(0.0, cimag(z)).

creal()

  1. double creal (double[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the real part of the complex number z.

Parameters:

Name

Description

zIndicates the complex number (a double value) whose real part is to be obtained.

Returns:

Returns the real part of z if the operation is successful.

crealf()

  1. float crealf (float[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the real part of the complex number z.

Parameters:

Name

Description

zIndicates the complex number (a float value) whose real part is to be obtained.

Returns:

Returns the real part of z if the operation is successful.

creall()

  1. longdouble creall (longdouble[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the real part of the complex number z.

Parameters:

Name

Description

zIndicates the complex number (a long double value) whose real part is to be obtained.

Returns:

Returns the real part of z if the operation is successful.

csin()

  1. double[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) csin (double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the sine of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a double value) whose sine is to be obtained.

Returns:

Returns the sine of z if the operation is successful. If x and y are both 0, this function returns 0. If x is 0 and y is a positive infinity, this function returns NANi and throws the FE_INVALID exception. If x is 0 and y is NAN, this function returns NANi. If x is a positive finite value and y is a positive infinity, this function returns NAN + NANi and throws the FE_INVALID exception. If x is a positive finite value and y is NAN, this function returns NAN + NANi and throws the FE_INVALID exception. If x is a positive infinity and y is 0, this function returns HUGE_VAL. If x is a positive infinity and y is a positive finite value, this function returns HUGE_VAL*(cos(y) + isin(y)). If x and y are both positive infinity, this function returns +(-)HUGE_VAL + NANi (the sign bit of the real part of the returned value is uncertain) and throws the FE_INVALID exception. If x is a positive infinity and y is NAN, this function returns +(-)HUGE_VAL + NANi (the sign bit of the real part of the returned value is uncertain). If x is NAN and y is 0, this function returns NAN. If x is NAN and y is not 0, this function returns NAN + NANi and throws the FE_INVALID exception. If x and y are both NAN, this function returns NAN + NANi.

csinf()

  1. float[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) csinf (float [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the sine of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a float value) whose sine is to be obtained.

Returns:

Returns the sine of z if the operation is successful. If x and y are both 0, this function returns 0. If x is 0 and y is a positive infinity, this function returns NANi and throws the FE_INVALID exception. If x is 0 and y is NAN, this function returns NANi. If x is a positive finite value and y is a positive infinity, this function returns NAN + NANi and throws the FE_INVALID exception. If x is a positive finite value and y is NAN, this function returns NAN + NANi and throws the FE_INVALID exception. If x is a positive infinity and y is 0, this function returns HUGE_VALF. If x is a positive infinity and y is a positive finite value, this function returns HUGE_VALF*(cos(y) + isin(y)). If x and y are both positive infinity, this function returns +(-)HUGE_VALF + NANi (the sign bit of the real part of the returned value is uncertain) and throws the FE_INVALID exception. If x is a positive infinity and y is NAN, this function returns +(-) HUGE_VALF + NANi (the sign bit of the real part of the returned value is uncertain). If x is NAN and y is 0, this function returns NAN. If x is NAN and y is not 0, this function returns NAN + NANi and throws the FE_INVALID exception. If x and y are both NAN, this function returns NAN + NANi.

csinh()

  1. double[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) csinh (double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the hyperbolic sine of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a double value) whose hyperbolic sine is to be obtained.

Returns:

Returns the hyperbolic sine of z if the operation is successful. If x and y are both 0, this function returns 0. If x is 0 and y is a positive infinity, this function returns NANi and throws the FE_INVALID exception. If x is 0 and y is NAN, this function returns NANi. If x is a positive finite value and y is a positive infinity, this function returns NAN + NANi and throws the FE_INVALID exception. If x is a positive finite value and y is NAN, this function returns NAN + NANi and throws the FE_INVALID exception. If x is a positive infinity and y is 0, this function returns HUGE_VAL. If x is a positive infinity and y is a positive finite value, this function returns HUGE_VAL*(cos(y) + isin(y)). If x and y are both positive infinity, this function returns +(-)HUGE_VAL + NANi (the sign bit of the real part of the returned value is uncertain) and throws the FE_INVALID exception. If x is a positive infinity and y is NAN, this function returns +(-)HUGE_VAL + NANi (the sign bit of the real part of the returned value is uncertain). If x is NAN and y is 0, this function returns NAN. If x is NAN and y is not 0, this function returns NAN + NANi and throws the FE_INVALID exception. If x and y are both NAN, this function returns NAN + NANi.

csinhf()

  1. float[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) csinhf (float [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the hyperbolic sine of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a float value) whose hyperbolic sine is to be obtained.

Returns:

Returns the hyperbolic sine of z if the operation is successful. If x and y are both 0, this function returns 0. If x is 0 and y is a positive infinity, this function returns NANi and throws the FE_INVALID exception. If x is 0 and y is NAN, this function returns NANi. If x is a positive finite value and y is a positive infinity, this function returns NAN + NANi and throws the FE_INVALID exception. If x is a positive finite value and y is NAN, this function returns NAN + NANi and throws the FE_INVALID exception. If x is a positive infinity and y is 0, this function returns HUGE_VALF. If x is a positive infinity and y is a positive finite value, this function returns HUGE_VALF*(cos(y) + isin(y)). If x and y are both positive infinity, this function returns +(-)HUGE_VALF + NANi (the sign bit of the real part of the returned value is uncertain) and throws the FE_INVALID exception. If x is a positive infinity and y is NAN, this function returns +(-) HUGE_VALF + NANi (the sign bit of the real part of the returned value is uncertain). If x is NAN and y is 0, this function returns NAN. If x is NAN and y is not 0, this function returns NAN + NANi and throws the FE_INVALID exception. If x and y are both NAN, this function returns NAN + NANi.

csinhl()

  1. longdouble[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) csinhl (long double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the hyperbolic sine of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a long double value) whose hyperbolic sine is to be obtained.

Returns:

Returns the hyperbolic sine of z if the operation is successful. If x and y are both 0, this function returns 0. If x is 0 and y is a positive infinity, this function returns NANi and throws the FE_INVALID exception. If x is 0 and y is NAN, this function returns NANi. If x is a positive finite value and y is a positive infinity, this function returns NAN + NANi and throws the FE_INVALID exception. If x is a positive finite value and y is NAN, this function returns NAN + NANi and throws the FE_INVALID exception. If x is a positive infinity and y is 0, this function returns HUGE_VALL. If x is a positive infinity and y is a positive finite value, this function returns HUGE_VALL*(cos(y) + isin(y)). If x and y are both positive infinity, this function returns +(-)HUGE_VALL + NANi (the sign bit of the real part of the returned value is uncertain) and throws the FE_INVALID exception. If x is a positive infinity and y is NAN, this function returns +(-)HUGE_VALL + NANi (the sign bit of the real part of the returned value is uncertain). If x is NAN and y is 0, this function returns NAN. If x is NAN and y is not 0, this function returns NAN + NANi and throws the FE_INVALID exception. If x and y are both NAN, this function returns NAN + NANi.

csinl()

  1. longdouble[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) csinl (long double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the sine of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a long double value) whose sine is to be obtained.

Returns:

Returns the sine of z if the operation is successful. If x and y are both 0, this function returns 0. If x is 0 and y is a positive infinity, this function returns NANi and throws the FE_INVALID exception. If x is 0 and y is NAN, this function returns NANi. If x is a positive finite value and y is a positive infinity, this function returns NAN + NANi and throws the FE_INVALID exception. If x is a positive finite value and y is NAN, this function returns NAN + NANi and throws the FE_INVALID exception. If x is a positive infinity and y is 0, this function returns HUGE_VALL. If x is a positive infinity and y is a positive finite value, this function returns HUGE_VALL*(cos(y) + isin(y)). If x and y are both positive infinity, this function returns +(-)HUGE_VALL + NANi (the sign bit of the real part of the returned value is uncertain) and throws the FE_INVALID exception. If x is a positive infinity and y is NAN, this function returns +(-)HUGE_VALL + NANi (the sign bit of the real part of the returned value is uncertain). If x is NAN and y is 0, this function returns NAN. If x is NAN and y is not 0, this function returns NAN + NANi and throws the FE_INVALID exception. If x and y are both NAN, this function returns NAN + NANi.

csqrt()

  1. double[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) csqrt (double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the square root of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a double value) whose square root is to be obtained.

Returns:

Returns the square root of z if the operation is successful. If x is +0 or -0 and y is +0, this function returns +0 + 0i. If x is neither an infinity nor NAN and y is a positive infinity, this function returns HUGE_VAL + HUGE_VALi. If x is a finite value or NAN and y is NAN, this function returns NAN + NANi and may throw the FE_INVALID exception. If x is a negative infinity and y is a positive finite value, this function returns HUGE_VALi. If x is a negative infinity and y is NAN, this function returns NAN +(-) HUGE_VALi (the sign bit of the imaginary part of the returned value is uncertain). If x is a positive infinity and y is a positive finite value, this function returns HUGE_VAL + 0i. If x is a positive infinity and y is NAN, this function returns HUGE_VAL + NANi. If x is NAN and y is any value, this function returns NAN + NANi and may throw the FE_INVALID exception. If x and y are both NAN, this function returns NAN + NANi.

csqrtf()

  1. float[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) csqrtf (float [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the square root of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a float value) whose square root is to be obtained.

Returns:

Returns the square root of z if the operation is successful. If x is +0 or -0 and y is +0, this function returns +0 + 0i. If x is neither an infinity nor NAN and y is a positive infinity, this function returns HUGE_VALF + HUGE_VALFi. If x is a finite value or NAN and y is NAN, this function returns NAN + NANi and may throw the FE_INVALID exception. If x is a negative infinity and y is a positive finite value, this function returns HUGE_VALFi. If x is a negative infinity and y is NAN, this function returns NAN +(-) HUGE_VALFi (the sign bit of the imaginary part of the returned value is uncertain). If x is a positive infinity and y is a positive finite value, this function returns HUGE_VALF + 0i. If x is a positive infinity and y is NAN, this function returns HUGE_VALF + NANi. If x is NAN and y is any value, this function returns NAN + NANi and may throw the FE_INVALID exception. If x and y are both NAN, this function returns NAN + NANi.

csqrtl()

  1. longdouble[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) csqrtl (long double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the square root of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a long double value) whose square root is to be obtained.

Returns:

Returns the square root of z if the operation is successful. If x is +0 or -0 and y is +0, this function returns +0 + 0i. If x is neither an infinity nor NAN and y is a positive infinity, this function returns HUGE_VALL + HUGE_VALLi. If x is a finite value or NAN and y is NAN, this function returns NAN + NANi and may throw the FE_INVALID exception. If x is a negative infinity and y is a positive finite value, this function returns HUGE_VALLi. If x is a negative infinity and y is NAN, this function returns NAN +(-) HUGE_VALLi (the sign bit of the imaginary part of the returned value is uncertain). If x is a positive infinity and y is a positive finite value, this function returns HUGE_VALL + 0i. If x is a positive infinity and y is NAN, this function returns HUGE_VALL+NANi. If x is NAN and y is any value, this function returns NAN + NANi and may throw the FE_INVALID exception. If x and y are both NAN, this function returns NAN + NANi.

ctan()

  1. double[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) ctan (double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the tangent of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a double value) whose tangent is to be obtained.

Returns:

Returns the tangent of z if the operation is successful. If x and y are both 0, this function returns 0. If x is not an infinity and y is a positive infinity, this function returns NAN + NANi and throws the FE_INVALID exception. If x is not an infinity and y is NAN, this function returns NAN + NANi and may throw the FE_INVALID exception. If x is a positive infinity and y is a positive finite value, this function returns 1. If x and y are both positive infinity, this function returns 1. If x is a positive infinity and y is NAN, this function returns 1. If x is NAN and y is 0, this function returns NAN. If x is NAN and y is not 0, this function returns NAN + NANi and throws the FE_INVALID exception. If x and y are both NAN, this function returns NAN + NANi.

ctanf()

  1. float[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) ctanf (float [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the tangent of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a float value) whose tangent is to be obtained.

Returns:

Returns the tangent of z if the operation is successful. If x and y are both 0, this function returns 0. If x is not an infinity and y is a positive infinity, this function returns NAN + NANi and throws the FE_INVALID exception. If x is not an infinity and y is NAN, this function returns NAN + NANi and may throw the FE_INVALID exception. If x is a positive infinity and y is a positive finite value, this function returns 1. If x and y are both positive infinity, this function returns 1. If x is a positive infinity and y is NAN, this function returns 1. If x is NAN and y is 0, this function returns NAN. If x is NAN and y is not 0, this function returns NAN + NANi and throws the FE_INVALID exception. If x and y are both NAN, this function returns NAN + NANi.

ctanh()

  1. double[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) ctanh (double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the hyperbolic tangent of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a double value) whose hyperbolic tangent is to be obtained.

Returns:

Returns the hyperbolic tangent of z if the operation is successful. If x and y are both 0, this function returns 0. If x is not an infinity and y is a positive infinity, this function returns NAN + NANi and throws the FE_INVALID exception. If x is not an infinity and y is NAN, this function returns NAN + NANi and may throw the FE_INVALID exception. If x is a positive infinity and y is a positive finite value, this function returns 1. If x and y are both positive infinity, this function returns 1. If x is a positive infinity and y is NAN, this function returns 1. If x is NAN and y is 0, this function returns NAN. If x is NAN and y is not 0, this function returns NAN + NANi and throws the FE_INVALID exception. If x and y are both NAN, this function returns NAN + NANi.

ctanhf()

  1. float[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) ctanhf (float [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the hyperbolic tangent of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a float value) whose hyperbolic tangent is to be obtained.

Returns:

Returns the hyperbolic tangent of z if the operation is successful. If x and y are both 0, this function returns 0. If x is not an infinity and y is a positive infinity, this function returns NAN + NANi and throws the FE_INVALID exception. If x is not an infinity and y is NAN, this function returns NAN + NANi and may throw the FE_INVALID exception. If x is a positive infinity and y is a positive finite value, this function returns 1. If x and y are both positive infinity, this function returns 1. If x is a positive infinity and y is NAN, this function returns 1. If x is NAN and y is 0, this function returns NAN. If x is NAN and y is not 0, this function returns NAN + NANi and throws the FE_INVALID exception. If x and y are both NAN, this function returns NAN + NANi.

ctanhl()

  1. longdouble[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) ctanhl (long double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the hyperbolic tangent of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a long double value) whose hyperbolic tangent is to be obtained.

Returns:

Returns the hyperbolic tangent of z if the operation is successful. If x and y are both 0, this function returns 0. If x is not an infinity and y is a positive infinity, this function returns NAN + NANi and throws the FE_INVALID exception. If x is not an infinity and y is NAN, this function returns NAN + NANi and may throw the FE_INVALID exception. If x is a positive infinity and y is a positive finite value, this function returns 1. If x and y are both positive infinity, this function returns 1. If x is a positive infinity and y is NAN, this function returns 1. If x is NAN and y is 0, this function returns NAN. If x is NAN and y is not 0, this function returns NAN + NANi and throws the FE_INVALID exception. If x and y are both NAN, this function returns NAN + NANi.

ctanl()

  1. longdouble[complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) ctanl (long double [complex]($api-api-SmartVision-Devices-MATH.md#ga0fa4878c968311979d497ccc322e0b9b) z)

Description:

Calculates the tangent of the complex number z.

z = x + yi, where i = sqrt(-1)

Parameters:

Name

Description

zIndicates the complex number (a long double value) whose tangent is to be obtained.

Returns:

Returns the tangent of z if the operation is successful. If x and y are both 0, this function returns 0. If x is not an infinity and y is a positive infinity, this function returns NAN + NANi and throws the FE_INVALID exception. If x is not an infinity and y is NAN, this function returns NAN + NANi and may throw the FE_INVALID exception. If x is a positive infinity and y is a positive finite value, this function returns 1. If x and y are both positive infinity, this function returns 1. If x is a positive infinity and y is NAN, this function returns 1. If x is NAN and y is 0, this function returns NAN. If x is NAN and y is not 0, this function returns NAN + NANi and throws the FE_INVALID exception. If x and y are both NAN, this function returns NAN + NANi.

erf()

  1. double erf (double x)

Description:

Calculates the error function of the double value x.

Parameters:

Name

Description

xIndicates the double value.

Returns:

Returns the error function if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is +0 or -0, this function returns +0 or -0, respectively. If x is a positive or negative infinity, this function returns +1 or -1, respectively. If an underflow range error occurs, this function returns 2*x/sqrt(pi) and throws the FE_UNDERFLOW exception.

erfc()

  1. double erfc (double x)

Description:

Calculates the complementary error function of the double value x.

Parameters:

Name

Description

xIndicates the double value.

Returns:

Returns the complementary error function if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is +0 or -0, this function returns 1. If x is a positive infinity, this function returns +0. If x is a negative infinity, this function returns +2. If an underflow range error occurs and an unrepresentable value is generated, this function returns 0.0. If an underflow range error occurs and a representable value is generated, this function returns 0 and throws the FE_UNDERFLOW exception.

erfcf()

  1. float erfcf (float x)

Description:

Calculates the complementary error function of the float value x.

Parameters:

Name

Description

xIndicates the float value.

Returns:

Returns the complementary error function if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is +0 or -0, this function returns 1. If x is a positive infinity, this function returns +0. If x is a negative infinity, this function returns +2. If an underflow range error occurs and an unrepresentable value is generated, this function returns 0.0. If an underflow range error occurs and a representable value is generated, this function returns 0 and throws the FE_UNDERFLOW exception.

erfcl()

  1. longdouble erfcl (longdouble x)

Description:

Calculates the complementary error function of the long double value x.

Parameters:

Name

Description

xIndicates the long double value.

Returns:

Returns the complementary error function if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is +0 or -0, this function returns 1. If x is a positive infinity, this function returns +0. If x is a negative infinity, this function returns +2. If an underflow range error occurs and an unrepresentable value is generated, this function returns 0.0. If an underflow range error occurs and a representable value is generated, this function returns 0 and throws the FE_UNDERFLOW exception.

erff()

  1. float erff (float x)

Description:

Calculates the error function of the float value x.

Parameters:

Name

Description

xIndicates the float value.

Returns:

Returns the error function if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is +0 or -0, this function returns +0 or -0, respectively. If x is a positive or negative infinity, this function returns +1 or -1, respectively. If an underflow range error occurs, this function returns 2*x/sqrt(pi) and throws the FE_UNDERFLOW exception.

erfl()

  1. longdouble erfl (longdouble x)

Description:

Calculates the error function of the long double value x.

Parameters:

Name

Description

xIndicates the long double value.

Returns:

Returns the error function if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is +0 or -0, this function returns +0 or -0, respectively. If x is a positive or negative infinity, this function returns +1 or -1, respectively. If an underflow range error occurs, this function returns 2*x/sqrt(pi) and throws the FE_UNDERFLOW exception.

exp()

  1. double exp (double x)

Description:

Calculates the base-e exponential function of the double value x.

Parameters:

Name

Description

xIndicates the double value.

Returns:

Returns the base-e exponential function of x if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is a positive infinity, this function returns a positive infinity. If x is a negative infinity, this function returns +0. If an underflow range error occurs, this function returns 0, sets errno to ERANGE, and throws the FE_UNDERFLOW exception. If an overflow range error occurs, this function returns +HUGE_VAL, sets errno to ERANGE, and throws the FE_OVERFLOW exception.

exp10()

  1. double exp10 (double x)

Description:

Calculates the base-10 exponential function of the double value x.

Parameters:

Name

Description

xIndicates the double value x used as the exponent.

Returns:

Returns the base-10 exponential function of x if the operation is successful.

exp10f()

  1. float exp10f (float x)

Description:

Calculates the base-10 exponential function of the float value x.

Parameters:

Name

Description

xIndicates the float value x used as the exponent.

Returns:

Returns the base-10 exponential function of x if the operation is successful.

exp10l()

  1. longdouble exp10l (longdouble x)

Description:

Calculates the base-10 exponential function of the long double value x.

Parameters:

Name

Description

xIndicates the long double value x used as the exponent.

Returns:

Returns the base-10 exponential function of x if the operation is successful.

exp2()

  1. double exp2 (double x)

Description:

Calculates the base-2 exponential function of the double value x.

Parameters:

Name

Description

xIndicates the double value.

Returns:

Returns the base-2 exponential function of x if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is a positive infinity, this function returns a positive infinity. If x is a negative infinity, this function returns +0. If an underflow range error occurs, this function returns 0, sets errno to ERANGE, and throws the FE_UNDERFLOW exception. If an overflow range error occurs, this function returns +HUGE_VALL, sets errno to ERANGE, and throws the FE_OVERFLOW exception.

exp2f()

  1. float exp2f (float x)

Description:

Calculates the base-2 exponential function of the float value x.

Parameters:

Name

Description

xIndicates the float value.

Returns:

Returns the base-2 exponential function of x if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is a positive infinity, this function returns a positive infinity. If x is a negative infinity, this function returns +0. If an underflow range error occurs, this function returns 0, sets errno to ERANGE, and throws the FE_UNDERFLOW exception. If an overflow range error occurs, this function returns +HUGE_VALL, sets errno to ERANGE, and throws the FE_OVERFLOW exception.

exp2l()

  1. longdouble exp2l (longdouble x)

Description:

Calculates the base-2 exponential function of the long double value x.

Parameters:

Name

Description

xIndicates the long double value.

Returns:

Returns the base-2 exponential function of x if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is a positive infinity, this function returns a positive infinity. If x is a negative infinity, this function returns +0. If an underflow range error occurs, this function returns 0, sets errno to ERANGE, and throws the FE_UNDERFLOW exception. If an overflow range error occurs, this function returns +HUGE_VALL, sets errno to ERANGE, and throws the FE_OVERFLOW exception.

expf()

  1. float expf (float x)

Description:

Calculates the base-e exponential function of the float value x.

Parameters:

Name

Description

xIndicates the float value.

Returns:

Returns the base-e exponential function of x if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is a positive infinity, this function returns a positive infinity. If x is a negative infinity, this function returns +0. If an underflow range error occurs, this function returns 0, sets errno to ERANGE, and throws the FE_UNDERFLOW exception. If an overflow range error occurs, this function returns +HUGE_VALF, sets errno to ERANGE, and throws the FE_OVERFLOW exception.

expl()

  1. longdouble expl (longdouble x)

Description:

Calculates the base-e exponential function of the long double value x.

Parameters:

Name

Description

xIndicates the long double value.

Returns:

Returns the base-e exponential function of x if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is a positive infinity, this function returns a positive infinity. If x is a negative infinity, this function returns +0. If an underflow range error occurs, this function returns 0, sets errno to ERANGE, and throws the FE_UNDERFLOW exception. If an overflow range error occurs, this function returns +HUGE_VALL, sets errno to ERANGE, and throws the FE_OVERFLOW exception.

expm1()

  1. double expm1 (double x)

Description:

Calculates e raised to the power of the double value x minus one, that is, (e^x)-1.

Parameters:

Name

Description

xIndicates the double value.

Returns:

Returns e raised to the power of x minus one if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is +0 or -0, this function returns +0 or -0, respectively. If x is a positive infinity, this function returns a positive infinity. If x is a negative infinity, this function returns -1. If an overflow range error occurs, this function returns +HUGE_VAL, sets errno to ERANGE, and throws the FE_OVERFLOW exception.

expm1f()

  1. float expm1f (float x)

Description:

Calculates e raised to the power of the float value x minus one.

Parameters:

Name

Description

xIndicates the float value.

Returns:

Returns e raised to the power of x minus one if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is +0 or -0, this function returns +0 or -0, respectively. If x is a positive infinity, this function returns a positive infinity. If x is a negative infinity, this function returns -1. If an overflow range error occurs, this function returns +HUGE_VALF, sets errno to ERANGE, and throws the FE_OVERFLOW exception.

expm1l()

  1. longdouble expm1l (longdouble x)

Description:

Calculates e raised to the power of the long double value x minus one.

Parameters:

Name

Description

xIndicates the long double value.

Returns:

Returns e raised to the power of x minus one if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is +0 or -0, this function returns +0 or -0, respectively. If x is a positive infinity, this function returns a positive infinity. If x is a negative infinity, this function returns -1. If an overflow range error occurs, this function returns +HUGE_VALL, sets errno to ERANGE, and throws the FE_OVERFLOW exception.

fabs()

  1. double fabs (double x)

Description:

Calculates the absolute value of the double value x.

Parameters:

Name

Description

xIndicates the double value.

Returns:

Returns the absolute value of x if the operation is successful; returns a NaN value if x is a NaN value; returns +0 if x is -0; returns a positive infinity if x is a positive or negative infinity.

fabsf()

  1. float fabsf (float x)

Description:

Calculates the absolute value of the float value x.

Parameters:

Name

Description

xIndicates the float value.

Returns:

Returns the absolute value of x if the operation is successful; returns a NaN value if x is a NaN value; returns +0 if x is -0; returns a positive infinity if x is a positive or negative infinity.

fabsl()

  1. longdouble fabsl (longdouble x)

Description:

Calculates the absolute value of the long double value x.

Parameters:

Name

Description

xIndicates the long double value.

Returns:

Returns the absolute value of x if the operation is successful; returns a NaN value if x is a NaN value; returns +0 if x is -0; returns a positive infinity if x is a positive or negative infinity.

fdim()

  1. double fdim (double x,double y )

Description:

Calculates the positive difference between the double value x and y.

Parameters:

Name

Description

xIndicates the double value x.
yIndicates the double value y.

Returns:

Returns the positive difference between x and y.

fdimf()

  1. float fdimf (float x,float y )

Description:

Calculates the positive difference between the float value x and y.

Parameters:

Name

Description

xIndicates the float value x.
yIndicates the float value y.

Returns:

Returns the positive difference between x and y.

fdiml()

  1. longdouble fdiml (longdouble x,longdouble y )

Description:

Calculates the positive difference between the long double value x and y.

Parameters:

Name

Description

xIndicates the long double value x.
yIndicates the long double value y.

Returns:

Returns the positive difference between x and y.

feclearexcept()

  1. int feclearexcept (int excepts)

Description:

Clears floating-point exceptions specified by excepts.

Parameters:

Name

Description

exceptsIndicates the floating-point exceptions to clear.

Returns:

Returns 0 if the operation is successful; returns a non-zero value otherwise.

fegetenv()

  1. int fegetenv ([fenv_t]($api-api-SmartVision-Devices-fenv_t.md)* envp)

Description:

Stores the current floating-point environment into the object specified by envp.

The floating-point environment contains the current control modes and status flags of floating-point operations.

Parameters:

Name

Description

envpIndicates the pointer to the floating-point environment.

Returns:

Returns 0 if the operation is successful; returns a non-zero value otherwise.

fegetexceptflag()

  1. int fegetexceptflag ([fexcept_t]($api-api-SmartVision-Devices-MATH.md#ga3eec78fdb9921de3f7254105f546c624) * flagp, int excepts )

Description:

Stores the floating-point exceptions specified by excepts into the flagp variable address.

Parameters:

Name

Description

flagpIndicates the pointer to the floating-point exceptions.
exceptsIndicates the current floating-point exceptions to store.

Returns:

Returns 0 if the operation is successful; returns a non-zero value otherwise.

fegetround()

  1. int fegetround (void)

Description:

Obtains the macro corresponding to the current rounding mode.

The rounding mode can be FE_TONEAREST, FE_UPWARD, FE_DOWNWARD, or FE_TOWARDZERO.

Returns:

Returns the macro corresponding to the current rounding mode.

feholdexcept()

  1. int feholdexcept ([fenv_t]($api-api-SmartVision-Devices-fenv_t.md)* envp)

Description:

Stores the current floating-point environment into the object specified by envp, with all status flags cleared.

Parameters:

Name

Description

envpIndicates the pointer to the floating-point environment.

Attention:

This function clears all exception status flags and sets the environment to the non-stop mode (to continue the execution of the exceptions), if any.

Returns:

Returns 0 if the operation is successful; returns a non-zero value otherwise.

feraiseexcept()

  1. int feraiseexcept (int excepts)

Description:

Obtains the floating-point exceptions specified by excepts.

Parameters:

Name

Description

exceptsIndicates the floating-point exceptions to obtain.

Returns:

Returns 0 if the operation is successful; returns a non-zero value otherwise.

fesetenv()

  1. int fesetenv (const[fenv_t]($api-api-SmartVision-Devices-fenv_t.md)* envp)

Description:

Sets the current floating-point environment.

This function restores the floating-point environment from the object specified by envp. The floating-point environment contains the current control modes and status flags of floating-point operations.

Parameters:

Name

Description

envpIndicates the pointer to the floating-point environment.

Attention:

The object specified by envp must be valid.

Returns:

Returns 0 if the operation is successful; returns a non-zero value otherwise.

fesetexceptflag()

  1. int fesetexceptflag (const[fexcept_t]($api-api-SmartVision-Devices-MATH.md#ga3eec78fdb9921de3f7254105f546c624) * flagp, int excepts )

Description:

Sets the exception status flag by copying the floating-point exceptions stored in the flagp address to the excepts parameter.

Parameters:

Name

Description

flagpIndicates the pointer to the floating-point exceptions.
exceptsIndicates the current floating-point exceptions to store.

Attention:

Before using this function, ensure that you have successfully called fegetexceptflag.

Returns:

Returns 0 if the operation is successful; returns a non-zero value otherwise.

fesetround()

  1. int fesetround (int rounding_mode)

Description:

Sets the rounding mode.

The rounding mode can be FE_TONEAREST, FE_UPWARD, FE_DOWNWARD, or FE_TOWARDZERO.

Parameters:

Name

Description

rounding_modeIndicates the rounding mode to set.

Returns:

Returns 0 if the operation is successful; returns a non-zero value otherwise.

fetestexcept()

  1. int fetestexcept (int excepts)

Description:

Checks whether the floating-point exceptions specified by excepts have been raised.

For example, if the value of excepts is FE_OVERFLOW | FE_INVALID, this function checks whether the current floating-point operation has thrown an overflow exception or is invalid.

Parameters:

Name

Description

exceptsIndicates the floating-point exceptions.

Returns:

Returns the macros describing the specified exceptions if they have been raised; returns 0 if the specified exceptions do not exist.

feupdateenv()

  1. int feupdateenv (const[fenv_t]($api-api-SmartVision-Devices-fenv_t.md)* envp)

Description:

Updates the current floating-point environment from the object specified by envp.

Parameters:

Name

Description

envpIndicates the pointer to the floating-point environment.

Attention:

The object specified by envp must be valid.

Returns:

Returns 0 if the operation is successful; returns a non-zero value otherwise.

finite()

  1. int finite (double x)

Description:

Checks whether the double value x is an infinity or a NaN value.

Parameters:

Name

Description

xIndicates the double value to check.

Returns:

Returns 0 if x is an infinity or a NaN value; returns 1 otherwise.

finitef()

  1. int finitef (float x)

Description:

Checks whether the float value x is an infinity or a NaN value.

Parameters:

Name

Description

xIndicates the float value to check.

Returns:

Returns 0 if x is an infinity or a NaN value; returns 1 otherwise.

floor()

  1. double floor (double x)

Description:

Obtains the largest integer less than or equal to the double value x.

Parameters:

Name

Description

xIndicates the double value x to compare with.

Returns:

Returns the largest integer less than or equal to x.

floorf()

  1. float floorf (float x)

Description:

Obtains the largest integer less than or equal to the float value x.

Parameters:

Name

Description

xIndicates the float value x to compare with.

Returns:

Returns the largest integer less than or equal to x.

floorl()

  1. longdouble floorl (longdouble x)

Description:

Obtains the largest integer less than or equal to the long double value x.

Parameters:

Name

Description

xIndicates the long double value x to compare with.

Returns:

Returns the largest integer less than or equal to x.

fma()

  1. double fma (double x,double y,double z )

Description:

Calculates the value of x*y+z and rounds the result up.

Parameters:

Name

Description

xIndicates the double value x.
yIndicates the double value y.
zIndicates the double value z.

Attention:

The rounding mode is the same as that set in the system.

Returns:

Returns the calculation result.

fmaf()

  1. float fmaf (float x,float y,float z )

Description:

Calculates the value of x*y+z and rounds the result up.

Parameters:

Name

Description

xIndicates the float value x.
yIndicates the float value y.
zIndicates the float value z.

Attention:

The rounding mode is the same as that set in the system.

Returns:

Returns the calculation result.

fmal()

  1. longdouble fmal (longdouble x,longdouble y,longdouble z )

Description:

Calculates the value of x*y+z and rounds the result up.

Parameters:

Name

Description

xIndicates the long double value x.
yIndicates the long double value y.
zIndicates the long double value z.

Attention:

The rounding mode is the same as that set in the system.

Returns:

Returns the calculation result.

fmax()

  1. double fmax (double x,double y )

Description:

Obtains the larger value of two double values x and y.

Parameters:

Name

Description

xIndicates the double value x.
yIndicates the double value y.

Returns:

Returns the larger value.

fmaxf()

  1. float fmaxf (float x,float y )

Description:

Obtains the larger value of two float values x and y.

Parameters:

Name

Description

xIndicates the float value x.
yIndicates the float value y.

Returns:

Returns the larger value.

fmaxl()

  1. longdouble fmaxl (longdouble x,longdouble y )

Description:

Obtains the larger value of two long double values x and y.

Parameters:

Name

Description

xIndicates the long double value x.
yIndicates the long double value y.

Returns:

Returns the larger value.

fmin()

  1. double fmin (double x,double y )

Description:

Obtains the smaller value of two double values x and y.

Parameters:

Name

Description

xIndicates the double value x.
yIndicates the double value y.

Returns:

Returns the smaller value.

fminf()

  1. float fminf (float x,float y )

Description:

Obtains the smaller value of two float values x and y.

Parameters:

Name

Description

xIndicates the float value x.
yIndicates the float value y.

Returns:

Returns the smaller value.

fminl()

  1. longdouble fminl (longdouble x,longdouble y )

Description:

Obtains the smaller value of two long double values x and y.

Parameters:

Name

Description

xIndicates the long double value x.
yIndicates the long double value y.

Returns:

Returns the smaller value.

fmod()

  1. double fmod (double x,double y )

Description:

Calculates the remainder of the double value x divided by the double value y.

Parameters:

Name

Description

xIndicates the double value x, which is used as the numerator.
yIndicates the double value y, which is used as the denominator.

Returns:

Returns the remainder.

fmodf()

  1. float fmodf (float x,float y )

Description:

Calculates the remainder of the float value x divided by the float value y.

Parameters:

Name

Description

xIndicates the float value x, which is used as the numerator.
yIndicates the float value y, which is used as the denominator.

Returns:

Returns the remainder.

fmodl()

  1. longdouble fmodl (longdouble x,longdouble y )

Description:

Calculates the remainder of the long double value x divided by the long double value y.

Parameters:

Name

Description

xIndicates the long double value x, which is used as the numerator.
yIndicates the long double value y, which is used as the denominator.

Returns:

Returns the remainder.

frexp()

  1. double frexp (double x,int* exp )

Description:

Decomposes the double value x into a significand and an integral exponent for 2.

The absolute value of the significand ranges from 0.5 (included) to 1 (excluded). x = significand * 2^exponent

Parameters:

Name

Description

xIndicates the double value x to decompose.
expIndicates the pointer to the exponent.

Returns:

Returns the binary significand of x if the operation is successful; returns 0 if x is 0 (exp is also 0); returns a NaN value if x is a NaN value (exp is not specified); returns a positive or negative infinity if x is a positive or negative infinity, respectively (exp is not specified).

frexpf()

  1. float frexpf (float x,int* exp )

Description:

Decomposes float value x into a binary significand and an integral exponent for 2.

The absolute value of the significand ranges from 0.5 (included) to 1 (excluded). x = significand * 2^exponent

Parameters:

Name

Description

xIndicates the float value to decompose.
expIndicates the pointer to an integer where the exponent is stored.

Returns:

Returns the binary significand of x if the operation is successful; returns 0 if x is 0 (exp is also 0); returns a NaN value if x is a NaN value (exp is not specified); returns a positive or negative infinity if x is a positive or negative infinity (exp is not specified).

frexpl()

  1. longdouble frexpl (longdouble x,int* exp )

Description:

Decomposes long double value x into a binary significand and an integral exponent for 2.

The absolute value of the significand ranges from 0.5 (included) to 1 (excluded). x = significand * 2^exponent

Parameters:

Name

Description

xIndicates the long double value to decompose.
expIndicates the pointer to an integer where the exponent is stored.

Returns:

Returns the binary significand of x if the operation is successful; returns 0 if x is 0 (exp is also 0); returns a NaN value if x is a NaN value (exp is not specified); returns a positive or negative infinity if x is a positive or negative infinity (exp is not specified).

hypot()

  1. double hypot (double x,double y )

Description:

Calculates the hypotenuse of a right triangle whose legs are x and y.

Parameters:

Name

Description

xIndicates the length of one side of the right triangle, represented using a double value.
yIndicates the length of the other side of the right triangle, represented using a double value.

Returns:

Returns the hypotenuse of the right triangle.

hypotf()

  1. float hypotf (float x,float y )

Description:

Calculates the hypotenuse of a right triangle whose legs are x and y.

Parameters:

Name

Description

xIndicates the length of one side of the right triangle, represented using a float value.
yIndicates the length of the other side of the right triangle, represented using a float value.

Returns:

Returns the hypotenuse of the right triangle.

hypotl()

  1. longdouble hypotl (longdouble x,longdouble y )

Description:

Calculates the hypotenuse of a right triangle whose legs are x and y.

Parameters:

Name

Description

xIndicates the length of one side of the right triangle, represented using a long double value.
yIndicates the length of the other side of the right triangle, represented using a long double value.

Returns:

Returns the hypotenuse of the right triangle.

ilogb()

  1. int ilogb (double x)

Description:

Obtains the integral part of the logarithm of double value x.

FLT_RADIX is used as the base for the logarithm.

Parameters:

Name

Description

xIndicates the double value.

Returns:

Returns the integral part of the logarithm of x if the operation is successful. If x is 0, this function returns FP_ILOGB0 and reports a domain error. If x is a NaN value, this function returns FP_ILOGBNAN and reports a domain error. If x is positive or negative infinity, this function returns INT_MAX and reports a domain error.

ilogbf()

  1. int ilogbf (float x)

Description:

Obtains the integral part of the logarithm of float value x.

FLT_RADIX is used as the base for the logarithm.

Parameters:

Name

Description

xIndicates the float value.

Returns:

Returns the integral part of the logarithm of x if the operation is successful. If x is 0, this function returns FP_ILOGB0 and reports a domain error. If x is a NaN value, this function returns FP_ILOGBNAN and reports a domain error. If x is positive or negative infinity, this function returns INT_MAX and reports a domain error.

ilogbl()

  1. int ilogbl (longdouble x)

Description:

Obtains the integral part of the logarithm of the long double value x.

FLT_RADIX is used as the base for the logarithm.

Parameters:

Name

Description

xIndicates the long double value.

Returns:

Returns the integral part of the logarithm of x if the operation is successful. If x is 0, this function returns FP_ILOGB0 and reports a domain error. If x is a NaN value, this function returns FP_ILOGBNAN and reports a domain error. If x is positive or negative infinity, this function returns INT_MAX and reports a domain error.

j0()

  1. double j0 (double x)

Description:

Calculates the Bessel function of the first kind of order 0 for the double value x.

Parameters:

Name

Description

xIndicates the double value.

Returns:

Returns the Bessel function of the first kind of order 0 for x if the operation is successful; returns a NaN value if x is a NaN value; returns 0 and sets errno to ERANGE if x is too large or an overflow range error occurs.

j0f()

  1. float j0f (float x)

Description:

Calculates the Bessel function of the first kind of order 0 for the float value x.

Parameters:

Name

Description

xIndicates the float value.

Returns:

Returns the calculation result if the operation is successful; returns a NaN value if x is a NaN value; returns 0 and sets errno to ERANGE if x is too large or an overflow range error occurs.

j1()

  1. double j1 (double x)

Description:

Calculates the Bessel function of the first kind of order 1 for the double value x.

Parameters:

Name

Description

xIndicates the double value.

Returns:

Returns the Bessel function of the first kind of order 1 for x if the operation is successful; returns a NaN value if x is a NaN value; returns 0 and sets errno to ERANGE if x is too large or an overflow range error occurs.

j1f()

  1. float j1f (float x)

Description:

Calculates the Bessel function of the first kind of order 1 for the float value x.

Parameters:

Name

Description

xIndicates the float value.

Returns:

Returns the calculation result if the operation is successful; returns a NaN value if x is a NaN value; returns 0 and sets errno to ERANGE if x is too large or an overflow range error occurs.

jn()

  1. double jn (int n,double x )

Description:

Calculates the Bessel function of the first kind of order n for the double value x.

Parameters:

Name

Description

nIndicates the order of the Bessel function of the first kind.
xIndicates the double value.

Returns:

Returns the Bessel function of the first kind of order n for x if the operation is successful; returns a NaN value if x is a NaN value; returns 0 and sets errno to ERANGE if x is too large or an overflow range error occurs.

jnf()

  1. float jnf (int n,float x )

Description:

Calculates the Bessel function of the first kind of order n for the float value x.

Parameters:

Name

Description

nIndicates the order of the Bessel function of the first kind.
xIndicates the float value.

Returns:

Returns the calculation result if the operation is successful; returns a NaN value if x is a NaN value; returns 0 and sets errno to ERANGE if x is too large or an overflow range error occurs.

ldexp()

  1. double ldexp (double x,int exp )

Description:

Multiplies the double value x by 2 raised to the power of exp.

The calculation formula is x*2^exp.

Parameters:

Name

Description

xIndicates the double value.
expIndicates the exponent.

Returns:

Returns the calculation result.

ldexpf()

  1. float ldexpf (float x,int exp )

Description:

Multiplies the float value x by 2 raised to the power of exp.

The calculation formula is x*2^exp.

Parameters:

Name

Description

xIndicates the float value.
expIndicates the exponent.

Returns:

Returns the calculation result.

ldexpl()

  1. longdouble ldexpl (longdouble x,int exp )

Description:

Multiplies the long double value x by 2 raised to the power of exp.

The calculation formula is x*2^exp.

Parameters:

Name

Description

xIndicates the long double value.
expIndicates the exponent.

Returns:

Returns the calculation result.

lgamma()

  1. double lgamma (double x)

Description:

Calculates the natural logarithm of the absolute value of the gamma function of the double value x.

Parameters:

Name

Description

xIndicates the double value.

Returns:

Returns the calculation result if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is 1 or 2, this function returns +0. If x is a positive or negative infinity, this function returns a positive infinity. If x is 0 or a negative value, this function returns one of +HUGE_VAL, reports a pole error, and sets errno to ERANGE). If an overflow range error occurs, this function returns one of HUGE_VAL * and sets errno to ERANGE.

lgammaf()

  1. float lgammaf (float x)

Description:

Calculates the natural logarithm of the absolute value of the gamma function of the float value x.

Parameters:

Name

Description

xIndicates the float value.

Returns:

Returns the calculation result if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is 1 or 2, this function returns +0. If x is a positive or negative infinity, this function returns a positive infinity. If x is 0 or a negative value, this function returns one of +HUGE_VALF, reports a pole error, and sets errno to ERANGE. If an overflow range error occurs, this function returns one of HUGE_VALF and sets errno to ERANGE.

lgammal()

  1. longdouble lgammal (longdouble x)

Description:

Calculates the natural logarithm of the absolute value of the gamma function of the long double value x.

Parameters:

Name

Description

xIndicates the long double value.

Returns:

Returns the calculation result if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is 1 or 2, this function returns +0. If x is a positive or negative infinity, this function returns a positive infinity. If x is 0 or a negative value, this function returns one of +HUGE_VALL, reports a pole error, and sets errno to ERANGE. If an overflow range error occurs, this function returns one of HUGE_VALL and sets errno to ERANGE.

lgammal_r()

  1. longdouble lgammal_r (longdouble x,int* signp )

Description:

Calculates the natural logarithm of the absolute value of the gamma function of the double value x.

Parameters:

Name

Description

xIndicates the double value.
signpreturn value of sign.

Returns:

Returns the calculation result if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is 1 or 2, this function returns +0. If x is a positive or negative infinity, this function returns a positive infinity. If x is 0 or a negative value, this function returns one of +HUGE_VAL, reports a pole error, and sets errno to ERANGE). If an overflow range error occurs, this function returns one of HUGE_VAL * and sets errno to ERANGE.

llrint()

  1. longlongint llrint (double x)

Description:

Rounds double value x to the nearest integer.

Parameters:

Name

Description

xIndicates the double value to round.

Attention:

The type of x, rounding mode, and rounding direction are specified by fegetround.

Returns:

Returns the nearest integer if the operation is successful; returns an unspecified value if x is a NaN value or an infinity, or the rounded value is outside the specified range, in which case a domain error or overflow range error occurs.

llrintf()

  1. longlongint llrintf (float x)

Description:

Rounds float value x to the nearest integer.

Parameters:

Name

Description

xIndicates the float value.

Attention:

The type of x, rounding mode, and rounding direction are specified by fegetround.

Returns:

Returns the nearest integer if the operation is successful; returns an unspecified value if x is a NaN value or an infinity, or the rounded value is outside the specified range, in which case a domain error or overflow range error occurs.

llrintl()

  1. longlongint llrintl (longdouble x)

Description:

Rounds long double value x to the nearest integer.

Parameters:

Name

Description

xIndicates the long double value.

Attention:

The type of x, rounding mode, and rounding direction are specified by fegetround.

Returns:

Returns the nearest integer if the operation is successful; returns an unspecified value if x is a NaN value or an infinity, or the rounded value is outside the specified range, in which case a domain error or overflow range error occurs.

llround()

  1. longlongint llround (double x)

Description:

Rounds double value x to the nearest integer, rounding away from 0.

Parameters:

Name

Description

xIndicates the double value.

Attention:

Halfway values are rounded away from 0.

Returns:

Returns the nearest integer if the operation is successful; returns an unspecified value if x is a NaN value or an infinity, or the rounded value is outside the specified range, in which case a domain error or overflow range error occurs.

llroundf()

  1. longlongint llroundf (float x)

Description:

Rounds float value x to the nearest integer, rounding away from 0.

Parameters:

Name

Description

xIndicates the float value.

Attention:

Halfway values are rounded away from 0.

Returns:

Returns the nearest integer if the operation is successful; returns an unspecified value if x is a NaN value or an infinity, or the rounded value is outside the specified range, in which case a domain error or overflow range error occurs.

llroundl()

  1. longlongint llroundl (longdouble x)

Description:

Rounds long double value x to the nearest integer, rounding away from 0.

Parameters:

Name

Description

xIndicates the long double value.

Attention:

Halfway values are rounded away from 0.

Returns:

Returns the nearest integer if the operation is successful; returns an unspecified value if x is a NaN value or an infinity, or the rounded value is outside the specified range, in which case a domain error or overflow range error occurs.

log()

  1. double log (double x)

Description:

Calculates the natural logarithm of the double value x.

Parameters:

Name

Description

xIndicates the double value.

Returns:

Returns the natural logarithm of x if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is a positive infinity, this function returns a positive infinity. If x is 0, this function returns -HUGE_VAL, reports a pole error, sets errno to ERANGE, and throws the FE_INVALID exception. If x is a negative value (including a negative infinity), this function returns a NaN value, reports a domain error, sets errno to EDOM, and throws the FE_DIVBYZERO exception.

log10()

  1. double log10 (double x)

Description:

Calculates the common logarithm (logarithm with base 10) of the double value x.

Parameters:

Name

Description

xIndicates the double value.

Returns:

Returns the natural logarithm of x if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is a positive infinity, this function returns a positive infinity. If x is 0, this function returns -HUGE_VAL, reports a pole error, sets errno to ERANGE, and throws the FE_INVALID exception. If x is a negative value (including a negative infinity), this function returns a NaN value, reports a domain error, sets errno to EDOM, and throws the FE_DIVBYZERO exception.

log10f()

  1. float log10f (float x)

Description:

Calculates the common logarithm (logarithm with base 10) of the float value x.

Parameters:

Name

Description

xIndicates the float value.

Returns:

Returns the natural logarithm of x if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is a positive infinity, this function returns a positive infinity. If x is 0, this function returns -HUGE_VALF, reports a pole error, sets errno to ERANGE, and throws the FE_INVALID exception. If x is a negative value (including a negative infinity), this function returns a NaN value, reports a domain error, sets errno to EDOM, and throws the FE_DIVBYZERO exception.

log10l()

  1. longdouble log10l (longdouble x)

Description:

Calculates the common logarithm (logarithm with base 10) of the long double value x.

Parameters:

Name

Description

xIndicates the long double value.

Returns:

Returns the natural logarithm of x if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is a positive infinity, this function returns a positive infinity. If x is 0, this function returns -HUGE_VALL, reports a pole error, sets errno to ERANGE, and throws the FE_INVALID exception. If x is a negative value (including a negative infinity), this function returns a NaN value, reports a domain error, sets errno to EDOM, and throws the FE_DIVBYZERO exception.

log1p()

  1. double log1p (double x)

Description:

Calculates the natural logarithm of one plus the double value x.

Parameters:

Name

Description

xIndicates the double value.

Returns:

Returns the natural logarithm of one plus x if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is a positive infinity, this function returns a positive infinity. If x is -1, this function returns -HUGE_VAL, reports a pole error, sets errno to ERANGE, and throws the FE_INVALID exception. If x is less than -1 (including a negative infinity), this function returns a NaN value, reports a domain error, sets errno to EDOM, and throws the FE_DIVBYZERO exception.

log1pf()

  1. float log1pf (float x)

Description:

Calculates the natural logarithm of one plus the float value x.

Parameters:

Name

Description

xIndicates the float value.

Returns:

Returns the natural logarithm of one plus x if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is a positive infinity, this function returns a positive infinity. If x is -1, this function returns -HUGE_VALF, reports a pole error, sets errno to ERANGE, and throws the FE_INVALID exception. If x is less than -1 (including a negative infinity), this function returns a NaN value, reports a domain error, sets errno to EDOM, and throws the FE_DIVBYZERO exception.

log1pl()

  1. longdouble log1pl (longdouble x)

Description:

Calculates the natural logarithm of one plus the long double value x.

Parameters:

Name

Description

xIndicates the long double value.

Returns:

Returns the natural logarithm of one plus x if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is a positive infinity, this function returns a positive infinity. If x is -1, this function returns -HUGE_VALL, reports a pole error, sets errno to ERANGE, and throws the FE_INVALID exception. If x is less than -1 (including a negative infinity), this function returns a NaN value, reports a domain error, sets errno to EDOM, and throws the FE_DIVBYZERO exception.

log2()

  1. double log2 (double x)

Description:

Calculates the binary logarithm (logarithm with base 2) of the double value x.

Parameters:

Name

Description

xIndicates the double value.

Returns:

Returns the binary logarithm of x if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is a positive infinity, this function returns a positive infinity. If x is 0, this function returns -HUGE_VAL, reports a pole error, sets errno to ERANGE, and throws the FE_INVALID exception. If x is a negative value (including a negative infinity), this function returns a NaN value, reports a domain error, sets errno to EDOM, and throws the FE_DIVBYZERO exception.

log2f()

  1. float log2f (float x)

Description:

Calculates the binary logarithm (logarithm with base 2) of the float value x.

Parameters:

Name

Description

xIndicates the float value.

Returns:

Returns the binary logarithm of x if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is a positive infinity, this function returns a positive infinity. If x is 0, this function returns -HUGE_VALF, reports a pole error, sets errno to ERANGE, and throws the FE_INVALID exception. If x is a negative value (including a negative infinity), this function returns a NaN value, reports a domain error, sets errno to EDOM, and throws the FE_DIVBYZERO exception.

log2l()

  1. longdouble log2l (longdouble x)

Description:

Calculates the binary logarithm (logarithm with base 2) of the long double value x.

Parameters:

Name

Description

xIndicates the long double value.

Returns:

Returns the binary (base-2) logarithm of x if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is a positive infinity, this function returns a positive infinity. If x is 0, this function returns -HUGE_VALL, reports a pole error, sets errno to ERANGE, and throws the FE_INVALID exception. If x is a negative value (including a negative infinity), this function returns a NaN value, reports a domain error, sets errno to EDOM, and throws the FE_DIVBYZERO exception.

logb()

  1. double logb (double x)

Description:

Calculates the logarithm of the absolute value of the double value x.

FLT_RADIX is used as the base for the logarithm.

Parameters:

Name

Description

xIndicates the double value.

Attention:

Set FLT_RADIX to 2 in the float.h file.

Returns:

Returns the logarithm of the absolute value of x if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is a positive or negative infinity, this function returns a positive or negative infinity. If x is 0, this function returns -HUGE_VAL, reports a pole error, and throws the FE_DIVBYZERO exception.

logbf()

  1. float logbf (float x)

Description:

Calculates the logarithm of the absolute value of the float value x.

FLT_RADIX is used as the base for the logarithm.

Parameters:

Name

Description

xIndicates the float value.

Attention:

Set FLT_RADIX to 2 in the float.h file.

Returns:

Returns the logarithm of the absolute value of x if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is a positive or negative infinity, this function returns a positive or negative infinity. If x is 0, this function returns -HUGE_VALF, reports a pole error, and throws the FE_DIVBYZERO exception.

logbl()

  1. longdouble logbl (longdouble x)

Description:

Calculates the logarithm of the absolute value of the long double value x.

FLT_RADIX is used as the base for the logarithm.

Parameters:

Name

Description

xIndicates the long double value.

Attention:

Set FLT_RADIX to 2 in the float.h file.

Returns:

Returns the logarithm of the absolute value of x if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is a positive or negative infinity, this function returns a positive or negative infinity. If x is 0, this function returns -HUGE_VALL, reports a pole error, and throws the FE_DIVBYZERO exception.

logf()

  1. float logf (float x)

Description:

Calculates the natural logarithm of the float value x.

Parameters:

Name

Description

xIndicates the float value.

Returns:

Returns the natural logarithm of x if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is a positive infinity, this function returns a positive infinity. If x is 0, this function returns -HUGE_VALF, reports a pole error, sets errno to ERANGE, and throws the FE_INVALID exception. If x is a negative value (including a negative infinity), this function returns a NaN value, reports a domain error, sets errno to EDOM, and throws the FE_DIVBYZERO exception.

logl()

  1. longdouble logl (longdouble x)

Description:

Calculates the natural logarithm of the long double value x.

Parameters:

Name

Description

xIndicates the long double value.

Returns:

Returns the natural logarithm of x if the operation is successful. If x is a NaN value, this function returns a NaN value. If x is a positive infinity, this function returns a positive infinity. If x is 0, this function returns -HUGE_VALL, reports a pole error, sets errno to ERANGE, and throws the FE_INVALID exception. If x is a negative value (including a negative infinity), this function returns a NaN value, reports a domain error, sets errno to EDOM, and throws the FE_DIVBYZERO exception.

lrint()

  1. longint lrint (double x)

Description:

Rounds the double value x to the nearest integer.

Parameters:

Name

Description

xIndicates the double value to round.

Attention:

The type of x, rounding mode, and rounding direction are specified by fegetround.

Returns:

Returns the nearest integer if the operation is successful; returns an unspecified value if x is a NaN value or an infinity, or the rounded value is outside the specified range, in which case a domain error or overflow range error occurs.

lrintf()

  1. longint lrintf (float x)

Description:

Rounds the float value x to the nearest integer.

Parameters:

Name

Description

xIndicates the float value to round.

Attention:

The type of x, rounding mode, and rounding direction are specified by fegetround.

Returns:

Returns the nearest integer if the operation is successful; returns an unspecified value if x is a NaN value or an infinity, or the rounded value is outside the specified range, in which case a domain error or overflow range error occurs.

lrintl()

  1. longint lrintl (longdouble x)

Description:

Rounds the long double value x to the nearest integer.

Parameters:

Name

Description

xIndicates the long double value.

Attention:

The type of x, rounding mode, and rounding direction are specified by fegetround.

Returns:

Returns the nearest integer if the operation is successful; returns an unspecified value if x is a NaN value or an infinity, or the rounded value is outside the specified range, in which case a domain error or overflow range error occurs.

lround()

  1. longint lround (double x)

Description:

Rounds double value x to the nearest integer, rounding away from 0.

Parameters: