_ecvt
將轉換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 );
}