NOMBRE

       ecvt, fcvt - convierte un número en coma flotante a una cadena de caracteres.

SINOPSIS

       #include <stdlib.h>

       char *ecvt(double number, int ndigits, int *decpt, int *sign);

       char *fcvt(double number, int ndigits, int *decpt, int *sign);

DESCRIPCIÓN

       La  función  ecvt()  convierte number a una cadena terminada en NULL de ndigits dígitos (donde ndigits se
       reduce a un límite específico del sistema determinado por la precisión de un  `double'),  y  devuelve  un
       puntero a la cadena. El dígito de mayor orden es no cero, a menos que number sea cero. El dígito de menor
       orden  se  redondea.   La  cadena  en si no contiene un punto decimal. Sin embargo, la posición del punto
       decimal relativa al comienzo de la cadena se guarda en *decpt.  Un valor negativo para  *decpt  significa
       que el punto decimal está a la izquierda del comienzo de la cadena. Si el signo de number es negativo, se
       coloca  en  *sign  un  valor  distinto  de  cero.  Si  no,  se  coloca un 0. Si number es cero, queda sin
       especificar si *decpt es 0 o 1.

       La función fcvt() es idéntica a ecvt(), excepto en que ndigits especifica el número de  dígitos  tras  el
       punto decimal.

VALOR DEVUELTO

       Ambas   funciones,  ecvt()  y  fcvt(),  devuelven  un  puntero  a  una  cadena  estática  conteniendo  la
       representación ASCII de number.  La cadena estática se sobreescribe en cada llamada a ecvt() o a fcvt().

NOTA

       Estas funciones están obsoletas. En su lugar, se recomienda sprintf().  Las bibliotecas libc4 y libc5  de
       Linux  especifican  el  tipo  de  ndigits como size_t.  No todas las especializaciones regionales usan un
       punto como carácter radical (`punto decimal').

CONFORME A

       SysVR2, XPG2

VÉASE TAMBIÉN

       ecvt_r(3), gcvt(3), qecvt(3), setlocale(3), sprintf(3)

                                                  25 junio 1999                                          ECVT(3)