remquof(3m) - osol9

1remquo(3M)              Mathematical Library Functions              remquo(3M)
2
3
4

NAME

6       remquo, remquof, remquol - remainder functions
7

SYNOPSIS

9       c99 [ flag... ] file... -lm [ library... ]
10       #include <math.h>
11
12       double remquo(double x, double y, int *quo);
13
14
15       float remquof(float x, float y, int *quo);
16
17
18       long double remquol(long double x, long double y, int *quo);
19
20

DESCRIPTION

22       The  remquo(),  remquof(),  and  remquol()  functions  compute the same
23       remainder as the remainder(), remainderf(), and remainderl() functions,
24       respectively.  See remainder(3M). In the object pointed to by quo, they
25       store a value whose sign is the sign of x/y and whose magnitude is con‐
26       gruent  modulo  2^n  to  the magnitude of the integral quotient of x/y,
27       where n is an integer greater than or equal to 3.
28

RETURN VALUES

30       These functions return x REM y.
31
32
33       If x or y is NaN, a NaN is returned.
34
35
36       If x is ±Inf or y is 0 and the other  argument  is  non-NaN,  a  domain
37       error occurs and a NaN is returned.
38

ERRORS

40       These functions will fail if:
41
42       Domain Error    The  x  argument  is Inf or the y argument is 0 and the
43                       other argument is non-NaN.
44
45                       If   the   integer   expression   (math_errhandling   &
46                       MATH_ERREXCEPT) is non-zero, then the invalid floating-
47                       point exception is raised.
48
49

USAGE

51       An application wanting to check for exceptions should  call  feclearex‐
52       cept(FE_ALL_EXCEPT)  before  calling  these  functions.  On  return, if
53       fetestexcept(FE_INVALID | FE_DIVBYZERO | FE_OVERFLOW | FE_UNDERFLOW) is
54       non-zero,  an  exception  has been raised. An application should either
55       examine the return value or check the floating point exception flags to
56       detect exceptions.
57

ATTRIBUTES

59       See attributes(5) for descriptions of the following attributes:
60
61
62
63
64       ┌─────────────────────────────┬─────────────────────────────┐
65       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
66       ├─────────────────────────────┼─────────────────────────────┤
67       │Interface Stability          │Standard                     │
68       ├─────────────────────────────┼─────────────────────────────┤
69       │MT-Level                     │MT-Safe                      │
70       └─────────────────────────────┴─────────────────────────────┘
71