_fcvt

Articolo
03/05/2013

Converte un numero a virgola mobile in una stringa.Una versione più sicura di questa funzione è disponibile; vedere _fcvt_s.

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

Parametri

value
Numero da convertire.
count
Numero di cifre dopo il separatore decimale.
dec
Puntatore alla posizione del separatore decimale archiviata.
sign
Puntatore all'indicatore archiviato di segno.

Valore restituito

_fcvt restituisce un puntatore alla stringa di cifre, NULL sugli errori.

Note

_fcvt la funzione consente di convertire un numero a virgola mobile in una stringa di caratteri con terminazione null.value il parametro è il numero a virgola mobile da convertire._fcvt archivia le cifre di value come stringa e viene aggiunto un carattere null (" \ 0 ").count il parametro specifica il numero di cifre da archiviare dopo il separatore decimale.Le cifre in eccesso sono arrotondate all'esterno a count posizioni.Se vi sono meno che count le cifre di precisione, la stringa viene applicato il riempiti con zeri.

Il numero totale di cifre restituiti da _fcvt non eccederà _CVTBUFSIZE.

Solo cifre vengono archiviate nella stringa.La posizione del separatore decimale e il segno di value può essere ottenuto da dec e segno dopo la chiamata.dec punti di parametro su un valore Integer, questo valore Integer fornisce la posizione del separatore decimale in relazione all'inizio della stringa.Un valore Integer zero o negativo indica che il separatore decimale si trova a sinistra della prima cifra.il parametro sign punta a un intero che indica il segno di value.Integer è impostato su 0 se value è positivo e su un numero diverso da zero se value è negativo.

La differenza tra _ecvt e _fcvt è nell'interpretazione di count parametro._ecvt interpreta count come numero totale di cifre nella stringa di output, mentre _fcvt interpreta count come numero di cifre dopo il separatore decimale.

_ecvt e _fcvt utilizzare un solo buffer statico allocato per la conversione.Ogni chiamata a una di queste routine eliminata la chiamata precedente.

Questa funzione convalida dei parametri.se dec o sign è NULL, o count è 0, il gestore non valido di parametro viene richiamato, come descritto in Convalida dei parametri.Se l'esecuzione è consentita per continuare, errno è impostato su EINVAL e viene restituito NULL.

Requisiti

Funzione	Intestazione di associazione
_fcvt	<definito>

Per ulteriori informazioni sulla compatibilità, vedere compatibilità nell'introduzione.

Esempio

// 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 );
}