div

 

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 div.

Computes the quotient and the remainder of two integer values.

Syntax

div_t div(   
   int numer,  
   int denom   
);  
ldiv_t div(  
   long numer,  
   long denom  
); /* C++ only */   
lldiv_t div(  
   long long numer,  
   long long denom  
); /* C++ only */  

Parameters

numer
The numerator.

denom
The denominator.

Return Value

div called by using arguments of type int returns a structure of type div_t, which comprises the quotient and the remainder. The return value of the overload with arguments of type long is ldiv_t. Both div_t and ldiv_t are defined in STDLIB.H.

Remarks

The div function divides numer by denom and thereby computes the quotient and the remainder. The div_t structure contains the quotient, int``quot, and the remainder, int``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.

The overloads that take arguments of type long or long long are only available to C++ code. The return type ldiv_t contains the members long``quot and long``rem, and the return type lldiv_t contains the members long long quot and long long rem, which have the same meanings as the members of div_t.

Requirements

Routine Required header
div <stdlib.h>

For additional compatibility information, see Compatibility.

Example

// crt_div.c  
// arguments: 876 13  
  
// This example takes two integers as command-line  
// arguments and displays the results of the integer  
// division. This program accepts two arguments on the  
// command line following the program name, then calls  
// div to divide the first argument by the second.  
// Finally, it prints the structure members quot and rem.  
//  
  
#include <stdlib.h>  
#include <stdio.h>  
#include <math.h>  
  
int main( int argc, char *argv[] )  
{  
   int x,y;  
   div_t div_result;  
  
   x = atoi( argv[1] );  
   y = atoi( argv[2] );  
  
   printf( "x is %d, y is %d\n", x, y );  
   div_result = div( x, y );  
   printf( "The quotient is %d, and the remainder is %d\n",  
           div_result.quot, div_result.rem );  
}  
x is 876, y is 13  
The quotient is 67, and the remainder is 5  

.NET Framework Equivalent

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

See Also

Floating-Point Support
ldiv, lldiv
imaxdiv