fegetenv1.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
fegetenv1 | Microsoft Docs		11/04/2016			cpp devlang-cpp		article	fetegenv	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-runtime-l1-1-0.dll	DLLExport	fegetenv fenv/fegetenv	C++	fetegenv function	68962421-6978-4b27-8e4c-ad1577830cf6	7	corob-msft	corob	ghogen

fegetenv

Stores the current floating-point environment in the specified object.

Syntax

int fegetenv(  
   fenv_t *penv  
);  
  

Parameters

penv
Pointer to an fenv_t object to contain the current floating-point environment values.

Return Value

Returns 0 if the floating-point environment was successfully stored in penv. Otherwise, returns a non-zero value.

Remarks

The fegetenv function stores the current floating-point environment in the object pointed to by penv. The floating point environment is the set of status flags and control modes that affect floating-point calculations. This includes the rounding direction mode and the status flags for floating-point exceptions. If penv does not point to a valid fenv_t object, subsequent behavior is undefined.

To use this function, you must turn off floating-point optimizations that could prevent access by using the #pragma fenv_access(on) directive prior to the call. For more information, see fenv_access.

Requirements

Function	C header	C++ header
fegetenv	<fenv.h>	<cfenv>

For additional compatibility information, see Compatibility.

See Also

Alphabetical Function Reference
fesetenv