DIV(3C) Standard C Library Functions DIV(3C)

NAME

div, ldiv, lldiv - compute the quotient and remainder

SYNOPSIS

#include <stdlib.h>

div_t div(int numer, int denom);


ldiv_t ldiv(long int numer, long int denom);


lldiv_t lldiv(long long numer, long long denom);

DESCRIPTION

The div() function computes the quotient and remainder of the division of
the numerator numer by the denominator denom. It provides a well-defined
semantics for the signed integral division and remainder operations,
unlike the implementation-defined semantics of the built-in operations.
The sign of the resulting quotient is that of the algebraic quotient, and
if the division is inexact, the magnitude of the resulting quotient is
the largest integer less than the magnitude of the algebraic quotient. If
the result cannot be represented, the behavior is undefined; otherwise,
quotient * denom + remainder will equal numer.


The ldiv() and lldiv() functions are similar to div(), except that the
arguments and the members of the returned structure are different. The
ldiv() function returns a structure of type ldiv_t and has type long int.
The lldiv() function returns a structure of type lldiv_t and has type
long long.

RETURN VALUES

The div() function returns a structure of type div_t, comprising both the
quotient and remainder:

int quot; /*quotient*/
int rem; /*remainder*/


The ldiv() function returns a structure of type ldiv_t and lldiv()
returns a structure of type lldiv_t, comprising both the quotient and
remainder:

long int quot; /*quotient*/
long int rem; /*remainder*/

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+

SEE ALSO

attributes(7), standards(7)


July 24, 2002 DIV(3C)