org.jruby.specialized

Class RubyArraySpecialized

java.lang.Object

org.jruby.RubyBasicObject

org.jruby.RubyObject

org.jruby.RubyArray

org.jruby.specialized.RubyArraySpecialized

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, java.lang.Comparable<IRubyObject>, java.lang.Iterable, java.util.Collection, java.util.List, java.util.RandomAccess, InstanceVariables, InternalVariables, IRubyObject, CoreObjectType

Direct Known Subclasses:

RubyArrayOneObject, RubyArrayTwoObject

public abstract class RubyArraySpecialized
extends RubyArray

This is the base class for all specialized RubyArray. Specialized RubyArray use fields rather than an IRubyObject[] to hold their values. When they need to grow or shrink, they unpack those values to a proper IRubyObject[] and fall back on RubyArray logic. Subclasses should override all methods that would access the array directly to use the fields, with guards for the packed flag and access outside packed range. This includes the following methods (at the time of this writing...this list will evolve): RubyArrayRubyArray.eltInternal(int) RubyArrayRubyArray.eltInternalSet(int index, IRubyObject value) RubyArraySpecializedfinishUnpack(IRubyObject nil) RubyArrayRubyArray.aryDup() RubyArrayRubyArray.rb_clear() RubyArrayRubyArray.collect(org.jruby.runtime.ThreadContext, org.jruby.runtime.Block) RubyArrayRubyArray.copyInto(IRubyObject[], int) RubyArrayRubyArray.copyInto(IRubyObject[], int, int) RubyArrayRubyArray.dup() RubyArrayRubyArray.includes(org.jruby.runtime.ThreadContext, IRubyObject) RubyArrayRubyArray.indexOf(Object) RubyArrayRubyArray.inspectAry(org.jruby.runtime.ThreadContext) RubyArrayRubyArray.internalRotate(org.jruby.runtime.ThreadContext, int) RubyArrayRubyArray.internalRotateBang(org.jruby.runtime.ThreadContext, int) RubyArrayRubyArray.op_plus(IRubyObject) RubyArrayRubyArray.reverse_bang() RubyArrayRubyArray.safeReverse() RubyArrayRubyArray.sortInternal(org.jruby.runtime.ThreadContext, org.jruby.runtime.Block) RubyArrayRubyArray.sortInternal(org.jruby.runtime.ThreadContext, boolean) RubyArrayRubyArray.store(long, IRubyObject) RubyArrayRubyArray.subseq(RubyClass, long, long, boolean) RubyArrayRubyArray.toJavaArray() RubyArrayRubyArray.uniq(org.jruby.runtime.ThreadContext)

See Also:

Serialized Form

Nested Class Summary

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

RubyArray.ArgumentVisitor, RubyArray.DefaultComparator, RubyArray.RubyArrayConversionIterator

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 and Description
static int	MAX_PACKED_SIZE

Fields inherited from class org.jruby.RubyArray

ARRAY_DEFAULT_SIZE, begin, DEFAULT_INSPECT_STR_SIZE, realLength, values

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 and Description
RubyArraySpecialized(Ruby runtime, boolean light)
RubyArraySpecialized(RubyClass otherClass, boolean light)

Method Summary

Modifier and Type	Method and Description
protected abstract void	finishUnpack(IRubyObject nil)
protected boolean	packed()
protected void	unpack() Overridden by specialized arrays to fall back to IRubyObject[].

Methods inherited from class org.jruby.RubyArray

add, add, addAll, addAll, all_p, any_p, append, aref, aref, aref, aref19, aref19, aryAppend, aryDup, aryDup19, aryToAry, aryToAry, aset, aset, aset, aset19, aset19, assoc, at, bsearch_index, bsearch, checkArrayType, checkLength, choice, clear, collect_bang, collect, collect19, collectBang, combination, compact_bang, compact, compact19, compare, compareFixnums, compareOthers, compatc19, concat, concat, concat, concat19, concurrentModification, contains, containsAll, convertToArray, copyInto, copyInto, count, count, create, createArrayClass, cycle, cycle, delete_at, delete_at, delete_if, delete, deleteIf, detectCommon, dig, drop_while, drop, dup, each_index, each_slice, each, eachIndex, eachSlice, eltInternal, eltInternalSet, eltOk, eltSetOk, eltSetOk, empty_p, ensureCapacity, entry, entry, enumLengthFn, eql, equals, fetch, fetch, fetch, fill, fill, fill, fill, fillCommon, fillCommon, find_index, find_index, find, first, first, first, flatten_bang, flatten_bang, flatten_bang19, flatten_bang19, flatten, flatten, flatten, flatten19, flatten19, frozen_p, get, getJavaClass, getLength, getList, getNativeClassIndex, hash, hash, hash19, include_p, includes, index, index, index, indexes, indexOf, initialize_copy, initialize, initialize, initialize, initialize, initializeCommon, insert, insert, insert, insert, insert19, insert19, insert19, inspect, inspectAry, internalRotate, internalRotateBang, isEmpty, iterator, join, join, join19, join19, joinStrings, keep_if, last, last, last, lastIndexOf, length, listIterator, listIterator, map_bang, map19, marshalTo, max, max, min, min, modify, modifyCheck, newArray, newArray, newArray, newArray, newArray, newArray, newArray, newArray, newArray, newArray, newArrayLight, newArrayLight, newArrayLight, newArrayLight, newArrayLight, newArrayLight, newArrayMayCopy, newArrayMayCopy, newArrayMayCopy, newArrayNoCopy, newArrayNoCopy, newArrayNoCopy, newArrayNoCopyLight, newBlankArray, newEmptyArray, nitems, op_and, op_cmp, op_diff, op_equal, op_or, op_plus, op_times, op_times19, pack, pack, permutation, permutation, pop, pop, product, product, product19, push_m, push_m19, push, push, rassoc, rb_clear, reject_bang, reject, rejectBang, rejectCommon, remove, remove, removeAll, repeated_permutation, repeatedCombination, replace, retainAll, reverse_bang, reverse_each, reverse, reverseEach, rindex, rindex, rindex, rotate_bang, rotate_bang, rotate, rotate, safeReverse, sample, select_bang, select, selectCommon, set, shift, shift, shuffle_bang, shuffle_bang, shuffle, shuffle, size, slice_bang, slice_bang, slice_bang, sort_bang, sort_bang19, sort_by_bang, sort, sort19, sortInternal, sortInternal, store, subList, subseq, subseq, subseqLight, sum, sum, sumCommon, take_while, take, to_a, to_ary, to_h, to_s, toArray, toArray, toJava, toJavaArray, toJavaArrayMaybeUnsafe, toJavaArrayUnsafe, transpose, try_convert, uniq_bang, uniq_bang19, uniq, uniq19, unmarshalFrom, unshift, unshift, unshift, unshift19, unshift19, unshift19, values_at, zip

Methods inherited from class org.jruby.RubyObject

attachToObjectSpace, callInit, callInit, callInit, callInit, callInit, callInit, callInit, callInit, callInit, callInit, convertToType, createObjectClass, dig, eqlInternal, equalInternal, hashCode, 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, checkCallMethod, checkCallMethod, checkFrozen, checkStringType, checkStringType19, compareTo, convertToFloat, convertToHash, convertToInteger, convertToInteger, convertToInteger, convertToString, copyInstanceVariablesInto, copySpecialInstanceVariables, createBasicObjectClass, dataGetStruct, dataGetStructChecked, dataWrapStruct, decode, display, ensureInstanceVariablesSettable, eql_p, eql, equal_p, equal_p19, evalUnder, extend, fastGetInstanceVariable, fastGetInternalVariable, fastHasInstanceVariable, fastHasInternalVariable, fastSetInstanceVariable, fastSetInternalVariable, freeze, getFFIHandle, getFlag, getInstanceEvalClass, getInstanceVariable, getInstanceVariableList, getInstanceVariableNameList, getInstanceVariables, getInternalVariable, getInternalVariables, getMetaClass, getMetaClass, getNativeHandle, getNativeTypeIndex, getObjectId, getRuntime, getSingletonClass, getSingletonClassClone, getSingletonClassCloneAndAttach, getType, getVariable, getVariableCount, getVariableList, getVariableNameList, hashyInspect, hasInstanceVariable, hasInternalVariable, hasVariables, id, infectBy, initialize, 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, isImmediate, isModule, isNil, isSpecialConst, isSpecialObject, isTaint, isTrue, isUntrusted, kind_of_p, makeMetaClass, method_missing, method_missing19, method, method19, methods, methods, methods19, nil_p, nonFixnumHashCode, OBJ_INIT_COPY, objInitCopy, op_equal_19, op_match, op_match19, op_not_equal, op_not_match, op_not, private_methods, private_methods19, protected_methods, protected_methods19, public_methods, public_methods19, rbClone, rbClone, rbInspect, remove_instance_variable, removeFinalizers, removeInstanceVariable, removeInternalVariable, 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_added, singleton_method_added19, singleton_method_removed, singleton_method_removed19, singleton_method_undefined, singleton_method_undefined19, singleton_method, singleton_methods, specificEval, specificEval, specificEval, specificEval, syncVariables, syncVariables, taint, taint, tainted_p, testFrozen, testFrozen, trust, type_deprecated, type, 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

Methods inherited from interface java.util.List

hashCode, replaceAll, sort, spliterator

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream

Methods inherited from interface java.lang.Iterable

forEach

Field Detail

MAX_PACKED_SIZE

public static final int MAX_PACKED_SIZE

See Also:

Constant Field Values

Constructor Detail

RubyArraySpecialized

public RubyArraySpecialized(Ruby runtime,
                            boolean light)

RubyArraySpecialized

public RubyArraySpecialized(RubyClass otherClass,
                            boolean light)

Method Detail

unpack

protected final void unpack()

Description copied from class: RubyArray

Overridden by specialized arrays to fall back to IRubyObject[].

Overrides:

unpack in class RubyArray

finishUnpack

protected abstract void finishUnpack(IRubyObject nil)

packed

protected boolean packed()