imaxdiv

Article
06/05/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.

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.

Share via