_ecvt

double 编号转换为字符串。 此函数有一个更安全的版本;请参阅 _ecvt_s

语法

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

参数

value
要转换的数字。

count
存储的数字位数。

dec
存储的十进制点位置。

sign
转换后的数字的符号。

返回值

_ecvt 会返回指向数字字符串的指针;如果发生错误,则为 NULL

注解

_ecvt 函数将浮点数转换为字符串。 value 参数是要转换的浮点数。 此函数最多存储 countvalue 作为字符串,并追加空字符 ('\0')。 如果 value 中的数字位数超过 count,则低位数字被舍入。 如果数字位数少于 count,则字符串使用零来填充。

_ecvt 返回的数字总位数不会超过 _CVTBUFSIZE

字符串中仅存储位数。 小数点位置和 value 的符号可以在调用后从 decsign 中获取。 dec 参数指向整数值;此整数值给定相对于字符串开头的小数点的位置。 0 或负整数值表示小数点位于第一个数字的左侧。 sign 参数指向一个整数,表示转换后的数字的符号。 如果整数值为 0,则数值为正值。 否认,数值为负值。

_ecvt_fcvt 之间的差异在于对 count 参数的解释。 _ecvtcount 解释为输出字符串中的数字总位数,而 _fcvtcount 解释为小数点后面的数字位数。

_ecvt_fcvt 使用用于转换的单个静态分配的缓冲区。 每次调用这些例程都会破坏上一次调用的结果。

此函数验证其参数。 如果 decsignNULL,或者 count 为 0,则会调用无效的参数处理程序,如参数验证中所述。 如果允许执行继续,则将 errno 设置为 EINVAL, 并返回 NULL

默认情况下,此函数的全局状态范围限定为应用程序。 若要更改此行为,请参阅 CRT 中的全局状态

要求

函数 必需的标头
_ecvt <stdlib.h>

有关兼容性的详细信息,请参阅 兼容性

示例

// 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 );
}
source: 3.1415926535   buffer: '3141592654'  decimal: 1  sign: 0

另请参阅

数据转换
数学和浮点支持

_fcvt
_gcvt