Ruby/Справочник/Bignum
Материал из Викиучебника
[править] Класс Bignum < Integer
Классу Bignum принадлежат целые числа, которые не умещаются в диапазон класса Fixnum. Объекты класса Bignum создаются автоматически, когда результат вычислений превышает (по модулю) предельное значение класса Fixnum. Когда, в результате вычислений, объект класса Bignum уменьшается настолько, что его значение можно хранить в объекте класса Fixnum, то он автоматически преобразуется в Fixnum. Для обеспечения работы побитовых операций и метода [], объект класса Bignum следует рассматривать как двоичную последовательность бесконечной длины. В отличие от Fixnum, объекты класса Bignum передаются не непосредственно, а по ссылке.
Методы объекта
[], %, &, **, *, +, -@, -, /, <<, <=>, ==, >>, ^, abs, coerce, divmod, div, eql?, hash, modulo, power!, quo, rdiv, remainder, rpower, size, to_f, to_s, ||, ~
[править] Bignum#%
big % other #-> numeric big.modulo(other) #-> numeric
Возвращает остаток от деления числа big на числоother.
1234567890 % 2 #-> 0 1234567890 % 1.2 #-> 4.56881898980299e-008 1234567890 % -2 #-> 0
 |
Полезно взглянуть в описание метода Numeric#divmod для получения более детальной информации |
|
Методы % и modulo — абсолютно идентичны, то есть являются именами одного и того же метода |
|
Полезно посмотреть на методы **, +, -, / и *, которые имеют схожую функциональность |
[править] Bignum#&
big & numeric #-> integer
Побитовое И.
[править] Bignum#*
big * other #-> numeric
Умножает число big на число other и возвращает результат.
1234567890 * 2 #-> 2469135780 1234567890 * 1.2 #-> 1481481468.0 1234567890 * -2 #-> -2469135780
|
Полезно посмотреть на методы **, +, -, / и %, которые имеют схожую функциональность |
[править] Bignum#**
big ** other #-> numeric big.rpower(other) #-> numeric
Возводит число big в степень other (которая может быть целым, дробным или любым другим числом). Результат может быть класса Fixnum, Bignum или Float.
123456789 ** 2 #-> 15241578750190521 123456789 ** 1.2 #-> 5126464716.09932 123456789 ** -2 #-> 6.5610001194102e-17
|
Полезно посмотреть на методы *, +, -, /, % и power!, которые имеют схожую функциональность |
|
Методы ** и rpower — абсолютно идентичны, то есть являются именами одного и того же метода |
[править] Bignum#+
big + other #-> numeric
Складывает число big с числом other и возвращает результат.
1234567890 + 2 #-> 1234567892 1234567890 + 1.2 #-> 1234567891.2 1234567890 + (-2) #-> 1234567888
|
Полезно посмотреть на методы **, *, -, / и %, которые имеют схожую функциональность |
[править] Bignum#-
big - other #-> numeric
Вычитает из числа big число other и возвращает результат.
1234567890 - 2 #-> 1234567888 1234567890 - 1.2 #-> 1234567888.8 1234567890 - (-2) #-> 1234567892
|
Полезно посмотреть на методы **, +, *, / и %, которые имеют схожую функциональность |
[править] Bignum#-@
-big #-> other_big
Унарный минус (возвращает новый объект класса Bignum, значение которого равно 0-big)
[править] Bignum#/
big / other #-> numeric big.div(other) #-> numeric
Делит число big на число other и возвращает результат.
1234567890 / 2 #-> 617283945 1234567890 / 1.2 #-> 1028806575.0 1234567890 / (-2) #-> -617283945
|
Полезно посмотреть на методы **, *, -, +, % и quo, которые имеют схожую функциональность |
|
Методы / и div — абсолютно идентичны, то есть являются именами одного и того же метода |
[править] Bignum#<<
big << numeric #-> integer
Побитовый сдвиг числа big влево на numeric позиций (вправо, если numeric меньше нуля).
|
Полезно посмотреть на метод >>, который имеет схожую функциональность |
[править] Bignum#<=>
big <=> numeric #-> -1, 0, +1
Сравнение -- возвращает -1, 0 или +1, если значение числа big меньше, равно или больше значения числа numeric, соотвественно. Это базис для тестов в примеси Comparable.
[править] Bignum#==
big == obj #-> true или false
Возвращает true, если число obj имеет такое же значение, что и число big. В отличие от метода eql?, приводит число obj к классу Bignum.
68719476736 == 68719476736.0 #-> true
[править] Bignum#>>
big >> numeric #-> integer
Побитовый сдвиг числа big вправо на numeric позиций (влево, если numeric меньше нуля).
|
Полезно посмотреть на метод <<, который имеет схожую функциональность |
[править] Bignum#[]
big[n] #-> 0, 1
Побитовый доступ -- возвращает nый бит (виртуальный) двоичного представления числа big, где big[0] -- младший значащий бит.
a = 9**15 50.downto(0) do |n| print a[n] end
результат:
000101110110100000111000011110010100111100010111001
[править] Bignum#^
big ^ numeric #-> integer
Побитовое ИСКЛЮЧАЮЩЕЕ ИЛИ
[править] Bignum#abs
big.abs #-> bignum
Возвращает абсолютное значение числа big.
-1234567890987654321.abs #-> 1234567890987654321
[править] Bignum#coerce
big.coerce(other) #-> array
Возвращает массив, состоящий из чисел other и big, которые преобразованы к классу Bignum.
result = 1234567890.coerce( 1234 ) #-> [1234, 1234567890] result[0] #-> 1234 result[0].class #-> Bignum
[править] Bignum#div
big / other #-> numeric big.div(other) #-> numeric
Делит число big на число other и возвращает результат.
1234567890 / 2 #-> 617283945 1234567890 / 1.2 #-> 1028806575.0 1234567890 / (-2) #-> -617283945
|
Полезно посмотреть на методы **, *, -, +, % и quo, которые имеют схожую функциональность |
|
Методы / и div — абсолютно идентичны, то есть являются именами одного и того же метода |
[править] Bignum#divmod
big.divmod(numeric) #-> array
|
Полезно взглянуть в описание метода Numeric#divmod для получения более детальной информации |
[править] Bignum#eql?
big.eql?(obj) #-> true или false
Возвращает true, если число obj имеет такое же значение, что и число big. В отличие от метода ==, не занимается приведением типов.
68719476736.eql?(68719476736.0) #-> false
[править] Bignum#hash
big.hash #-> fixnum
Вычисляет контрольную сумму на основе значения числа big.
[править] Bignum#modulo
big % other #-> numeric big.modulo(other) #-> numeric
Возвращает остаток от деления числа big на числоother.
|
Полезно взглянуть в описание метода Numeric#divmod для получения более детальной информации |
|
Методы % и modulo — абсолютно идентичны, то есть являются именами одного и того же метода |
|
Полезно посмотреть на методы **, +, -, / и *, которые имеют схожую функциональность |
[править] Bignum#power!
big.power!(other) #-> numeric
Производит возведение числа fix в степень other.
1234567890.power!( 2 ) #-> 1524157875019052100 1234567890.power!( -2 ) #-> 6.5610001194102e-019
|
Полезно посмотреть на методы ** и rpower, которые имеют схожую функциональность |
[править] Bignum#quo
big.quo(other) #-> numeric big.rdiv(other) #-> numeric
Делит число big на число other и в качестве результата возвращает рациональное число.
1234567890.quo(7) #-> Rational(1234567890, 7)
|
Полезно посмотреть на методы / и div, которые имеют схожую функциональность |
|
Методы quo и rdiv — абсолютно идентичны, то есть являются именами одного и того же метода |
[править] Bignum#rdiv
big.quo(other) #-> numeric big.rdiv(other) #-> numeric
Делит число big на число other и в качестве результата возвращает рациональное число.
1234567890.rdiv(7) #-> Rational(1234567890, 7)
|
Полезно посмотреть на методы / и div, которые имеют схожую функциональность |
|
Методы quo и rdiv — абсолютно идентичны, то есть являются именами одного и того же метода |
[править] Bignum#remainder
big.remainder(numeric) #-> number
Возвращает остаток от деления числа big на число numeric.
-1234567890987654321.remainder(13731) #-> -6966 -1234567890987654321.remainder(13731.24) #-> -9906.22531493148
|
Полезно посмотреть на методы quo, rdiv, % и modulo, которые имеют схожую функциональность |
[править] Bignum#rpower
big ** other #-> numeric big.rpower(other) #-> numeric
Производит возведение числа big в степень other. Возвращает рациональное число, если результат рациональный (то есть, когда other < 0).
1234567890.power!( 2 ) #-> 1524157875019052100 1234567890.power!( -2 ) #-> Rational(1, 1524157875019052100)
|
Методы ** и rpower — абсолютно идентичны, то есть являются именами одного и того же метода |
|
Полезно посмотреть на метод power!, который имеет схожую функциональность |
[править] Bignum#size
big.size #-> integer
Возвращает количество байт машинного представления числа big.
(256**10 - 1).size #-> 12 (256**20 - 1).size #-> 20 (256**40 - 1).size #-> 40
[править] Bignum#to_f
big.to_f #-> float
Преобразует число big в число класса Float. Если число big не может быть преобразовано к классу Float, то возвращает бесконечность.
|
Полезно посмотреть на метод to_s, который имеет схожую функциональность |
[править] Bignum#to_s
big.to_s(base=10) #-> string
Возвращает строку, где число big имеет основание системы счисления равное base (между 2 и 36). По умолчанию base=10 (то есть десятичная система счисления).
12345654321.to_s #-> "12345654321" 12345654321.to_s(2) #-> "1011011111110110111011110000110001" 12345654321.to_s(8) #-> "133766736061" 12345654321.to_s(16) #-> "2dfdbbc31" 78546939656932.to_s(36) #-> "rubyrules"
|
Полезно посмотреть на метод to_f, который имеет схожую функциональность |
[править] Bignum#|
big | numeric #-> integer
Побитовое ИЛИ.
[править] Bignum#~
~big #-> integer
Побитовое НЕ. Так как Bignum теоретически имеет бесконечную длину, то для вычисления результата берется число big на один бит длиннее старшего значащего бита (чтобы операция инверсии была обратимой).
sprintf("%X", ~0x499602d2) #-> "-499602d3" ~~1234567890 #-> 1234567890
