Compartir a través de


_ecvt

Convierte un número de double en una cadena. Una versión más segura de esta función está disponible; vea _ecvt_s.

char *_ecvt( 
   double value,
   int count,
   int *dec,
   int *sign 
);

Parámetros

  • value
    Número que se va a convertir.

  • count
    Número de dígitos almacenados.

  • dec
    Posición de separador decimal almacenada.

  • sign
    Signo de número convertido.

Valor devuelto

_ecvt devuelve un puntero a la cadena de dígitos; NULL si se ha producido un error.

Comentarios

La función de _ecvt convierte un número en punto flotante a una cadena de caracteres. El parámetro de value es el número de punto flotante que se va a convertir. Esta función almacena hasta count dígitos de value como cadena y anexa un carácter null (“\0”). Si el número de dígitos en value supera count, se redondea el dígito de orden inferior. Si hay menos que los dígitos de count , la cadena se rellena con ceros.

El número total de dígitos devueltos por _ecvt no superará _CVTBUFSIZE.

Sólo dígitos se almacenan en la cadena. La posición del separador decimal y el signo de value se pueden obtener de dec y de sign después de la llamada. Los puntos del parámetro de dec a un valor entero que indica la posición del separador decimal con respecto al principio de la cadena. Un 0 o un valor entero negativo indica que el separador decimal se encuentra a la izquierda del primer dígito. Los puntos del parámetro de sign a un entero que indica el signo de número convertido. Si el valor entero es 0, el número es positivo. Si no, el número es negativo.

La diferencia entre _ecvt y _fcvt está en la del parámetro de count . _ecvt interpreta count como el número total de dígitos en la cadena de salida, mientras que _fcvt interpreta count como el número de dígitos después del separador decimal.

_ecvt y _fcvt utilizan un único búfer estáticamente asignado para la conversión. Cada llamada a una de estas rutinas destruye el resultado de la llamada anterior.

Esta función valida sus parámetros. Si dec o sign es NULL, o count es 0, se invoca el controlador no válido de parámetro, tal y como se describe en Validación de parámetros. Si la ejecución puede continuar, errno se establece en EINVAL y se devuelve NULL.

Requisitos

Función

Encabezado necesario

_ecvt

<stdlib.h>

Para obtener más información de compatibilidad, vea Compatibilidad en la Introducción.

Ejemplo

// crt_ecvt.c
// compile with: /W3
// This program uses _ecvt to convert a
// floating-point number to a character string.

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

int main( void )
{
   int     decimal,   sign;
   char    *buffer;
   int     precision = 10;
   double  source = 3.1415926535;

   buffer = _ecvt( source, precision, &decimal, &sign ); // C4996
   // Note: _ecvt is deprecated; consider using _ecvt_s instead
   printf( "source: %2.10f   buffer: '%s'  decimal: %d  sign: %d\n",
           source, buffer, decimal, sign );
}
  

Equivalente en .NET Framework

System::Convert::ToString

Vea también

Referencia

Conversión de datos

Compatibilidad con el punto flotante

atof, _atof_l, _wtof, _wtof_l

_fcvt

_gcvt