ecvt(3)                             CLIX                             ecvt(3)



  NAME

    ecvt, fcvt, gcvt - Convert a floating-point number to string

  LIBRARY

    Standard C Library (libc.a)

  SYNOPSIS

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

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

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

  PARAMETERS

    value    A number of type double to be converted.

    ndigit   The number of digits in the converted string.

    decpt    A pointer to an integer representing the position of the decimal
             point relative to the beginning of the string.

    sign     A pointer to the sign of the result.

    buf      A buffer containing a converted string.

  DESCRIPTION

    The ecvt() function converts value to a null-terminated string of ndigit
    digits and returns a pointer thereto.  The high-order digit is nonzero,
    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).  The decimal point is not included in the returned string.  If
    the sign of the result is negative, the word pointed to by sign is
    nonzero, otherwise it is zero.




  2/94 - Intergraph Corporation                                              1

  ecvt(3)                             CLIX                             ecvt(3)



    The fcvt() function is identical to ecvt(), except that the correct digit
    has been rounded for printf "%f" (FORTRAN F-format) output of the number
    of digits specified by ndigit.

    The gcvt() function converts the value to a null-terminated string in the
    array pointed to by buf and returns buf.  It attempts to produce ndigit
    significant digits in FORTRAN F-format if possible, otherwise E-format,
    ready for printing.  A minus sign, if there is one, or a decimal point
    will be included as part of the returned string.  Trailing zeros are
    suppressed.

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

  RETURN VALUES

    See DESCRIPTION.

  RELATED INFORMATION

    Functions:  printf(3)

































  2                                              Intergraph Corporation - 2/94