fpp_set_rounding_mode()

FPP_$SET_ROUNDING_MODE            Domain/OS             FPP_$SET_ROUNDING_MODE


NAME
     fpp_$set_rounding_mode - set the rounding mode

SYNOPSIS (C)
     #include <apollo/base.h>
     #include <apollo/fpp.h>

     void fpp_$set_rounding_mode(
          fpp_$rounding_mode_t rounding_mode,
          status_$t *status)

SYNOPSIS (Pascal)
     %include '/sys/ins/base.ins.pas';
     %include '/sys/ins/fpp.ins.pas';

     procedure fpp_$set_rounding_mode(
          in rounding_mode: fpp_$rounding_mode_t;
          out status: status_$t);

SYNOPSIS (FORTRAN)
     %include '/sys/ins/base.ins.ftn'
     %include '/sys/ins/fpp.ins.ftn'

           integer*2 rounding_mode
           integer*4 status

           call fpp_$set_rounding_mode(rounding_mode, status)

DESCRIPTION
     Fpp_$set_rounding_mode sets the current IEEE-754 rounding mode of the
     floating-point unit.  If the floating-point unit does not support IEEE-
     754 rounding modes, fpp_$set_rounding_mode returns with status set to
     fpp_$unsupported_operation.

     rounding_mode
          An enumerated value specifying a rounding mode.  It can take any one
          of the following values:

          fpp_$round_to_nearest
               Set the rounding mode to round to nearest.  This is the default
               rounding mode.

          fpp_$round_to_negative
               Set the rounding mode to round to negative infinity (round
               down) mode.

          fpp_$round_to_positive
               Set the rounding mode to round to positive infinity (round up)
               mode.

          fpp_$round_to_zero
               Set the rounding mode to round toward 0 mode.

     status
          The completion status.
Museum
