Share via


_fcvt (Windows CE 5.0)

Send Feedback

Developing an Application > Microsoft C Run-time Library for Windows CE > Run-time Library Reference

Converts a floating-point number to a string.

char *_fcvt(    doublevalue,intcount,int*dec,int*sign);

Parameters

  • value
    Number to be converted.
  • count
    Number of digits after decimal point.
  • dec
    Pointer to stored decimal-point position.
  • sign
    Pointer to stored sign indicator.

Return Values

_fcvt returns a pointer to the string of digits.

There is no error return.

Remarks

The _fcvt function converts a floating-point number to a null-terminated character string. The value parameter is the floating-point number to be converted.

_fcvt stores the digits of value as a string and appends a null character ('\0').

The count parameter specifies the number of digits to be stored after the decimal point.

Excess digits are rounded off to count places. If there are fewer than count digits of precision, the string is padded with zeros.

Only digits are stored in the string.

The position of the decimal point and the sign of value can be obtained from dec and sign after the call.

The dec parameter points to an integer value that gives the position of the decimal point with respect to the beginning of the string.

A zero or negative integer value indicates that the decimal point lies to the left of the first digit.

The parameter sign points to an integer indicating the sign of value. If value is positive, the integer is set to 0; if value is negative, the integer is set to a nonzero number.

_ecvt and _fcvt use a single statically allocated buffer for the conversion. Each call to one of these routines destroys the results of the previous call.

Example

/* FCVT.C: 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>

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

   buffer = _fcvt( source, 7, &decimal, &sign );
   printf( "source: %2.10f   buffer: '%s'   decimal: %d   sign: %d\n",
            source, buffer, decimal, sign );
}

Output

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

Requirements

OS Versions: Windows CE 2.0 and later.
Header: stdlib.h.
Link Library: coredll.dll.

See Also

atof | _ecvt | _gcvt

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.