github.com/shogo82148/std@v1.22.1-0.20240327122250-4e474527810c/strconv/atof.go (about)

     1  // Copyright 2009 The Go Authors. All rights reserved.
     2  // Use of this source code is governed by a BSD-style
     3  // license that can be found in the LICENSE file.
     4  
     5  package strconv
     6  
     7  // ParseFloatは、文字列sを、bitSizeで指定された精度の浮動小数点数に変換します。
     8  // bitSize=32の場合、結果はfloat64型のままですが、値を変更せずにfloat32型に変換できます。
     9  //
    10  // ParseFloatは、[浮動小数点リテラル] のGo構文で定義された10進数および16進数の浮動小数点数を受け入れます。
    11  // sが正しく形成され、有効な浮動小数点数に近い場合、ParseFloatはIEEE754のバイアスのない丸めを使用して最も近い浮動小数点数を返します。
    12  // （16進数の浮動小数点値を解析する場合、16進数表現にビットが多すぎてマンティッサに収まらない場合にのみ丸めが行われます。）
    13  //
    14  // ParseFloatが返すエラーは、*NumErrorの具体的な型であり、err.Num = sを含みます。
    15  //
    16  // sが構文的に正しくない場合、ParseFloatはerr.Err = ErrSyntaxを返します。
    17  //
    18  // sが構文的に正しく、与えられたサイズの最大浮動小数点数から1/2 ULP以上離れている場合、
    19  // ParseFloatはf = ±Inf、err.Err = ErrRangeを返します。
    20  //
    21  // ParseFloatは、文字列 "NaN" および (可能な場合は符号付きの) 文字列 "Inf" および "Infinity" を、
    22  // それぞれ特別な浮動小数点値として認識します。大文字小文字は区別されません。
    23  //
    24  // [浮動小数点リテラル]: https://go.dev/ref/spec#Floating-point_literals
    25  func ParseFloat(s string, bitSize int) (float64, error)