cabs.md

title	ms.custom	ms.date	ms.reviewer	ms.suite	ms.technology	ms.tgt_pltfrm	ms.topic	apiname	apilocation	apitype	f1_keywords	dev_langs	helpviewer_keywords	ms.assetid	caps.latest.revision	author	ms.author	manager
_cabs | Microsoft Docs		11/04/2016			cpp-standard-libraries		article	_cabs	msvcrt.dll msvcr80.dll msvcr90.dll msvcr100.dll msvcr100_clr0400.dll msvcr110.dll msvcr110_clr0400.dll msvcr120.dll msvcr120_clr0400.dll ucrtbase.dll api-ms-win-crt-math-l1-1-0.dll	DLLExport	cabsl _cabs _cabsl	C++	cabs function cabsl function absolute values _cabsl function _cabs function calculating absolute values	fea292ee-1a39-4a0a-b416-4a189346ff26	13	corob-msft	corob	ghogen

_cabs

Calculates the absolute value of a complex number.

Syntax

double _cabs(   
   struct _complex z   
);  

Parameters

z
Complex number.

Return Value

_cabs returns the absolute value of its argument if successful. On overflow, _cabs returns HUGE_VAL and sets errno to ERANGE. You can change error handling with _matherr.

Remarks

The _cabs function calculates the absolute value of a complex number, which must be a structure of type _complex. The structure z is composed of a real component x and an imaginary component y. A call to _cabs produces a value equivalent to that of the expression sqrt( z.x * z.x + z.y * z.y ).

Requirements

Routine	Required header
_cabs	<math.h>

For more compatibility information, see Compatibility in the Introduction.

Example

// crt_cabs.c  
/* Using _cabs, this program calculates  
 * the absolute value of a complex number.  
 */  
#include <math.h>  
#include <stdio.h>  
  
int main( void )  
{  
   struct _complex number = { 3.0, 4.0 };  
   double d;  
  
   d = _cabs( number );  
   printf( "The absolute value of %f + %fi is %f\n",  
           number.x, number.y, d );  
}  

The absolute value of 3.000000 + 4.000000i is 5.000000  

See Also

Floating-Point Support
abs, labs, llabs, _abs64
fabs, fabsf, fabsl