Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

decimal_to_floating(3)

econvert(3)

floating_to_decimal(3)

ieee_handler(3M)

sigfpe(3)

abort(3)

strtod(3)





   floatingpoint(3)        (BSD Compatibility Package)        floatingpoint(3)


   NAME
         floatingpoint - IEEE floating point definitions

   SYNOPSIS
         cc [ flag... ] file ... -lucb

         #include <sys/ieeefp.h>
         #include <fp.h>

   DESCRIPTION
         This file defines constants, types, variables, and functions used to
         implement standard floating point according to ANSI/IEEE Std 754-
         1985.  The variables and functions are implemented in libucb.a.  The
         included file <sys/ieeefp.h> defines certain types of interest to the
         kernel.

         IEEE Rounding Modes:

         fp_direction_type   The type of the IEEE rounding direction mode.
                             Note: the order of enumeration varies according
                             to hardware.

         fp_direction        The IEEE rounding direction mode currently in
                             force.  This is a global variable that is
                             intended to reflect the hardware state, so it
                             should only be written indirectly through a
                             function that also sets the hardware state.

         fp_precision_type   The type of the IEEE rounding precision mode,
                             which only applies on systems that support
                             extended precision.

         fp_precision        The IEEE rounding precision mode currently in
                             force.  This is a global variable that is
                             intended to reflect the hardware state on systems
                             with extended precision, so it should only be
                             written indirectly.

         SIGFPE handling:

         sigfpe_code_type    The type of a SIGFPE code.

         sigfpe_handler_type The type of a user-definable SIGFPE exception
                             handler called to handle a particular SIGFPE
                             code.

         SIGFPE_DEFAULT      A macro indicating the default SIGFPE exception
                             handling, namely to perform the exception
                             handling specified by calls to ieee_handler(3M),
                             if any, and otherwise to dump core using
                             abort(3).


   7/91                                                                 Page 1









   floatingpoint(3)        (BSD Compatibility Package)        floatingpoint(3)


         SIGFPE_IGNORE       A macro indicating an alternate SIGFPE exception
                             handling, namely to ignore and continue
                             execution.

         SIGFPE_ABORT        A macro indicating an alternate SIGFPE exception
                             handling, namely to abort with a core dump.

         IEEE Exception Handling:

         N_IEEE_EXCEPTION    The number of distinct IEEE floating-point
                             exceptions.

         fp_exception_type   The type of the N_IEEE_EXCEPTION exceptions.
                             Each exception is given a bit number.

         fp_exception_field_type
                             The type intended to hold at least
                             N_IEEE_EXCEPTION bits corresponding to the IEEE
                             exceptions numbered by fp_exception_type.  Thus
                             fp_inexact corresponds to the least significant
                             bit and fp_invalid to the fifth least significant
                             bit.  Note: some operations may set more than one
                             exception.

         fp_accrued_exceptions
                             The IEEE exceptions between the time this global
                             variable was last cleared, and the last time a
                             function was called to update the variable by
                             obtaining the hardware state.

         ieee_handlers       An array of user-specifiable signal handlers for
                             use by the standard SIGFPE handler for IEEE
                             arithmetic-related SIGFPE codes.  Since IEEE
                             trapping modes correspond to hardware modes,
                             elements of this array should only be modified
                             with a function like ieee_handler(3M) that
                             performs the appropriate hardware mode update.
                             If no sigfpe_handler has been declared for a
                             particular IEEE-related SIGFPE code, then the
                             related ieee_handlers will be invoked.

         IEEE Formats and Classification:

         single;extended     Definitions of IEEE formats.

         fp_class_type       An enumeration of the various classes of IEEE
                             values and symbols.

         IEEE Base Conversion:




   Page 2                                                                 7/91









   floatingpoint(3)        (BSD Compatibility Package)        floatingpoint(3)


               The functions described under floating_to_decimal(3) and
               decimal_to_floating(3) not only satisfy the IEEE Standard, but
               also the stricter requirements of correct rounding for all
               arguments.

         DECIMAL_STRING_LENGTH
                             The length of a decimal_string.

         decimal_string      The digit buffer in a decimal_record.

         decimal_record      The canonical form for representing an unpacked
                             decimal floating-point number.

         decimal_form        The type used to specify fixed or floating binary
                             to decimal conversion.

         decimal_mode        A struct that contains specifications for
                             conversion between binary and decimal.

         decimal_string_form An enumeration of possible valid character
                             strings representing floating-point numbers,
                             infinities, or NaNs.

   FILES
         /usr/include/sys/ieeefp.h
         /usr/include/fp.h
         /usr/ucblib/libucb.a

   SEE ALSO
         decimal_to_floating(3), econvert(3), floating_to_decimal(3),
         ieee_handler(3M), sigfpe(3).

         abort(3), strtod(3) in the Programmer's Reference Manual.




















   7/91                                                                 Page 3





Typewritten Software • bear@typewritten.org • Edmonds, WA 98026