NAME

fmod — floating-point remainder function

SYNOPSIS

#include <math.h>

double
fmod(double x, double y);

long double
fmodl(long double x, long double y);

float
fmodf(float x, float y);

DESCRIPTION

The fmod() functions compute the floating-point remainder of x/ y.

Specifically, the functions return the value x-i*y, for some integer i such that, if y is non-zero, the result has the same sign as x and magnitude less than the magnitude of y.

SPECIAL VALUES

fmod(±0, y) returns ±0 if y is neither 0 nor NaN.

fmod(x, y) returns a NaN and raises the "invalid" floating-point exception for x infinite or y zero.

fmod(x, ±infinity) returns x for x not infinite.

VECTOR OPERATIONS

If you need to apply the fmod() functions to SIMD vectors or arrays, using the following functions provided by the Accelerate.framework may give significantly better performance:

#include <Accelerate/Accelerate.h>

vFloat vfmodf(vFloat x, vFloat y);
void vvfmodf(float *z, const float *y, const float *x, const int *n);
void vvfmod(double *z, const double *y, const double *x, const int *n);

STANDARDS

The fmod() functions conform to ISO/IEC 9899:2011.