HP-UX Reference (11i v1 00/12) - 3 Library Functions A-M (vol 6)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

271

272

273

274

275

276

277

278

279

280

__________________________________________________________________________________________________________________________________________________________________________________________________

STANDARD Printed by: Nora Chuang [nchuang] STANDARD

/build/1111/BRICK/man3/!!!intro.3c

________________________________________________________________

___ ___

fesetenv(3M) fesetenv(3M)

NAME

fesetenv() - set ﬂoating-point environment

SYNOPSIS

#include <fenv.h>

void fesetenv(const fenv_t *envp);

DESCRIPTION

The fesetenv() function establishesthe ﬂoating-point environment represented by the object pointed to

by envp. The argument envp must point to an object set by a call to fegetenv() or feholdex-

cept()

, or equal the macro FE_DFL_ENV.

Note that fesetenv() merely installs the state of the exception ﬂags represented through its argument,

and does not raise these exceptions.

The ISO/ANSI C committee has approved the fesetenv() function for inclusion in the C9X draft stan-

dard.

To use this function, compile either with the default

-Ae option or with the -Aa and -D_HPUX_SOURCE

options. Make sure your program includes <fenv.h

>. Link in the math library by specifying -lm on the

compiler or linker command line.

For more information, see the HP-UX Floating-Point Guide.

RETURN VALUE

None.

ERRORS

No errors are deﬁned.

EXAMPLES

Store the current ﬂoating-point environment, continue on exceptions, then restore the previous environ-

ment without raising the accumulated exceptions.

#include <fenv.h>

/*...*/

fenv_t holdenv;

feholdexcept(&holdenv);

/* perform operations */

fesetenv(&holdenv);

Restore the default environment:

#include <fenv.h>

/*...*/

fesetenv(FE_DFL_ENV);