imaxdiv

Computes the quotient and the remainder of two integer values of any size as a single operation.

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_tquot, and the remainder, intmax_trem. 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.

See Also

Reference

Floating-Point Support

div

ldiv, lldiv