We recommend using Visual Studio 2017



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.

imaxdiv_t imaxdiv(   
   intmax_t numer,  
   intmax_t denom   


The numerator.

The denominator.

imaxdiv called with arguments of type intmax_t returns a structure of type imaxdiv_t that comprises the quotient and the remainder.

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.

RoutineRequired header

For additional compatibility information, see Compatibility.

// 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  

Not applicable. To call the standard C function, use PInvoke. For more information, see Platform Invoke Examples.

Floating-Point Support
ldiv, lldiv