Index: _builtin/Integer =================================================================== --- _builtin/Integer (revision 2510) +++ _builtin/Integer (working copy) @@ -40,15 +40,56 @@ --- +(other) -> Fixnum | Bignum | Float + +算術演算子。和を計算します。 + +これは、 [[c:Numeric]] で定義された同名のメソッドを上書きしたものです。 + +@param other 二項演算の右側の引数(対象) +@return 計算結果 + --- -(other) -> Fixnum | Bignum | Float + +算術演算子。差を計算します。 + +これは、 [[c:Numeric]] で定義された同名のメソッドを上書きしたものです。 + +@param other 二項演算の右側の引数(対象) +@return 計算結果 + --- *(other) -> Fixnum | Bignum | Float + +算術演算子。積を計算します。 + +これは、 [[c:Numeric]] で定義された同名のメソッドを上書きしたものです。 + +@param other 二項演算の右側の引数(対象) +@return 計算結果 + --- /(other) -> Fixnum | Bignum | Float + +算術演算子。商を計算します。 + +これは、 [[c:Numeric]] で定義された同名のメソッドを上書きしたものです。 + +@param other 二項演算の右側の引数(対象) +@return 計算結果 + --- %(other) -> Fixnum | Bignum | Float + +算術演算子。剰余を計算します。 + +これは、 [[c:Numeric]] で定義された同名のメソッドを上書きしたものです。 + +@param other 二項演算の右側の引数(対象) +@return 計算結果 + --- **(other) -> Fixnum | Bignum | Float -算術演算子。それぞれ和、差、積、商、剰余、冪(べき乗)を計算します。 -これらは、 [[c:Numeric]] で定義された同名のメソッドを上書きしたものです。 +算術演算子。冪(べき乗)を計算します。 +これは、 [[c:Numeric]] で定義された同名のメソッドを上書きしたものです。 + @param other 二項演算の右側の引数(対象) @return 計算結果 @@ -58,132 +99,167 @@ 等しい時に 0、小さい時に負の整数を返します。 @param other 比較対象の数値 -@return -1か0か1のいずれか +@return -1 か 0 か 1 のいずれか 1 <=> 2 #=> -1 1 <=> 1 #=> 0 2 <=> 1 #=> 1 --- ==(other) -> bool + +比較演算子。数値として等しいか判定します。 + +@param other 比較対象の数値 +@return self と other が等しい場合 true を返します。 + そうでなければ false を返します。 + --- <(other) -> bool + +比較演算子。数値として小さいか判定します。 + +@param other 比較対象の数値 +@return self よりも other が大きい場合 true を返します。 + そうでなければ false を返します。 + --- <=(other) -> bool + +比較演算子。数値として等しいまたは小さいか判定します。 + +@param other 比較対象の数値 +@return self よりも other の方が大きい場合か、 + 両者が等しい場合 true を返します。 + そうでなければ false を返します。 + --- >(other) -> bool + +比較演算子。数値として大きいか判定します。 + +@param other 比較対象の数値 +@return self よりも other の方が小さい場合 true を返します。 + そうでなければ false を返します。 + --- >=(other) -> bool -比較演算子。それぞれ数値として等しいか、小さいか、 -等しいまたは小さいか、大きいか、等しいまたは大きいか判定します。 +比較演算子。数値として等しいまたは大きいか判定します。 + @param other 比較対象の数値 -@return bool +@return self よりも other の方が小さい場合か、 + 両者が等しい場合 true を返します。 + そうでなければ false を返します。 --- ~ -> Fixnum | Bignum ビット演算子。否定を計算します。 -@return 数値 + ~1 #=> -2 + ~3 #=> -4 + ~-4 #=> 3 --- |(other) -> Fixnum | Bignum ---- &(other) -> Fixnum | Bignum ---- ^(other) -> Fixnum | Bignum -ビット二項演算子。それぞれ論理和、論理積、排他的論理和を計算しま -す。 +ビット二項演算子。論理和を計算します。 @param other 数値 -@return 数値 1 | 1 #=> 1 2 | 3 #=> 3 +--- &(other) -> Fixnum | Bignum +ビット二項演算子。論理積を計算します。 + +@param other 数値 + + 1 & 1 #=> 1 + 2 & 3 #=> 2 + +--- ^(other) -> Fixnum | Bignum +ビット二項演算子。排他的論理和を計算します。 + +@param other 数値 + + 1 ^ 1 #=> 0 + 2 ^ 3 #=> 1 + --- <<(bits) -> Fixnum | Bignum + +シフト演算子。 bits だけビットを左にシフトします。 + +@param bits シフトさせるビット数 + + printf("%#b\n", 0b0101 << 1) #=> 0b1010 + p -1 << 1 #=> -2 + --- >>(bits) -> Fixnum | Bignum -シフト演算子。bits だけビットを右(左)にシフトします。 +シフト演算子。bits だけビットを右にシフトします。 右シフトは、符号ビット(最上位ビット(MSB))が保持されます。 bitsが実数の場合、小数点以下を切り捨てた値でシフトします。 -@param bits 数値 -@return 数値 +@param bits シフトさせるビット数 - printf("%#b\n", 0b0101 << 1) - printf("%#b\n", 0b0101 >> 1) - - => 0b1010 - 0b10 - - p -1 >> 1 - - => -1 + printf("%#b\n", 0b0101 >> 1) #=> 0b10 + p -1 >> 1 #=> -1 --- chr -> String -文字コードに対応する 1 バイトの文字列を返します。例えば -65.chr は "A" を返します。 +文字コードに対応する 1 バイトの文字列を返します。 +例えば65.chr は "A" を返します。 + 逆に文字列から文字コードを得るには "A"[0] とします -([[m:String#[] ]] を参照してください)。 -整数は 0 から 255 の範囲内でなければなりません。範囲外の整数に対す -る呼び出しは例外 [[c:RangeError]] を発生させます。 - @return 1バイト文字列 ---- downto(min) {|n| ... } -> Fixnum | Bignum +@raise RangeError self が 0 から 255 の範囲外の場合に発生します。 +@see [[m:String#[] ]] + +--- downto(min) {|n| ... } -> self + self から min まで 1 ずつ減らしながらブロックを繰り返し実行します。 self < min であれば何もしません。 -self を返します。 +@param min 数値 +@return self を返します。 -[[m:Integer#upto]], [[m:Integer#step]], [[m:Integer#times]] も参照。 +@see [[m:Integer#upto]],[[m:Integer#step]],[[m:Integer#times]] -@param min 数値 -@return 数値 - --- next -> Fixnum | Bignum --- succ -> Fixnum | Bignum -次の整数を返します。 +self の次の整数を返します。 -@return 数値 +--- step(limit, step) {|n| ... } -> self ---- step(limit, step) {|n| ... } -> Fixnum | Bignum - self からはじめ step を足しながら limit を越える 前までブロックを繰り返します。step は負の数も指定できます。 また、limit や step には [[c:Float]] なども指定できます。 -step に 0 を指定した場合は例外 [[c:ArgumentError]] が発生します。 - -self を返します。 - -[[m:Integer#upto]], [[m:Integer#downto]], [[m:Integer#times]] も参照。 - #@since 1.8.0 [[m:Numeric#step]] も参照。 #@end @param limit 数値 @param step 数値 -@return 数値 +@return self を返します。 +@raise ArgumentError step に 0 を指定した場合に発生します。 ---- times {|n| ... } -> Fixnum | Bignum +@see [[m:Integer#upto]],[[m:Integer#downto]],[[m:Integer#times]] +--- times {|n| ... } -> self + self 回だけ(0 から self-1 まで)繰り返します。 self が負であれば何もしません。 -self を返します。 +@return self を返します。 -[[m:Integer#upto]], [[m:Integer#downto]], [[m:Integer#step]] も参照。 - 3.times { puts "Hello, World!" } # Hello, World! と3行続いて表示される。 -@return 数値 +@see [[m:Integer#upto]], [[m:Integer#downto]], [[m:Integer#step]] ---- to_i -> Fixnum | Bignum ---- to_int -> Fixnum | Bignum +--- to_i -> self +--- to_int -> self self を返します。 -@return 数値 - --- size -> Fixnum 整数の実装上のサイズをバイト数で返します。 @@ -196,14 +272,10 @@ # => 4 8 -@return 数値 - --- to_f -> Float 値を浮動小数点数([[c:Float]])に変換します。 -@return 数値 - --- to_s -> String #@since 1.8.0 --- to_s(base) -> String @@ -213,8 +285,7 @@ #@since 1.8.0 引数を指定すれば、それを基数とした文字列表 -現に変換します。基数として 2 〜 36 以外を指定した場合は例外 -[[c:ArgumentError]] が発生します。 +現に変換します。 p 10.to_s(2) # => "1010" p 10.to_s(8) # => "12" @@ -224,7 +295,8 @@ @return 数値の文字列表現 #@since 1.8.0 -@param base 数値 +@param base 基数となる 2 - 36 の数値。 +@raise ArgumentError base に 2 - 36 以外の数値を指定した場合に発生します。 #@end --- upto(max) {|n| ... } -> Fixnum | Bignum @@ -232,9 +304,7 @@ self から max まで 1 ずつ増やしながら繰り返します。 self > max であれば何もしません。 -self を返します。 +@param max 数値 +@return self を返します。 -[[m:Integer#downto]], [[m:Integer#step]], [[m:Integer#times]] も参照。 - -@param max 数値 -@return 数値 +@see [[m:Integer#downto]], [[m:Integer#step]], [[m:Integer#times]]