strtod

Section: C Library Functions (3)
Updated: 2025-05-17
Index JM Home Page roff page
 

名前

strtod, strtof, strtold - ASCII 文字列を浮動小数点実数に変換する  

ライブラリ

標準 C ライブラリ (libc,~-lc)  

書式

#include <stdlib.h>

double strtod(const char *restrict nptr,
              char **_Nullable restrict endptr);
float strtof(const char *restrict nptr,
              char **_Nullable restrict endptr);
long double strtold(const char *restrict nptr,
              char **_Nullable restrict endptr);

glibc 向けの機能検査マクロの要件 (feature_test_macros(7) 参照):

strtof(), strtold():

    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
 

説明

strtod(), strtof(), strtold() 関数は、 nptr が指し示す文字列のはじめの部分を double, float, long double 型の値にそれぞれ変換する。

The expected form of the (initial portion of the) string is optional leading white space as recognized by isspace(3), an optional plus ('+') or minus sign ('-') and then either (i) a decimal number, or (ii) a hexadecimal number, or (iii) an infinity, or (iv) a NAN (not-a-number).

A decimal number consists of a nonempty sequence of decimal digits possibly containing a radix character (decimal point, locale-dependent, usually '.'), optionally followed by a decimal exponent. A decimal exponent consists of an 'E' or 'e', followed by an optional plus or minus sign, followed by a nonempty sequence of decimal digits, and indicates multiplication by a power of 10.

A hexadecimal number consists of a "0x" or "0X" followed by a nonempty sequence of hexadecimal digits possibly containing a radix character, optionally followed by a binary exponent. A binary exponent consists of a 'P' or 'p', followed by an optional plus or minus sign, followed by a nonempty sequence of decimal digits, and indicates multiplication by a power of 2. At least one of radix character and binary exponent must be present.

無限 は "INF" または "INFINITY" で表され、大文字小文字は区別されない。

A NAN is "NAN" (disregarding case) optionally followed by a string, (n-char-sequence), where n-char-sequence specifies in an implementation-dependent way the type of NAN (see VERSIONS).  

返り値

これらの関数は、変換された値があれば、それを返す。

endptr が NULL でないときは、変換に使われた最終文字の次の文字へのポインターが endptr で参照される場所へ保存される。

If no conversion is performed, zero is returned and (unless endptr is null) the value of nptr is stored in the location referenced by endptr.

If the correct value would cause overflow, plus or minus HUGE_VAL, HUGE_VALF, or HUGE_VALL is returned (according to the return type and sign of the value), and ERANGE is stored in errno.

If the correct value would cause underflow, a value with magnitude no larger than DBL_MIN, FLT_MIN, or LDBL_MIN is returned and ERANGE is stored in errno.  

エラー

ERANGE
オーバーフローまたはアンダーフローが起こった。
 

属性

この節で使用されている用語の説明については、 attributes(7) を参照。
インターフェース属性値
strtod(), strtof(), strtold() Thread safetyMT-Safe locale
 

バージョン

glibc の実装では、"NAN" の後ろに置くことができる n-char-sequence は、整数値として解釈される (基数の 8 や 16 を示す '0' や '0x' を接頭辞として付けることができる)。 この整数値は返り値の仮数部として使われる。  

標準規格

C11, POSIX.1-2008.  

歴史

strtod()
C89, POSIX.1-2001.
strtof()
strtold()
C99, POSIX.1-2001.
 

警告

成功、失敗どちらの場合でも 0 を返す可能性があるので、 プログラムは呼び出す前に errno を 0 に設定し、呼び出し後に errno が 0 以外の値かどうかを確認しエラーが発生したかどうかを判断する 必要がある。  

例

strtol(3) のマニュアルページの例を参照。 このページで説明した関数の使用方法も同様である。  

関連項目

atof(3), atoi(3), atol(3), nan(3), nanf(3), nanl(3), strfromd(3), strtol(3), strtoul(3)


 

Index

名前
ライブラリ
書式
説明
返り値
エラー
属性
バージョン
標準規格
歴史
警告
例
関連項目

This document was created by man2html, using the manual pages.