imaxdiv
The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.
The latest version of this topic can be found at imaxdiv.
Computes the quotient and the remainder of two integer values of any size as a single operation.
Syntax
imaxdiv_t imaxdiv(
intmax_t numer,
intmax_t denom
);
Parameters
numer
The numerator.
denom
The denominator.
Return Value
imaxdiv called with arguments of type intmax_t returns a structure of type imaxdiv_t that comprises the quotient and the remainder.
Remarks
The imaxdiv function divides numer by denom and thereby computes the quotient and the remainder. The imaxdiv_t structure contains the quotient, intmax_t``quot, and the remainder, intmax_t``rem. The sign of the quotient is the same as that of the mathematical quotient. Its absolute value is the largest integer that is less than the absolute value of the mathematical quotient. If the denominator is 0, the program terminates with an error message.
Requirements
| Routine | Required header |
|---|---|
imaxdiv |
<inttypes.h> |
For additional compatibility information, see Compatibility.
Example
// crt_imaxdiv.c
// Build using: cl /W3 /Tc crt_imaxdiv.c
// This example takes two integers as command-line
// arguments and calls imaxdiv to divide the first
// argument by the second, then displays the results.
#include <stdio.h>
#include <stdlib.h>
#include <inttypes.h>
int main(int argc, char *argv[])
{
intmax_t x,y;
imaxdiv_t div_result;
x = atoll(argv[1]);
y = atoll(argv[2]);
printf("The call to imaxdiv(%lld, %lld)\n", x, y);
div_result = imaxdiv(x, y);
printf("results in a quotient of %lld, and a remainder of %lld\n\n",
div_result.quot, div_result.rem);
}
When built and then called with command line parameters of 9460730470000000 8766, the code generates this output:
The call to imaxdiv
(9460730470000000, 8766)
results in a quotient of 1079252848505, and a remainder of 5170
.NET Framework Equivalent
Not applicable. To call the standard C function, use PInvoke. For more information, see Platform Invoke Examples.