Package org.jruby

Class RubyNil

java.lang.Object

org.jruby.RubyBasicObject

org.jruby.RubyObject

org.jruby.RubyNil

All Implemented Interfaces:

Serializable, Cloneable, Comparable<IRubyObject>, Constantizable, InstanceVariables, InternalVariables, IRubyObject, CoreObjectType

public class RubyNil
extends RubyObject
implements Constantizable

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.jruby.RubyObject

RubyObject.Data

Nested classes/interfaces inherited from class org.jruby.RubyBasicObject

RubyBasicObject.Finalizer

Field Summary

Fields

Modifier and Type	Field	Description
private final Object	constant
private final int	hashCode
private static final ByteList	nil
static final ObjectAllocator	NIL_ALLOCATOR	Deprecated.
(package private) static final byte[]	nilBytes

Fields inherited from class org.jruby.RubyObject

IVAR_INSPECTING_OBJECT_ALLOCATOR, OBJECT_ALLOCATOR, REIFYING_OBJECT_ALLOCATOR

Fields inherited from class org.jruby.RubyBasicObject

ALL_F, BASICOBJECT_ALLOCATOR, COMPARE_BY_IDENTITY_F, ERR_INSECURE_SET_INST_VAR, FALSE_F, FL_USHIFT, flags, FROZEN_F, IS_OVERLAID_F, metaClass, NEVER, NIL_F, REFINED_MODULE_F, STAMP_OFFSET, TAINTED_F, UNDEF, UNTRUST_F, USER0_F, USER1_F, USER2_F, USER3_F, USER4_F, USER5_F, USER6_F, USER7_F, USER8_F, USER9_F, USERA_F, VAR_TABLE_OFFSET, varTable, varTableStamp

Fields inherited from interface org.jruby.runtime.builtin.IRubyObject

NULL_ARRAY

Constructor Summary

Constructors

Constructor	Description
RubyNil(Ruby runtime)

Method Summary

Modifier and Type	Method	Description
Object	constant()
static RubyClass	createNilClass(Ruby runtime)
Class<?>	getJavaClass()	Will return the Java interface that most closely can represent this object, when working through Java integration translations.
ClassIndex	getNativeClassIndex()	This is overridden in the other concrete Java builtins to provide a fast way to determine what type they are.
RubyClass	getSingletonClass()	rb_singleton_class Note: this method is specialized for RubyFixnum, RubySymbol, RubyNil and RubyBoolean Will either return the existing singleton class for this object, or create a new one and return that.
RubyFixnum	hash(ThreadContext context)
int	hashCode()	This override does not do "checked" dispatch since Object usually has #hash defined.
RubyFixnum	id()	rb_obj_id Return the internal id of an object.
IRubyObject	inspect()	nil_inspect
(package private) static RubyString	inspect(Ruby runtime)
boolean	isImmediate()	Is object immediate (def: Fixnum, Symbol, true, false, nil?).
IRubyObject	nil_p()	Deprecated.
RubyBoolean	nil_p(ThreadContext context)	rb_false call_seq: nil.nil? => true .nil? => false Only the object nil responds true to nil?.
static RubyBoolean	op_and(ThreadContext context, IRubyObject recv, IRubyObject obj)	nil_and
IRubyObject	op_match(ThreadContext context, IRubyObject arg)	rb_obj_pattern_match call-seq: obj =~ other => nil Pattern Match---Overridden by descendents (notably Regexp and String) to provide meaningful pattern-match semantics.
static RubyBoolean	op_or(ThreadContext context, IRubyObject recv, IRubyObject obj)	nil_or
static RubyBoolean	op_xor(ThreadContext context, IRubyObject recv, IRubyObject obj)	nil_xor
static IRubyObject	rationalize(ThreadContext context, IRubyObject recv, IRubyObject[] args)	nilclass_rationalize
IRubyObject	taint(ThreadContext context)	rb_obj_taint call-seq: obj.taint -> obj Marks obj as tainted---if the $SAFE level is set appropriately, many method calls which might alter the running programs environment will refuse to accept tainted strings.
static RubyArray	to_a(ThreadContext context, IRubyObject recv)	nil_to_a
static IRubyObject	to_c(ThreadContext context, IRubyObject recv)	nilclass_to_c
static RubyFloat	to_f(ThreadContext context, IRubyObject recv)	nil_to_f
static RubyHash	to_h(ThreadContext context, IRubyObject recv)
static RubyFixnum	to_i(ThreadContext context, IRubyObject recv)	nil_to_i
static IRubyObject	to_r(ThreadContext context, IRubyObject recv)	nilclass_to_r
static RubyString	to_s(ThreadContext context, IRubyObject recv)	nil_to_s
<T> T	toJava(Class<T> target)	Convert the object to the specified Java class, if possible.

Methods inherited from class org.jruby.RubyObject

attachToObjectSpace, callInit, callInit, callInit, callInit, callInit, callInit, callInit, callInit, callInit, callInit, convertToType, createObjectClass, dig, dig1, dig2, eqlInternal, equalInternal, equals, inspect, op_eqq, puts, specificEval, toRubyString, toString

Methods inherited from class org.jruby.RubyBasicObject

addFinalizer, anyToString, asJavaString, asString, callMethod, callMethod, callMethod, callMethod, callMethod, callMethod, callMethod, callMethod, callMethod, callSuper, checkArrayType, checkCallMethod, checkCallMethod, checkFrozen, checkStringType, checkStringType19, compareTo, convertToArray, convertToFloat, convertToHash, convertToInteger, convertToInteger, convertToInteger, convertToString, copyInstanceVariablesInto, copySpecialInstanceVariables, createBasicObjectClass, dataGetStruct, dataGetStructChecked, dataWrapStruct, decode, defaultToJava, display, dup, ensureInstanceVariablesSettable, eql, eql_p, equal_p, equal_p19, evalUnder, extend, fastGetInstanceVariable, fastGetInternalVariable, fastHasInstanceVariable, fastHasInternalVariable, fastSetInstanceVariable, fastSetInternalVariable, freeze, frozen_p, getFFIHandle, getFlag, getInstanceEvalClass, getInstanceVariable, getInstanceVariableList, getInstanceVariableNameList, getInstanceVariables, getInternalVariable, getInternalVariables, getMetaClass, getMetaClass, getNativeHandle, getNativeTypeIndex, getObjectId, getRuntime, getSingletonClassClone, getSingletonClassCloneAndAttach, getType, getVariable, getVariableCount, getVariableList, getVariableNameList, hash, hashyInspect, hasInstanceVariable, hasInstanceVariables, hasInternalVariable, hasVariables, infectBy, infectBy, infectBy, initialize, initialize_copy, initialize19, inspectHashCode, instance_eval, instance_eval, instance_eval, instance_eval, instance_eval19, instance_eval19, instance_eval19, instance_eval19, instance_exec, instance_exec19, instance_of_p, instance_variable_defined_p, instance_variable_get, instance_variable_set, instance_variables, instance_variables19, isBuiltin, isClass, isFalse, isFrozen, isModule, isNil, isSpecialConst, isSpecialObject, isTaint, isTrue, isUntrusted, kind_of_p, makeMetaClass, method, method_missing, method_missing19, method19, methods, methods, methods19, methodsImpl, nonFixnumHashCode, OBJ_INIT_COPY, objInitCopy, op_cmp, op_equal, op_equal_19, op_match19, op_not, op_not_equal, op_not_match, private_methods, private_methods19, protected_methods, protected_methods19, public_methods, public_methods19, rbClone, rbClone, rbInspect, recacheBuiltinMethods, remove_instance_variable, removeFinalizers, removeInstanceVariable, removeInternalVariable, respond_to_p, respond_to_p, respond_to_p, respond_to_p19, respond_to_p19, respondsTo, respondsToMissing, respondsToMissing, send, send, send, send, send, send19, send19, send19, send19, setFFIHandle, setFlag, setFrozen, setInstanceVariable, setInternalVariable, setMetaClass, setNativeHandle, setTaint, setUntrusted, setVariable, singleton_method, singleton_method_added, singleton_method_added19, singleton_method_removed, singleton_method_removed19, singleton_method_undefined, singleton_method_undefined19, singleton_methods, specificEval, specificEval, specificEval, specificEval, syncVariables, syncVariables, taint, tainted, tainted_p, testFrozen, testFrozen, to_a, to_a, to_s, trust, type, type_deprecated, untaint, untrust, untrusted_p, validateInstanceVariable, validateInstanceVariable, validateInstanceVariable, variableTableContains, variableTableFastContains, variableTableFastFetch, variableTableFastStore, variableTableFetch, variableTableRemove, variableTableStore, variableTableSync, yieldUnder, yieldUnder

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Details

hashCode

private final int hashCode

constant

private final transient Object constant

nilBytes

static final byte[] nilBytes

nil

private static final ByteList nil

NIL_ALLOCATOR

@Deprecated
public static final ObjectAllocator NIL_ALLOCATOR

Deprecated.

Constructor Details

RubyNil

public RubyNil(Ruby runtime)

Method Details

createNilClass

public static RubyClass createNilClass(Ruby runtime)

getNativeClassIndex

public ClassIndex getNativeClassIndex()

Description copied from class: RubyObject

This is overridden in the other concrete Java builtins to provide a fast way to determine what type they are. Will generally return a value from org.jruby.runtime.ClassIndex

Specified by:

getNativeClassIndex in interface CoreObjectType

Overrides:

getNativeClassIndex in class RubyObject

See Also:

• ClassIndex

isImmediate

public boolean isImmediate()

Description copied from class: RubyBasicObject

Is object immediate (def: Fixnum, Symbol, true, false, nil?).

Specified by:

isImmediate in interface IRubyObject

Overrides:

isImmediate in class RubyBasicObject

Returns:

getSingletonClass

public RubyClass getSingletonClass()

Description copied from class: RubyBasicObject

rb_singleton_class Note: this method is specialized for RubyFixnum, RubySymbol, RubyNil and RubyBoolean Will either return the existing singleton class for this object, or create a new one and return that.

Specified by:

getSingletonClass in interface IRubyObject

Overrides:

getSingletonClass in class RubyBasicObject

Returns:

the Ruby singleton class

getJavaClass

public Class<?> getJavaClass()

Description copied from class: RubyBasicObject

Will return the Java interface that most closely can represent this object, when working through Java integration translations.

Specified by:

getJavaClass in interface IRubyObject

Overrides:

getJavaClass in class RubyBasicObject

Returns:

the true Java class of this (Ruby) object

constant

public Object constant()

Specified by:

constant in interface Constantizable

See Also:

• Constantizable

to_i

public static RubyFixnum to_i(ThreadContext context,
 IRubyObject recv)

nil_to_i

to_f

public static RubyFloat to_f(ThreadContext context,
 IRubyObject recv)

nil_to_f

to_s

public static RubyString to_s(ThreadContext context,
 IRubyObject recv)

nil_to_s

to_a

public static RubyArray to_a(ThreadContext context,
 IRubyObject recv)

nil_to_a

to_h

public static RubyHash to_h(ThreadContext context,
 IRubyObject recv)

inspect

public IRubyObject inspect()

nil_inspect

Specified by:

inspect in interface IRubyObject

Overrides:

inspect in class RubyBasicObject

Returns:

String

inspect

static RubyString inspect(Ruby runtime)

op_match

public IRubyObject op_match(ThreadContext context,
 IRubyObject arg)

Description copied from class: RubyBasicObject

rb_obj_pattern_match call-seq: obj =~ other => nil Pattern Match---Overridden by descendents (notably Regexp and String) to provide meaningful pattern-match semantics.

Overrides:

op_match in class RubyBasicObject

op_and

public static RubyBoolean op_and(ThreadContext context,
 IRubyObject recv,
 IRubyObject obj)

nil_and

op_or

public static RubyBoolean op_or(ThreadContext context,
 IRubyObject recv,
 IRubyObject obj)

nil_or

op_xor

public static RubyBoolean op_xor(ThreadContext context,
 IRubyObject recv,
 IRubyObject obj)

nil_xor

nil_p

public RubyBoolean nil_p(ThreadContext context)

Description copied from class: RubyBasicObject

rb_false call_seq: nil.nil? => true .nil? => false Only the object nil responds true to nil?.

Overrides:

nil_p in class RubyBasicObject

nil_p

@Deprecated
public IRubyObject nil_p()

Deprecated.

hash

public RubyFixnum hash(ThreadContext context)

hashCode

public int hashCode()

Description copied from class: RubyObject

This override does not do "checked" dispatch since Object usually has #hash defined.

Overrides:

hashCode in class RubyObject

See Also:

• RubyBasicObject.hashCode()

id

public RubyFixnum id()

Description copied from class: RubyBasicObject

rb_obj_id Return the internal id of an object.

Specified by:

id in interface IRubyObject

Overrides:

id in class RubyBasicObject

Returns:

the object id

taint

public IRubyObject taint(ThreadContext context)

Description copied from class: RubyBasicObject

rb_obj_taint call-seq: obj.taint -> obj Marks obj as tainted---if the $SAFE level is set appropriately, many method calls which might alter the running programs environment will refuse to accept tainted strings.

Overrides:

taint in class RubyBasicObject

to_c

public static IRubyObject to_c(ThreadContext context,
 IRubyObject recv)

nilclass_to_c

to_r

public static IRubyObject to_r(ThreadContext context,
 IRubyObject recv)

nilclass_to_r

rationalize

public static IRubyObject rationalize(ThreadContext context,
 IRubyObject recv,
 IRubyObject[] args)

nilclass_rationalize

toJava

public <T> T toJava(Class<T> target)

Description copied from interface: IRubyObject

Convert the object to the specified Java class, if possible.

Specified by:

toJava in interface IRubyObject

Overrides:

toJava in class RubyBasicObject

Parameters:

target - The target type to which the object should be converted.

See Also:

• IRubyObject.toJava(java.lang.Class<T>)