Character Manipulation Function

errno_t _gcvt_s(char* buffer, size_t sizeInBytes, double value, int digits);

Internationalization (I18n) Function Overview

The _gcvt_s function is a secure version of _gcvt, performing error checking and returning an error code in the event of an error. It converts the floating-point value to a null-terminated character string (which includes a decimal point and a possible sign byte) and stores the string in buffer. digits is the number of significant digits stored and sizeInBytes is the byte size of buffer.

I18n Issues

This function should not be used for strings that will be displayed to the user, because the decimal separator and the position of the sign byte are not dependent on the numeric settings of the user's locale. In addition, _gcvt_s cannot be used with wide character strings.

Alternatively, one of the sprintf functions should be used, as these functions use the setting of the user locale's LC_NUMERIC category when formatting floating-point values. See String Formatting in C and C++ for a discussion on locale-sensitive formatting in internationalized applications.

Recommended Replacements*

Microsoft Windows MBCS	sprintf
Microsoft Windows Unicode	swprintf
Microsoft Windows Generic	_stprintf

Character Manipulation Functions