Spec-Zone.ru › Ruby 3.3

класс NilClass

Родитель:
Объект

Класс единственного объекта nil.

Несколько его методов работают как операторы:

  • &

  • |

  • ===

  • =~

  • ^

Другие действуют как преобразователи, перенося концепцию нулевости в другие классы:

  • rationalize

  • to_a

  • to_c

  • to_h

  • to_r

  • to_s

Другой метод обеспечивает инспекцию:

  • inspect

Наконец, есть этот метод запроса:

  • nil?

Методы публичного экземпляра

false & object → false Показать исходный код
nil & object → false
static VALUE
false_and(VALUE obj, VALUE obj2)
{
    return Qfalse;
}

Возвращает false:

false & true       # => false
false & Object.new # => false

Аргумент object оценивается:

false & raise # Raises RuntimeError.
true === other → true или false Показать исходный код
false === other → true или false
nil === other → true или false
#define case_equal rb_equal

Возвращает true или false.

Как Object#==, если object является экземпляром Object (а не экземпляром одного из его многочисленных подклассов).

Этот метод обычно переопределяется этими подклассами, чтобы предоставить осмысленную семантику в операциях case.

nil =~ object → nil Показать исходный код
static VALUE
nil_match(VALUE obj1, VALUE obj2)
{
    return Qnil;
}

Возвращает nil.

Этот метод делает полезным писать:

while gets =~ /re/
  # ...
end
false ^ object → true или false Показать исходный код
nil ^ object → true или false
#define false_xor true_and

Возвращает false если object является nil или false, true в противном случае:

nil ^ nil        # => false
nil ^ false      # => false
nil ^ Object.new # => true
inspect → 'nil' Показать исходный код
static VALUE
nil_inspect(VALUE obj)
{
    return rb_usascii_str_new2("nil");
}

Возвращает строку 'nil':

nil.inspect # => "nil"
nil? → true Показать исходный код
static VALUE
rb_true(VALUE obj)
{
    return Qtrue;
}

Возвращает true. Для всех других объектов метод nil? возвращает false.

rationalize(eps = nil) → (0/1) Показать исходный код
static VALUE
nilclass_rationalize(int argc, VALUE *argv, VALUE self)
{
    rb_check_arity(argc, 0, 1);
    return nilclass_to_r(self);
}

Возвращает ноль как рациональное число:

nil.rationalize # => (0/1)

Аргумент eps игнорируется.

to_a → [] Показать исходный код
static VALUE
nil_to_a(VALUE obj)
{
    return rb_ary_new2(0);
}

Возвращает пустой Array.

nil.to_a # => []
to_c → (0+0i) Показать исходный код
static VALUE
nilclass_to_c(VALUE self)
{
    return rb_complex_new1(INT2FIX(0));
}

Возвращает ноль как комплексное число:

nil.to_c # => (0+0i)
to_d → bigdecimal Показать исходный код
# File ext/bigdecimal/lib/bigdecimal/util.rb, line 182
def to_d
  BigDecimal(0)
end

Возвращает nil, представленный как BigDecimal.

require 'bigdecimal'
require 'bigdecimal/util'

nil.to_d   # => 0.0
to_f → 0.0 Показать исходный код
# File nilclass.rb, line 22
def to_f
  return 0.0
end

Всегда возвращает ноль.

nil.to_f   #=> 0.0
to_h → {} Показать исходный код
static VALUE
nil_to_h(VALUE obj)
{
    return rb_hash_new();
}

Возвращает пустой Hash.

nil.to_h   #=> {}
to_i → 0 Показать исходный код
# File nilclass.rb, line 10
def to_i
  return 0
end

Всегда возвращает ноль.

nil.to_i   #=> 0
to_r → (0/1) Показать исходный код
static VALUE
nilclass_to_r(VALUE self)
{
    return rb_rational_new1(INT2FIX(0));
}

Возвращает ноль как рациональное число:

nil.to_r # => (0/1)
to_s → '' Показать исходный код
VALUE
rb_nil_to_s(VALUE obj)
{
    return rb_cNilClass_to_s;
}

Возвращает пустую строку:

nil.to_s # => ""
false | object → true или false Показать исходный код
nil | object → true или false
#define false_or true_and

Возвращает false если object является nil или false, true в противном случае:

nil | nil        # => false
nil | false      # => false
nil | Object.new # => true

Ruby Core © 1993–2022 Yukihiro Matsumoto
Licensed under the Ruby License.
Ruby Standard Library © contributors
Licensed under their own licenses.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API