Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ gcvt(3) — DG/UX 4.00

Media Vault

Software Library

Restoration Projects

Artifacts Sought



                                                                  ecvt(3)



        _________________________________________________________________
        ecvt, fcvt, gcvt                                       Subroutine
        convert floating-point number to string
        _________________________________________________________________


        SYNTAX

        char *ecvt (value, ndigit, decpt, sign)
        double value;
        int ndigit, *decpt, *sign;

        char *fcvt (value, ndigit, decpt, sign)
        double value;
        int ndigit, *decpt, *sign;

        char *gcvt (value, ndigit, buf)
        double value;
        int ndigit;
        char *buf;


        DESCRIPTION

        Ecvt converts value to a null-terminated string of ndigit digits
        and returns a pointer thereto.  The decimal point is not included
        in the returned string.  The high-order digit is non-zero, unless
        the value is zero.  The low-order digit is rounded.  The position
        of the decimal point relative to the beginning of the string is
        stored indirectly through decpt (negative means to the left of
        the returned digits).  If the sign of the result is negative, the
        word pointed to by sign is non-zero; otherwise, it is zero.

        Fcvt performs the same conversion as ecvt, but ndigit specifies
        the number of places to the right of the implied decimal point to
        be used, rather than the total number of places.  So, where
        ecvt(12.3456, 3, decpt, sign) returns a pointer to character
        string 123\0, fcvt(12.3456, 3, decpt, sign) returns a pointer to
        character string 123456\0.

        Gcvt converts the value to a null-terminated string in the array
        pointed to by buf and returns buf.  It tries to produce ndigit
        significant digits in FORTRAN F-format if possible. If it cannot,
        it produces E-format, ready for printing. A minus sign or a
        decimal point will be included as part of the returned string.
        Trailing zeros are suppressed.


        SEE ALSO

        printf(3S).



        DG/UX 4.00                                                 Page 1
               Licensed material--property of copyright holder(s)





                                                                  ecvt(3)



        CAVEATS

        The values returned by ecvt and fcvt point to a single static
        data array whose content is overwritten by each call.


















































        DG/UX 4.00                                                 Page 2
               Licensed material--property of copyright holder(s)



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