Spec-Zone.ru › Ruby 3.4

класс NilClass

Родительский класс:
Object

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

Некоторые его методы действуют как операторы:

  • &

  • |

  • ===

  • =~

  • ^

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

  • rationalize

  • to_a

  • to_c

  • to_h

  • to_r

  • to_s

Хотя у nil нет явно определённого метода to_hash, его можно использовать при распаковке **, не добавляя аргументов-ключевых слов.

Ещё один метод предоставляет представление объекта:

  • 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 or false Показать исходный код
false === other → true or false
nil === other → true or 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 or false Показать исходный код
nil ^ object → true or false
#define false_xor true_and

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

nil ^ nil        # => false
nil ^ false      # => false
nil ^ Object.new # => true
false | object → true or false Показать исходный код
nil | object → true or false
#define false_or 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);
}

Возвращает ноль в виде Rational:

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));
}

Возвращает ноль в виде Complex:

nil.to_c # => (0+0i)
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));
}

Возвращает ноль в виде Rational:

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

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

nil.to_s # => ""

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

Spec-Zone.ru

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