_fcvt

将浮点数转换为字符串。 此函数有一个更安全的版本；请参阅 _fcvt_s。

语法

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

参数

value
要转换的数字。

count
小数点后面的数字位数。

dec
指向存储的小数点位置的指针。

sign
指向存储的符号指示符的指针。

返回值

_fcvt 返回指向数字字符串的指针；如果发生错误，则为 NULL。

备注

_fcvt 函数将浮点数转换为以 null 结尾的字符串。 value 参数是要转换的浮点数。 _fcvt 将 value 的位数存储为字符串，并追加一个空字符 ('\0')。 count 参数指定此小数点后要存储的数字位数。 多余的位数被舍入到 count 位置。 如果小于精确到 count 的位数，则字符串使用零填充。

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

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

_ecvt 和 _fcvt 之间的差异在于对 count 参数的解释。 _ecvt 将 count 解释为输出字符串中的数字总位数，而 _fcvt 将 count 解释为小数点后面的数字位数。

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

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

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

要求

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

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

示例

// crt_fcvt.c
// compile with: /W3
// This program converts the constant
// 3.1415926535 to a string and sets the pointer
// buffer to point to that string.

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

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

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

source: 3.1415926535   buffer: '31415927'   decimal: 1   sign: 0

另请参阅

数据转换
数学和浮点支持
atof、_atof_l、_wtof、_wtof_l
_ecvt
_gcvt