strtof, strtod, strtold

 

C

編譯器支援

語言

標頭檔案

型別支援

程式工具

變參函式支援

錯誤處理

動態記憶體管理

字串庫

演算法

數值

日期和時間工具

輸入/輸出支援

本地化支援

併發支援 (C11)

技術規範

符號索引

 

字串庫

空終止位元組字串

空終止多位元組字串

空終止寬字串

 

空終止位元組字串

函式
字元操作
isalnum isalpha islower isupper isdigit isxdigit isblank (C99)	iscntrl isgraph isspace isprint ispunct tolower toupper
與數字格式相互轉換
atoiatolatoll (C99) atof strtolstrtoll (C99) strtoulstrtoull (C99)	strtoimaxstrtoumax (C99)(C99) strtofstrtodstrtold (C99)(C99) strfromfstrfromdstrfroml (C23)(C23)(C23)
字串操作
strcpystrcpy_s (C11) strncpystrncpy_s (C11) strcatstrcat_s (C11)	strncatstrncat_s (C11) strxfrm strdup (C23) strndup (C23)
字串檢查
strlenstrnlen_s (C11) strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtokstrtok_s (C11)
記憶體操作
memchr memcmp memsetmemset_explicitmemset_s (C23)(C11)	memcpymemcpy_s (C11) memmovememmove_s (C11) memccpy (C23)
雜項
strerrorstrerror_sstrerrorlen_s (C11)(C11)

 

在標頭檔案 <stdlib.h> 中定義
float       strtof ( const char* restrict str, char** restrict str_end );	(1)	(C99 起)
	(2)
double      strtod ( const char*          str, char**          str_end );			(直到 C99)
double      strtod ( const char* restrict str, char** restrict str_end );			(C99 起)
long double strtold( const char* restrict str, char** restrict str_end );		(3)	(C99 起)

將 str 指向的位元組字串解釋為浮點值。

函式會丟棄任何空白字元（由 isspace 確定），直到找到第一個非空白字元。然後，它會盡可能多地獲取字元以形成一個有效的浮點表示，並將它們轉換為一個浮點值。有效的浮點值可以是以下之一：

• 十進位制浮點表示式。它由以下部分組成：

• (可選) 加號或減號
• 非空十進位制數字序列，可選地包含小數點字元（由當前的 C locale 確定）（定義有效數字）
• (可選) e 或 E，後跟可選的減號或加號以及非空十進位制數字序列（定義以 10 為底的指數）

十六進位制浮點表示式。它由以下部分組成： (可選) 加號或減號 0x 或 0X 非空十六進位制數字序列，可選地包含小數點字元（由當前的 C locale 確定）（定義有效數字） (可選) p 或 P，後跟可選的減號或加號以及非空十進位制數字序列（定義以 2 為底的指數） 無窮大表達式。它由以下部分組成： (可選) 加號或減號 INF 或 INFINITY，不區分大小寫 非數字表達式。它由以下部分組成： (可選) 加號或減號 NAN 或 NAN(char_sequence )，忽略 NAN 部分的大小寫。char_sequence 只能包含數字、拉丁字母和下劃線。結果是一個 quiet NaN 浮點值。

(C99 起)

• 當前安裝的 C locale 可能接受的任何其他表示式。

函式會將 str_end 指向的指標設定為指向最後一個被解釋字元的下一個字元。如果 str_end 是空指標，則忽略它。

引數

str	-	指向要解釋的空終止位元組字串的指標
str_end	-	指向字元指標的指標

返回值

成功時，返回對應於 str 內容的浮點值。如果轉換後的值超出相應返回型別的範圍，則發生範圍錯誤（errno 設定為 ERANGE），並返回 HUGE_VAL、HUGE_VALF 或 HUGE_VALL。如果無法執行轉換，則返回 ​0​。

示例

執行此程式碼

#include <errno.h>
#include <stdio.h>
#include <stdlib.h>
 
int main(void)
{
    // parsing with error handling
    const char* p = "111.11 -2.22 Nan nan(2) inF 0X1.BC70A3D70A3D7P+6  1.18973e+4932zzz";
    printf("Parsing '%s':\n", p);
    char* end = NULL;
    for (double f = strtod(p, &end); p != end; f = strtod(p, &end))
    {
        printf("'%.*s' -> ", (int)(end - p), p);
        p = end;
        if (errno == ERANGE)
        {
            printf("range error, got ");
            errno = 0;
        }
        printf("%f\n", f);
    }
 
    // parsing without error handling
    printf("\"  -0.0000000123junk\"  -->  %g\n", strtod("  -0.0000000123junk", NULL));
    printf("\"junk\"                 -->  %g\n", strtod("junk", NULL));
}

可能的輸出

Parsing '111.11 -2.22 Nan nan(2) inF 0X1.BC70A3D70A3D7P+6  1.18973e+4932zzz':
'111.11' -> 111.110000
' -2.22' -> -2.220000
' Nan' -> nan
' nan(2)' -> nan
' inF' -> inf
' 0X1.BC70A3D70A3D7P+6' -> 111.110000
'  1.18973e+4932' -> range error, got inf
"  -0.0000000123junk"  -->  -1.23e-08
"junk"                 -->  0

參考

• C23 標準 (ISO/IEC 9899:2024)

• 7.22.1.3 strtod、strtof 和 strtold 函式 (p: TBD)

• C17 標準 (ISO/IEC 9899:2018)

• 7.22.1.3 strtod、strtof 和 strtold 函式 (p: 249-251)

• C11 標準 (ISO/IEC 9899:2011)

• 7.22.1.3 strtod、strtof 和 strtold 函式 (p: 342-344)

• C99 標準 (ISO/IEC 9899:1999)

• 7.20.1.3 strtod、strtof 和 strtold 函式 (p: 308-310)

• C89/C90 標準 (ISO/IEC 9899:1990)

• 4.10.1.4 strtod 函式

另請參閱

atof	將位元組字串轉換為浮點值 (函式)
wcstofwcstodwcstold (C99)(C95)(C99)	將寬字串轉換為浮點值 (函式)
C++ 文件 用於 strtof, strtod, strtold