_fcvt_s

项目
06/09/2015

将浮点数转换为字符串。 _fcvt 的一些版本提供安全增强功能（如 CRT 中的安全功能所述）。

errno_t _fcvt_s( 
   char* buffer,
   size_t sizeInBytes,
   double value,
   int count,
   int *dec,
   int *sign 
);
template <size_t size>
errno_t _fcvt_s( 
   char (&buffer)[size],
   double value,
   int count,
   int *dec,
   int *sign 
); // C++ only

参数

[out] buffer
提供的缓冲区将保持转换的结果。
[in] sizeInBytes
缓冲区的字节大小。
[in] value
数字可被转换.
[in] count
小数点后数字的位数。
[out] dec
指向存储的小数点位置的指针。
[out] sign
指向存储的符号指示器的指针。

返回值

如果成功,是0。如果失败，返回值是错误代码。错误代码在Errno.h中被定义。有关这些错误的列表，请参阅errno、_doserrno、_sys_errlist 和 _sys_nerr。

对于无效的参数中，如下表中所列，此函数调用的参数无效处理程序，如参数验证所述。如果允许执行继续，则该函数设置 errno 为 EINVAL 并返回 EINVAL。

错误情况

buffer	sizeInBytes	值	count	dec	sign	返回	buffer中的值
NULL	any	any	any	any	any	EINVAL	未被修改
不是 NULL (指向有效的内存)	<=0	any	any	any	any	EINVAL	未被修改
any	any	any	any	NULL	any	EINVAL	未被修改
any	any	any	any	any	NULL	EINVAL	未被修改

安全问题

如果 buffer 不指向有效的内存和不是 NULL，_fcvt_s 可能会发生访问冲突。

备注

_fcvt_s 函数将浮点数转换为空终止字符字符串。 value 参数是转换浮点数。 _fcvt_s 存储 value 值作为字符串并添加空字符 (“\ 0 ")。 count 参数指定小数点后要存储的位数。多余的数字被四舍五入到 count 位置。如果小于精度的 count 位数，用零填充字符串。

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

长度为 _CVTBUFSIZE 的缓冲区足够存储任意浮点值。

_ecvt_s 和 _fcvt_s 的差异在于对 count 参数的解释不同。 _ecvt_s 将 count 解释为输出字符串的总位数，而 _fcvt_s 将 count 解释为在小数点后的位数。

在 C++ 中，使用这些函数是由重载模板简化；该重载可以自动推断缓冲区长度，而无需指定范围参数。有关更多信息，请参见安全模板重载。

这些函数的调试版本首先用 0xFD 填充缓冲区。若要禁用此行为，请使用 _CrtSetDebugFillThreshold。

要求

功能	必需的标头	可选标头
_fcvt_s	<stdlib.h>	<errno.h>

有关更多兼容性信息，请参见简介中的兼容性。

Libraries: 的所有版本 CRT 库功能.

示例

// fcvt_s.c
#include <stdio.h>
#include <stdlib.h>
#include <errno.h>

int main()
{
  char * buf = 0;
  int decimal;
  int sign;
  int err;

  buf = (char*) malloc(_CVTBUFSIZE);
  err = _fcvt_s(buf, _CVTBUFSIZE, 1.2, 5, &decimal, &sign);
  
  if (err != 0)
  {
     printf("_fcvt_s failed with error code %d\n", err);
     exit(1);
  }

  printf("Converted value: %s\n", buf);  
  
}