REMAINDER - Linux手册页

时间:2019-08-20 18:00:09  来源:igfitidea点击:

Linux程序员手册 第3部分
更新日期: 2020-06-09

名称

drem,dremf,dreml,remainder,remainderf,remainderl-浮点余数函数

语法

#include <math.h>

/* The C99 versions */
double remainder(double x, double y);
float remainderf(float x, float y);
long double remainderl(long double x, long double y);

/* Obsolete synonyms */
double drem(double x, double y);
float dremf(float x, float y);
long double dreml(long double x, long double y);

Link with -lm.

glibc的功能测试宏要求(请参阅feature_test_macros(7)):

余():

_ISOC99_SOURCE || _POSIX_C_SOURCE>= 200112L || _XOPEN_SOURCE>= 500 || / *自glibc 2.19起:* / -_DEFAULT_SOURCE || / * Glibc版本
remainderf(),

remainderl():

_ISOC99_SOURCE || _POSIX_C_SOURCE>= 200112L || / *自glibc 2.19起:* / -_DEFAULT_SOURCE || / * Glibc版本
drem(),

dremf(),

dreml():

/ *自glibc 2.19以来:* / _DEFAULT_SOURCE || / * Glibc版本

说明

这些函数计算x除以y的余数。返回值是x-n * y,其中n是值x / y,四舍五入到最接近的整数。如果x-n * y的绝对值为0.5,则选择n为偶数。

这些函数不受当前舍入模式的影响(请参阅fenv(3))。

drem()函数的作用完全相同。

返回值

成功执行后,这些函数将返回浮点余数x-n * y。如果返回值为0,则其符号为x。

如果x或y是NaN,则返回NaN。

如果x是无穷大,并且y不是NaN,则会发生域错误,并返回NaN。

如果y为零,并且x不是NaN,则发生域错误,并返回NaN。

错误说明

有关如何确定调用这些函数时是否发生错误的信息,请参见math_error(7)。

可能会发生以下错误:

Domain error: xis an infinity and yis not a NaN
errno设置为EDOM(但请参阅BUGS)。引发了无效的浮点异常(FE_INVALID)。
这些功能不会在这种情况下设置errno。
Domain error: yis zeroerrno
设置为EDOM。引发了无效的浮点异常(FE_INVALID)。

属性

有关本节中使用的术语的说明,请参见attribute(7)。

InterfaceAttributeValue
drem(),dremf(),dreml(),
remainder(),remainderf(),
remainderl()
Thread safetyMT-Safe

遵循规范

在C99,POSIX.1-2001和POSIX.1-2008中指定了函数restder(),remainderf()和restderl()。

函数drem()来自4.3BSD。 float和long double变体dremf()和dreml()在某些系统上存在,例如Tru64和glibc2。避免使用这些函数来支持restder()等。

BUGS

在glibc 2.15之前,该调用

restder(nan(""),́0);

按预期返回NaN,但错误地导致了域错误。从glibc 2.15开始,将返回无提示的NaN(即无域错误)。

在glibc 2.15之前,由于x是无穷大且y不是NaN时发生的域错误,因此未将errno设置为EDOM。

示例

调用" remainder(29.0,3.0)"返回-1。

另外参见

div(3),fmod(3),remquo(3)

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本,请访问https://www.kernel.org/doc/man-pages/