_hypot, hypotf
Important This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here. ArchiveDisclaimer

_hypot, hypotf

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.

See _doserrno, errno, _sys_errlist, and _sys_nerr for more information on this, and other, return codes.

Remarks

The _hypot function calculates the length of the hypotenuse of a right triangle, given the length of the two sides x and y. A call to _hypot is equivalent to the square root of x2 + y2.

Requirements

Routine Required header Compatibility
_hypot <math.h> Win 98, Win Me, Win NT, Win 2000, Win XP
hypotf <math.h> ANSI, Win 98, Win Me, Win NT, Win 2000, Win XP

For additional compatibility information, see Compatibility in the Introduction.

Libraries

All versions of the C run-time libraries.

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 ) );
}

Output

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

See Also

Floating-Point Support Routines | _cabs | _matherr | Run-Time Routines and .NET Framework Equivalents

Show:
© 2016 Microsoft