Spec-Zone.ru › Ruby 4.0

класс 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) Показать исходный код
# File nilclass.rb, line 12
def rationalize(eps = nil)
  0r
end

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

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) Показать исходный код
# File nilclass.rb, line 24
def to_c
  0i
end

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

nil.to_c # => (0+0i)
to_f → 0.0 Показать исходный код
# File nilclass.rb, line 48
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 36
def to_i
  return 0
end

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

nil.to_i   #=> 0
to_r → (0/1) Показать исходный код
# File nilclass.rb, line 60
def to_r
  0r
end

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

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