Name
div, ldiv, lldiv, imaxdiv — compute quotient and
remainder of an integer division
Synopsis
#include <stdlib.h>
div_t
div( |
int |
numerator, |
|
int |
denominator) ; |
ldiv_t ldiv( |
long |
numerator, |
|
long |
denominator) ; |
lldiv_t lldiv( |
long long |
numerator, |
|
long long |
denominator) ; |
#include <inttypes.h>
imaxdiv_t imaxdiv( |
intmax_t |
numerator, |
|
intmax_t |
denominator) ; |
DESCRIPTION
The div
() function computes
the value numerator
/denominator
and returns the
quotient and remainder in a structure named div_t
that contains two
integer members (in unspecified order) named quot
and rem
. The quotient is rounded
towards zero. The result satisfies quot
*denominator
+rem
= numerator
.
The ldiv
()and lldiv
() and imaxdiv
() functions do the same, dividing
numbers of the indicated type and returning the result in a
structure of the indicated name, in all cases with fields
quot
and rem
of the same type as the
function arguments.
RETURN VALUE
The div_t
(etc.)
structure.
EXAMPLE
After
the values q.quot
and q.rem
are −1 and
−2, respectively.
CONFORMING TO
SVr4, 4.3BSD, C89. The functions lldiv
() and imaxdiv
() were added in C99.
SEE ALSO
abs(3), remainder(3)
Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
preserved on all copies.
Permission is granted to copy and distribute modified versions of this
manual under the conditions for verbatim copying, provided that the
entire resulting derived work is distributed under the terms of a
permission notice identical to this one.
Since the Linux kernel and libraries are constantly changing, this
manual page may be incorrect or out-of-date. The author(s) assume no
responsibility for errors or omissions, or for damages resulting from
the use of the information contained herein. The author(s) may not
have taken the same level of care in the production of this manual,
which is licensed free of charge, as they might when working
professionally.
Formatted or processed versions of this manual, if unaccompanied by
the source, must acknowledge the copyright and authors of this work.
References consulted:
Linux libc source code
Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
386BSD man pages
Modified 1993-03-29, David Metcalfe
Modified 1993-07-24, Rik Faith (faith@cs.unc.edu)
Modified 2002-08-10, 2003-11-01 Walter Harms, aeb
|