Ruby 1.8.7 リファレンスマニュアル > ライブラリ一覧 > 組み込みライブラリ > Floatクラス

class Float

クラスの継承リスト: Float < Precision < Numeric < Comparable < Object < Kernel

要約

浮動小数点数のクラス。Float の実装は C 言語の double で、その精度は環 境に依存します。

一般にはせいぜい15桁です。詳しくは多くのシステムで採用されている 浮動小数点標準規格、IEEE (Institute of Electrical and Electronics Engineers: 米国電気電子技術者協会) 754 を参照してください。

# あるシステムでの 1/3(=0.333...) の結果
printf("%.50f\n", 1.0/3)
=> 0.33333333333333331482961625624739099293947219848633

Math::PI などの数学定数については Math を 参照してください。

目次

特異メソッド
induced_from
インスタンスメソッド
% modulo * ** + - -@ / < <= <=> == > >= abs ceil divmod eql? finite? floor hash infinite? nan? round to_f to_i truncate to_s zero?
定数
DIG EPSILON MANT_DIG MAX MAX_10_EXP MAX_EXP MIN MIN_10_EXP MIN_EXP RADIX ROUNDS

特異メソッド

induced_from(num) -> Float[permalink][rdoc]

num を Float に変換した結果を返します。

[PARAM] num:
変換前の数値
[EXCEPTION] TypeError:
Fixnum, Bignum, Float以外を入力した場合に発生します
p Float.induced_from(30) #=> 30.0
p Float.induced_from(Math::PI) #=> 3.14159265358979
begin
  Float.induced_from("1.732")
rescue TypeError
  p $! #=> #<TypeError: failed to convert String into Float>
end

インスタンスメソッド

self % other -> Float[permalink][rdoc]
modulo(other) -> Float

算術演算子。剰余を計算します。

[PARAM] other:
二項演算の右側の引数(対象)
# 剰余
3 % 1.2   #=> 0.6
3.0 % 0   #=> NaN
self * other -> Float[permalink][rdoc]

算術演算子。積を計算します。

[PARAM] other:
二項演算の右側の引数(対象)
# 積
2.4 * 3   #=> 7.2
self ** other -> Float[permalink][rdoc]

算術演算子。冪を計算します。

[PARAM] other:
二項演算の右側の引数(対象)
# 冪
1.2 ** 3.0  #=> 1.728
3.0 + 4.5 - 1.3 / 2.4 * 3 % 1.2 ** 3.0 #=> 5.875
0.0 ** 0 #=> 1.0
self + other -> Float[permalink][rdoc]

算術演算子。和を計算します。

[PARAM] other:
二項演算の右側の引数(対象)
# 和
3.0 + 4.5 #=> 7.5
self - other -> Float[permalink][rdoc]

算術演算子。差を計算します。

[PARAM] other:
二項演算の右側の引数(対象)
# 差
4.5 - 1.3 #=> 3.2
- self -> Float[permalink][rdoc]

単項演算子の - です。 self の符号を反転させたものを返します。

self / other -> Float[permalink][rdoc]

算術演算子。商を計算します。

[PARAM] other:
二項演算の右側の引数(対象)
# 商
1.3 / 2.4 #=> 0.541666666666667
1.0 / 0   #=> Infinity
self < other -> bool[permalink][rdoc]

比較演算子。数値として小さいか判定します。

[PARAM] other:
比較対象の数値
[RETURN]
self よりも other が大きい場合 true を返します。 そうでなければ false を返します。

例:

3.14 <  3.1415  #=> true
3.14 <= 3.1415  #=> true
self <= other -> bool[permalink][rdoc]

比較演算子。数値として等しいまたは小さいか判定します。

[PARAM] other:
比較対象の数値
[RETURN]
self よりも other の方が大きい場合か、 両者が等しい場合 true を返します。 そうでなければ false を返します。

例:

3.14 <  3.1415  #=> true
3.14 <= 3.1415  #=> true
self <=> other -> 1 | 0 | -1 | nil[permalink][rdoc]

self と other を比較して、self が大きい時に正、 等しい時に 0、小さい時に負の整数を返します。 比較できない場合はnilを返します

例:

3.05 <=> 3.14 #=> -1
1.732 <=> 1.414  #=> 1
3.3 - 3.3 <=> 0.0 #=> 0
3.14 <=> "hoge" #=> nil
3.14 <=> 0.0/0.0 #=> nil
self == other -> bool[permalink][rdoc]

比較演算子。数値として等しいか判定します。

ただし、NaN 同士の比較では常に false を返します。

[PARAM] other:
比較対象の数値
[RETURN]
self と other が等しい場合 true を返します。 そうでなければ false を返します。

例:

3.14 == 3.14000 #=> true
3.14 == 3.1415  #=> false

# NaN 同士では常に false
nan = 0.0/0
nan == nan      # => false
self > other -> bool[permalink][rdoc]

比較演算子。数値として大きいか判定します。

[PARAM] other:
比較対象の数値
[RETURN]
self よりも other の方が小さい場合 true を返します。 そうでなければ false を返します。

例:

3.14 >  3.1415  #=> false
3.14 >= 3.1415  #=> false
self >= other -> bool[permalink][rdoc]

比較演算子。数値として等しいまたは大きいか判定します。

[PARAM] other:
比較対象の数値
[RETURN]
self よりも other の方が小さい場合か、 両者が等しい場合 true を返します。 そうでなければ false を返します。

例:

3.14 >  3.1415  #=> false
3.14 >= 3.1415  #=> false
abs -> Float[permalink][rdoc]

自身の絶対値を返します。

例:

 34.56.abs     #=> 34.56
-34.56.abs     #=> 34.56
ceil -> Integer[permalink][rdoc]

自身と等しいかより大きな整数のうち最小のものを返します。

例:

1.0.ceil      #=> 1
1.2.ceil      #=> 2
(-1.2).ceil   #=> -1
(-1.5).ceil   #=> -1

[SEE_ALSO] Float#floor, Float#round, Float#truncate

divmod(other) -> [Numeric][permalink][rdoc]

self を other で割った商 q と余り r を、 [q, r] という 2 要素の配列にして返します。 商 q は常に整数ですが、余り r は整数であるとは限りません。

ここで、商 q と余り r は、

をみたす数です。 このメソッドは、メソッド / と % によって定義されています。

[PARAM] other:
自身を割る数を指定します。

例:

11.divmod(3)         #=> [3, 2]
(11.5).divmod(3.5)   #=> [3, 1.0]
11.divmod(-3)        #=> [-4, -1]
11.divmod(3.5)       #=> [3, 0.5]
(-11).divmod(3.5)    #=> [-4, 3.0]

[SEE_ALSO] Numeric#div, Numeric#modulo

eql?(other) -> bool[permalink][rdoc]

自身と other のクラスが等しくかつ == メソッドで比較して等しい場合に true を返します。 そうでない場合に false を返します。

[PARAM] other:
自身と比較したい数値を指定します。

例:

1.0.eql?(1)   #=> false
1.0.eql?(1.0) #=> true
finite? -> bool[permalink][rdoc]

数値が ∞, -∞, あるいは NaN でない場合に true を返します。 そうでない場合に false を返します。

例:

3.14.finite? #=> true
inf = 1.0/0
inf.finite? #=> false
floor -> Integer[permalink][rdoc]

自身と等しいかより小さな整数のうち最大のものを返します。

例:

1.0.floor      #=> 1
1.2.floor      #=> 1
(-1.2).floor   #=> -2
(-1.5).floor   #=> -2

[SEE_ALSO] Numeric#ceil, Numeric#round, Float#truncate

hash -> Fixnum[permalink][rdoc]

ハッシュ値を返します。

例:

pi1 = 3.14
pi2 = 3.14
pi3 = 3.1415

pi1.hash #=> 335364239
pi2.hash #=> 335364239
pi3.hash #=> 420540030
infinite? -> 1 | -1 | nil[permalink][rdoc]

数値が +∞ のとき 1、-∞のとき -1 を返します。それ以外は nil を返 します。

例:

inf = 1.0/0
p inf
p inf.infinite?

=> Infinity
   1

inf = -1.0/0
p inf
p inf.infinite?

=> -Infinity
   -1
nan? -> bool[permalink][rdoc]

数値が NaN(Not a number)のとき真を返します。

例:

nan = 0.0/0.0
p nan
p nan.nan?

=> NaN
   true
round -> Fixnum[permalink][rdoc]

自身ともっとも近い整数を返します。

中央値 0.5, -0.5 はそれぞれ 1,-1 に切り上げされます。 いわゆる四捨五入ですが、偶数丸めではありません。

例:

1.0.round      #=> 1
1.2.round      #=> 1
(-1.2).round   #=> -1
(-1.5).round   #=> -2

[SEE_ALSO] Float#ceil, Float#floor, Float#truncate

to_f -> self[permalink][rdoc]

self を返します。

例:

3.14.to_f   #=> 3.14
to_i -> Integer[permalink][rdoc]
truncate -> Integer

小数点以下を切り捨てて値を整数に変換します。

例:

3.14.to_i   #=> 3

[SEE_ALSO] Numeric#round, Numeric#ceil, Numeric#floor

to_s -> String[permalink][rdoc]

自身を人間が読みやすい形の文字列表現にして返します。

固定小数点、浮動小数点の形式か、 "Infinity"、"-Infinity"、"NaN" のいず れかを返します。

[RETURN]
文字列を返します。

例:

0.00001.to_s             # => "1.0e-05"
3.14.to_s                # => "3.14"
10000_00000_00000.0.to_s # => "1.0e+14"
(1.0/0.0).to_s           # => "Infinity"
(0.0/0.0).to_s           # => "NaN"
zero? -> bool[permalink][rdoc]

自身がゼロの時、真を返します。そうでない場合は false を返します。

例:

10.0.zero?            #=> false
0.zero?               #=> true
0.0.zero?             #=> true

定数

DIG -> Fixnum[permalink][rdoc]

Float が表現できる最大の 10 進桁数

EPSILON -> Float[permalink][rdoc]

1.0 + Float::EPSILON != 1.0 となる最小の値

MANT_DIG -> Fixnum[permalink][rdoc]

仮数部の Float::RADIX 進法での桁数

MAX -> Float[permalink][rdoc]

Float が取り得る最大値

MAX_10_EXP -> Fixnum[permalink][rdoc]

最大の 10 進の指数

MAX_EXP -> Fixnum[permalink][rdoc]

最大の Float::RADIX 進の指数

MIN -> Float[permalink][rdoc]

Float が取り得る最小値

MIN_10_EXP -> Fixnum[permalink][rdoc]

最小の 10 進の指数

MIN_EXP -> Fixnum[permalink][rdoc]

最小の Float::RADIX 進の指数

RADIX -> Fixnum[permalink][rdoc]

指数表現の基数

ROUNDS -> Fixnum[permalink][rdoc]

丸めモード (-1: 不定、0: 0.0 の方向に丸め、1: 四捨五入、2:正の無限 大の方向に丸め、3:負の無限大の方向に丸め)