wcstof, wcstod, wcstold
|
定義先ヘッダ
<wchar.h>
|
||
|
float
wcstof
(
const
wchar_t
*
restrict
str,
wchar_t
**
restrict
str_end
)
;
|
(C99以降) | |
|
double
wcstod
(
const
wchar_t
*
str,
wchar_t
**
str_end
)
;
|
(C95以降)
(C99まで) |
|
|
double
wcstod
(
const
wchar_t
*
restrict
str,
wchar_t
**
restrict
str_end
)
;
|
(C99以降) | |
|
long
double
wcstold
(
const
wchar_t
*
restrict
str,
wchar_t
**
restrict
str_end
)
;
|
(C99以降) | |
ワイド文字列で指し示される str の浮動小数点値を解釈します。
関数は( iswspace によって判定される)空白文字を最初の非空白文字が見つかるまで破棄します。その後、有効な浮動小数点表現を形成するために可能な限りの文字列を取得し、それらを浮動小数点値に変換します。有効な浮動小数点値は以下のいずれかです:
- 10進浮動小数点式。以下の部分で構成されます:
-
- (オプション) プラスまたはマイナス記号
- 空でない10進数のシーケンス(現在のC locale によって決定される)に、オプションで小数点文字を含む(仮数部を定義)
-
(オプション)
eまたはEの後に、オプションのマイナスまたはプラス記号と空でない10進数のシーケンスが続く(基数 10 の指数を定義)
|
(C99以降) |
- 現在インストールされているC ロケール で受け入れられる可能性があるその他の式。
この関数は、 str_end が指すポインタが、最後に解釈されたワイド文字の次の文字を指すように設定します。 str_end がヌルポインタの場合、この処理は無視されます。
目次 |
パラメータ
| str | - | 解釈対象のnull終端ワイド文字列へのポインタ |
| str_end | - | ワイド文字へのポインタへのポインタ |
戻り値
成功時には str の内容に対応する浮動小数点値。変換された値が対応する戻り値の型の範囲外の場合、範囲エラーが発生し HUGE_VAL 、 HUGE_VALF または HUGE_VALL が返されます。変換が実行できない場合は 0 が返されます。
例
#include <errno.h> #include <stdio.h> #include <wchar.h> int main(void) { const wchar_t* p = L"111.11 -2.22 0X1.BC70A3D70A3D7P+6 1.18973e+4932zzz"; printf("Parsing L\"%ls\":\n", p); wchar_t* end; for (double f = wcstod(p, &end); p != end; f = wcstod(p, &end)) { printf("'%.*ls' -> ", (int)(end-p), p); p = end; if (errno == ERANGE){ printf("range error, got "); errno = 0; } printf("%f\n", f); } }
出力:
Parsing L"111.11 -2.22 0X1.BC70A3D70A3D7P+6 1.18973e+4932zzz": '111.11' -> 111.110000 ' -2.22' -> -2.220000 ' 0X1.BC70A3D70A3D7P+6' -> 111.110000 ' 1.18973e+4932' -> range error, got inf
参考文献
- C23規格 (ISO/IEC 9899:2024):
-
- 7.29.4.1.1 wcstod、wcstof、wcstold関数 (p: TBD)
- C17規格 (ISO/IEC 9899:2018):
-
- 7.29.4.1.1 wcstod、wcstof、およびwcstold関数 (p: TBD)
- C11規格 (ISO/IEC 9899:2011):
-
- 7.29.4.1.1 wcstod、wcstof、およびwcstold関数 (p: 426-428)
- C99規格 (ISO/IEC 9899:1999):
-
- 7.24.4.1.1 wcstod、wcstof、wcstold関数 (p: 372-374)
関連項目
|
(C99)
(C99)
|
バイト文字列を浮動小数点値に変換する
(関数) |
|
C++ documentation
for
wcstof
,
wcstod
,
wcstold
|
|