_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