123456789_123456789_123456789_123456789_123456789_

Class: NilClass

Relationships & Source Files
Inherits: Object
Defined in: object.c,
nilclass.rb,
object.c

Overview

The class of the singleton object nil.

Several of its methods act as operators:

Others act as converters, carrying the concept of nullity to other classes:

While nil doesn’t have an explicitly defined #to_hash method, it can be used in ** unpacking, not adding any keyword arguments.

Another method provides inspection:

Finally, there is this query method:

Instance Attribute Summary

Instance Method Summary

Instance Attribute Details

#nil? ⇒ Boolean (readonly)

Returns true. For all other objects, method nil? returns false.

[ GitHub ] 

  


# File 'object.c', line 1715



static VALUE
rb_true(VALUE obj)
{
    return Qtrue;
}


  







Instance Method Details



  

    

      #&(object)  ⇒ false 
      #&(object)  ⇒ false 
    

  



  

    

Returns false:



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



Argument object is evaluated:



false & raise # Raises RuntimeError.


  





  


  [ GitHub ]


  

  


# File 'object.c', line 1670



static VALUE
false_and(VALUE obj, VALUE obj2)
{
    return Qfalse;
}


  








  

    #===  
  

  [ GitHub ]






  

    #=~(object)  ⇒ nil   



  

    

Returns nil.



This method makes it useful to write:



while gets =~ /re/
  # ...
end


  



  [ GitHub ]


  

  


# File 'object.c', line 1525



static VALUE
nil_match(VALUE obj1, VALUE obj2)
{
    return Qnil;
}


  








  

    #^  
  

  [ GitHub ]






  

    #inspect  ⇒ 'nil'   



  

    

Returns string 'nil':



nil.inspect # => "nil"


  



  [ GitHub ]


  

  


# File 'object.c', line 1505



static VALUE
nil_inspect(VALUE obj)
{
    return rb_usascii_str_new2("nil");
}


  








  

    #rationalize(eps = nil)  ⇒ 1   



  

    

Returns zero as a ::Rational:



nil.rationalize # => (0/1)



Argument eps is ignored.


  



  [ GitHub ]


  

  


# File 'nilclass.rb', line 12



def rationalize(eps = nil)
  0r
end


  








  

    #to_a  ⇒ Array   



  

    

Returns an empty ::Array.



nil.to_a # => []


  



  [ GitHub ]


  

  


# File 'object.c', line 1471



static VALUE
nil_to_a(VALUE obj)
{
    return rb_ary_new2(0);
}


  








  

    #to_c  ⇒ (0+0i)   



  

    

Returns zero as a ::Complex:



nil.to_c # => (0+0i)


  



  [ GitHub ]


  

  


# File 'nilclass.rb', line 24



def to_c
  0i
end


  








  

    #to_f  ⇒ 0.0   



  

    

Always returns zero.



nil.to_f   #=> 0.0


  



  [ GitHub ]


  

  


# File 'nilclass.rb', line 48



def to_f
  return 0.0
end


  








  

    #to_h  ⇒ {}   



  

    

Returns an empty ::Hash.



nil.to_h   #=> {}


  



  [ GitHub ]


  

  


# File 'object.c', line 1489



static VALUE
nil_to_h(VALUE obj)
{
    return rb_hash_new();
}


  








  

    #to_i  ⇒ 0   



  

    

Always returns zero.



nil.to_i   #=> 0


  



  [ GitHub ]


  

  


# File 'nilclass.rb', line 36



def to_i
  return 0
end


  








  

    #to_r  ⇒ 1   



  

    

Returns zero as a ::Rational:



nil.to_r # => (0/1)


  



  [ GitHub ]


  

  


# File 'nilclass.rb', line 60



def to_r
  0r
end


  








  

    #to_s  ⇒ ''   



  

    

Returns an empty ::String:



nil.to_s # => ""


  



  [ GitHub ]


  

  


# File 'object.c', line 1453



VALUE
rb_nil_to_s(VALUE obj)
{
    return rb_cNilClass_to_s;
}


  








  

    #|  
  

  [ GitHub ]