_hypot, hypotf

Artikel
07/22/2011

Calculates the hypotenuse.

double _hypot( 
   double x,
   double y 
);
float _hypotf( 
   float x,
   float y 
);

Parameters

x, y
Floating-point values.

Return Value

_hypot returns the length of the hypotenuse if successful or INF (infinity) on overflow. The errno variable is set to ERANGE on overflow. You can modify error handling with _matherr.

For more information about this and other return codes, see _doserrno, errno, _sys_errlist, and _sys_nerr.

Platforms

_hypotf is only available on Itanium Processor Family (IPF) platforms. _hypot is available on all platforms.

Remarks

The _hypot function calculates the length of the hypotenuse of a right triangle, given the length of the two sides x and y (in other words, the square root of x2 + y2).

Requirements

Routine	Required header
_hypot	<math.h>
hypotf	<math.h>

For more compatibility information, see Compatibility in the Introduction.

Example

// crt_hypot.c
// This program prints the hypotenuse of a right triangle.

#include <math.h>
#include <stdio.h>

int main( void )
{
   double x = 3.0, y = 4.0;

   printf( "If a right triangle has sides %2.1f and %2.1f, "
           "its hypotenuse is %2.1f\n", x, y, _hypot( x, y ) );
}

If a right triangle has sides 3.0 and 4.0, its hypotenuse is 5.0

.NET Framework Equivalent

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