_ecvt

發行項
02/28/2013

將轉換double數字的字串。更安全版本之這個函式是可使用; see _ecvt_s.

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

參數

value
以指定須轉換的數字。
count
儲存的數字數目。
dec
預存的十進位小數點位置。
sign
轉換的數字正負號。

傳回值

_ecvt傳回的數字；該字串的指標如果發生錯誤，則為 NULL。

備註

_ecvt函式會將浮點數值轉換成字元字串。value參數是要轉換的浮點數。這個函式會將儲存多達count的數字value做為字串，並將 null 字元 ('\ 0')。如果數字位數，在value超過count，低序位的數字會四捨五入。如果未達count的數字，字串以零填補。

所傳回的數字總數_ecvt應該不超過_CVTBUFSIZE。

只有數字會儲存在字串中。小數點和的正負號的位置value可以取自dec和sign呼叫後。dec參數指向提供相對於字串開頭的小數點位置的整數值。0 或負值的整數值，表示小數點位於左邊的第一個數字。sign參數指向指示轉換的數字的正負號的整數。整數值為 0，如果是正數。否則，數值為負數。

之間的差異_ecvt和_fcvt中的轉譯工作count參數。_ecvt解譯count作為輸出字串中的數字總數而_fcvt解譯count的小數位數。

_ecvt與_fcvt用以轉換的單一靜態配置的緩衝區。每次呼叫其中一個這些常式會終結之前呼叫的結果。

這個函式會驗證它的參數。如果dec或sign為 NULL，或count為 0，不正確的參數處理常式會叫用，如所述參數驗證。如果要繼續，請允許執行errno設定為 [ EINVAL ，則傳回 NULL。

需求

Function	所需的標頭
_ecvt	<stdlib.h>

如需相容性資訊，請參閱相容性在簡介中。

範例

// crt_ecvt.c
// compile with: /W3
// This program uses _ecvt to convert a
// floating-point number to a character string.

#include <stdlib.h>
#include <stdio.h>

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

   buffer = _ecvt( source, precision, &decimal, &sign ); // C4996
   // Note: _ecvt is deprecated; consider using _ecvt_s instead
   printf( "source: %2.10f   buffer: '%s'  decimal: %d  sign: %d\n",
           source, buffer, decimal, sign );
}