Click above to get retro games delivered to your door ever month!

Synopsis:
    #include <stdlib.h>
    char *gcvt( double value,
                int ndigits,
                char *buffer );

Description:
    The gcvt function converts the floating-point number value into a
    character string and stores the result in buffer.  The parameter ndigits
    specifies the number of significant digits desired.  The converted
    number will be rounded to this position.

    If the exponent of the number is less than -4 or is greater than or
    equal to the number of significant digits wanted, then the number is
    converted into E-format, otherwise the number is formatted using
    F-format.

Returns:
    The gcvt function returns a pointer to the string of digits.

See Also:
    ecvt, fcvt, printf

Example:
    #include <stdio.h>
    #include <stdlib.h>

    void main()
      {
        char buffer[80];

        printf( "%s\n", gcvt( -123.456789, 5, buffer ) );
        printf( "%s\n", gcvt( 123.456789E+12, 5, buffer ) );
      }

    produces the following:

    -123.46
    1.2346E+014

Classification:
    WATCOM

Systems:
    All