Spec-Zone.ru › Ruby 3.4

класс NilClass

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

Класс единственного объекта 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 или 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
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
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_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 # => ""

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

Spec-Zone.ru

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