[Previous]
[Contents]
[Next]

gcvt(), _gcvt()

convert a floating-point number into a string

Synopsis:

#include <stdlib.h>

char *gcvt( double value,
            int ndigits,
            char *buffer );
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.

The _gcvt() function is identical to gcvt(). Use _gcvt() for ANSI/ISO naming conventions.

Returns:

A pointer to the string of digits.

Examples:

#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 output

-123.46
1.2346E+014

Classification:

WATCOM

_gcvt() conforms to ANSI/ISO naming conventions

Safety:
Interrupt handler No
Signal handler No
Thread Yes

See also:

ecvt(), fcvt(), printf()


[Previous]
[Contents]
[Next]