org.jruby

Class RubyMatchData

java.lang.Object

org.jruby.RubyBasicObject

org.jruby.RubyObject

org.jruby.RubyMatchData

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, java.lang.Comparable<IRubyObject>, InstanceVariables, InternalVariables, IRubyObject, CoreObjectType

public class RubyMatchData
extends RubyObject

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	RubyMatchData.Pair

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
(package private) int	begin
(package private) org.joni.Region	charOffsets
(package private) boolean	charOffsetUpdated
(package private) int	end
private static int	MATCH_BUSY
private static ObjectAllocator	MATCH_DATA_ALLOCATOR
(package private) org.joni.Regex	pattern
(package private) RubyRegexp	regexp
(package private) org.joni.Region	regs
(package private) RubyString	str

Fields inherited from class org.jruby.RubyObject

FIELD_ALLOCATED_CLASSES, FIELD_ALLOCATORS, IVAR_INSPECTING_OBJECT_ALLOCATOR, OBJECT_ALLOCATOR, OBJECT_VAR0_ALLOCATOR, OBJECT_VAR1_ALLOCATOR, OBJECT_VAR2_ALLOCATOR, OBJECT_VAR3_ALLOCATOR, OBJECT_VAR4_ALLOCATOR, OBJECT_VAR5_ALLOCATOR, OBJECT_VAR6_ALLOCATOR, OBJECT_VAR7_ALLOCATOR, OBJECT_VAR8_ALLOCATOR, OBJECT_VAR9_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, metaClass, NEVER, NIL_F, STAMP_OFFSET, TAINTED_F, UNDEF, UNTRUSTED_F, USER0_F, USER1_F, USER2_F, USER3_F, USER4_F, USER5_F, USER6_F, USER7_F, USER8_F, VAR_TABLE_OFFSET, varTable, varTableStamp

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

NULL_ARRAY

Constructor Summary

Constructors

Constructor and Description
RubyMatchData(Ruby runtime)
RubyMatchData(Ruby runtime, RubyClass metaClass)

Method Summary

Modifier and Type	Method and Description
int	backrefNumber(IRubyObject obj)
IRubyObject	begin(ThreadContext context, IRubyObject index) match_begin
IRubyObject	begin19(ThreadContext context, IRubyObject index)
private int	beginCommon(Ruby runtime, int i)
IRubyObject	captures(ThreadContext context) match_captures
(package private) void	check()
private void	checkLazyRegexp()
void	copySpecialInstanceVariables(IRubyObject clone) Lots of MRI objects keep their state in non-lookupable ivars (e:g.
static RubyClass	createMatchDataClass(Ruby runtime)
IRubyObject	end(ThreadContext context, IRubyObject index) match_end
IRubyObject	end19(ThreadContext context, IRubyObject index)
private int	endCommon(Ruby runtime, int i)
IRubyObject	eql_p(IRubyObject obj) rb_obj_equal Just like "==" and "equal?", "eql?" will use identity equality for Object.
boolean	equals(java.lang.Object other) This method is just a wrapper around the Ruby "==" method, provided so that RubyObjects can be used as keys in the Java HashMap object underlying RubyHash.
IRubyObject[]	getNamedBackrefValues(Ruby runtime)
int	getNativeTypeIndex() This is overridden in the other concrete Java builtins to provide a fast way to determine what type they are.
IRubyObject	group(int n)
IRubyObject	group(long n)
RubyFixnum	hash() rb_obj_id Will return the hash code of this object.
IRubyObject	initialize_copy(IRubyObject original) rb_obj_init_copy Initializes this object as a copy of the original, that is the parameter to this object.
IRubyObject	inspect() rb_obj_inspect call-seq: obj.inspect => string Returns a string containing a human-readable representation of obj.
private RubyString	makeShared(Ruby runtime, RubyString str, int begin, int length)
private RubyArray	match_array(Ruby runtime, int start)
IRubyObject	names(ThreadContext context, Block block)
private int	nameToBackrefNumber(RubyString str)
IRubyObject	offset(ThreadContext context, IRubyObject index) match_offset
IRubyObject	offset19(ThreadContext context, IRubyObject index)
private IRubyObject	offsetCommon(ThreadContext context, int i, boolean is_19)
IRubyObject	op_aref(IRubyObject idx) match_aref
IRubyObject	op_aref(IRubyObject[] args) Deprecated. Use the versions with zero, one, or two args.
IRubyObject	op_aref(IRubyObject idx, IRubyObject rest) match_aref
IRubyObject	op_aref19(IRubyObject idx) match_aref
IRubyObject	op_aref19(IRubyObject idx, IRubyObject rest) match_aref
private IRubyObject	op_arefCommon(IRubyObject idx)
IRubyObject	post_match(ThreadContext context) match_post_match
IRubyObject	pre_match(ThreadContext context) match_pre_match
IRubyObject	regexp(ThreadContext context, Block block)
IRubyObject	select(ThreadContext context, Block block)
IRubyObject	size(ThreadContext context) match_size
IRubyObject	string() match_string
RubyArray	to_a() match_to_a
IRubyObject	to_s() match_to_s
private void	updateCharOffset()
private void	updateCharOffsetManyRegs(org.jruby.util.ByteList value, org.jcodings.Encoding encoding)
private void	updateCharOffsetOnlyOneReg(org.jruby.util.ByteList value, org.jcodings.Encoding encoding)
private void	updatePairs(org.jruby.util.ByteList value, org.jcodings.Encoding encoding, RubyMatchData.Pair[] pairs)
void	use()
boolean	used()
IRubyObject	values_at(IRubyObject[] args)

Methods inherited from class org.jruby.RubyObject

attachToObjectSpace, callInit, callInit, callInit, callInit, callInit, callInit, callInit, callInit, callInit, callInit, convertToType, createObjectClass, eqlInternal, equalInternal, hashCode, initialize, initialize, inspect, op_eqq, puts, specificEval, toString

Methods inherited from class org.jruby.RubyBasicObject

addFinalizer, anyToString, asJavaString, asString, callMethod, callMethod, callMethod, callMethod, callMethod, callMethod, callMethod, callMethod, callSuper, checkArrayType, checkCallMethod, checkFrozen, checkStringType, checkStringType19, compareTo, convertToArray, convertToFloat, convertToHash, convertToInteger, convertToInteger, convertToInteger, convertToString, copyInstanceVariablesInto, createBasicObjectClass, dataGetStruct, dataGetStructChecked, dataWrapStruct, display, dup, ensureInstanceVariablesSettable, eql, equal_p, equal_p19, evalUnder, extend, fastGetInstanceVariable, fastGetInternalVariable, fastHasInstanceVariable, fastHasInternalVariable, fastSetInstanceVariable, fastSetInternalVariable, freeze, frozen_p, getFFIHandle, getFlag, getInstanceEvalClass, getInstanceVariable, getInstanceVariableList, getInstanceVariableNameList, getInstanceVariables, getInternalVariable, getInternalVariables, getJavaClass, getMetaClass, getNativeHandle, getObjectId, getRuntime, getSingletonClass, getSingletonClassClone, getType, getVariable, getVariableCount, getVariableList, getVariableNameList, hashyInspect, hasInstanceVariable, hasInternalVariable, hasVariables, id_deprecated, id, infectBy, infectBy, infectBy, 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, isTaint, isTrue, isUntrusted, kind_of_p, makeMetaClass, method_missing19, method, method19, methods, methods, methods19, nil_p, op_cmp, op_equal_19, op_equal, 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, recacheBuiltinMethods, 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_added19, singleton_method_removed19, singleton_method_undefined19, singleton_methods, singleton_methods19, specificEval, specificEval, specificEval, specificEval, syncVariables, syncVariables, taint, taint, tainted_p, testFrozen, testFrozen, toJava, trust, type_deprecated, type, untaint, untrust, untrusted_p, 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 Detail

regs

org.joni.Region regs

begin

int begin

end

int end

str

RubyString str

pattern

org.joni.Regex pattern

regexp

RubyRegexp regexp

charOffsetUpdated

boolean charOffsetUpdated

charOffsets

org.joni.Region charOffsets

MATCH_DATA_ALLOCATOR

private static ObjectAllocator MATCH_DATA_ALLOCATOR

MATCH_BUSY

private static final int MATCH_BUSY

See Also:

Constant Field Values

Constructor Detail

RubyMatchData

public RubyMatchData(Ruby runtime)

RubyMatchData

public RubyMatchData(Ruby runtime,
                     RubyClass metaClass)

Method Detail

createMatchDataClass

public static RubyClass createMatchDataClass(Ruby runtime)

copySpecialInstanceVariables

public void copySpecialInstanceVariables(IRubyObject clone)

Description copied from class: RubyBasicObject

Lots of MRI objects keep their state in non-lookupable ivars (e:g. Range, Struct, etc). This method is responsible for dupping our java field equivalents

Specified by:

copySpecialInstanceVariables in interface IRubyObject

Overrides:

copySpecialInstanceVariables in class RubyBasicObject

getNativeTypeIndex

public int getNativeTypeIndex()

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:

getNativeTypeIndex in interface CoreObjectType

Overrides:

getNativeTypeIndex in class RubyObject

Returns:

the ClassIndex of the native type this object was constructed from

See Also:

ClassIndex

updatePairs

private void updatePairs(org.jruby.util.ByteList value,
                         org.jcodings.Encoding encoding,
                         RubyMatchData.Pair[] pairs)

updateCharOffsetOnlyOneReg

private void updateCharOffsetOnlyOneReg(org.jruby.util.ByteList value,
                                        org.jcodings.Encoding encoding)

updateCharOffsetManyRegs

private void updateCharOffsetManyRegs(org.jruby.util.ByteList value,
                                      org.jcodings.Encoding encoding)

updateCharOffset

private void updateCharOffset()

use

public final void use()

used

public final boolean used()

check

void check()

checkLazyRegexp

private void checkLazyRegexp()

makeShared

private RubyString makeShared(Ruby runtime,
                              RubyString str,
                              int begin,
                              int length)

match_array

private RubyArray match_array(Ruby runtime,
                              int start)

group

public IRubyObject group(long n)

group

public IRubyObject group(int n)

getNamedBackrefValues

public IRubyObject[] getNamedBackrefValues(Ruby runtime)

inspect

public IRubyObject inspect()

Description copied from class: RubyBasicObject

rb_obj_inspect call-seq: obj.inspect => string Returns a string containing a human-readable representation of obj. If not overridden, uses the to_s method to generate the string. [ 1, 2, 3..4, 'five' ].inspect #=> "[1, 2, 3..4, \"five\"]" Time.new.inspect #=> "Wed Apr 09 08:54:39 CDT 2003"

Specified by:

inspect in interface IRubyObject

Overrides:

inspect in class RubyBasicObject

Returns:

String

regexp

public IRubyObject regexp(ThreadContext context,
                          Block block)

names

public IRubyObject names(ThreadContext context,
                         Block block)

to_a

public RubyArray to_a()

match_to_a

Overrides:

to_a in class RubyBasicObject

values_at

public IRubyObject values_at(IRubyObject[] args)

select

public IRubyObject select(ThreadContext context,
                          Block block)

captures

public IRubyObject captures(ThreadContext context)

match_captures

nameToBackrefNumber

private int nameToBackrefNumber(RubyString str)

backrefNumber

public final int backrefNumber(IRubyObject obj)

op_aref

public IRubyObject op_aref(IRubyObject[] args)

Deprecated. Use the versions with zero, one, or two args.

Variable arity version for compatibility. Not bound to a Ruby method.

op_aref

public IRubyObject op_aref(IRubyObject idx)

match_aref

op_aref

public IRubyObject op_aref(IRubyObject idx,
                           IRubyObject rest)

match_aref

op_aref19

public IRubyObject op_aref19(IRubyObject idx)

match_aref

op_aref19

public IRubyObject op_aref19(IRubyObject idx,
                             IRubyObject rest)

match_aref

op_arefCommon

private IRubyObject op_arefCommon(IRubyObject idx)

size

public IRubyObject size(ThreadContext context)

match_size

begin

public IRubyObject begin(ThreadContext context,
                         IRubyObject index)

match_begin

begin19

public IRubyObject begin19(ThreadContext context,
                           IRubyObject index)

beginCommon

private int beginCommon(Ruby runtime,
                        int i)

end

public IRubyObject end(ThreadContext context,
                       IRubyObject index)

match_end

end19

public IRubyObject end19(ThreadContext context,
                         IRubyObject index)

endCommon

private int endCommon(Ruby runtime,
                      int i)

offset

public IRubyObject offset(ThreadContext context,
                          IRubyObject index)

match_offset

offset19

public IRubyObject offset19(ThreadContext context,
                            IRubyObject index)

offsetCommon

private IRubyObject offsetCommon(ThreadContext context,
                                 int i,
                                 boolean is_19)

pre_match

public IRubyObject pre_match(ThreadContext context)

match_pre_match

post_match

public IRubyObject post_match(ThreadContext context)

match_post_match

to_s

public IRubyObject to_s()

match_to_s

Overrides:

to_s in class RubyBasicObject

string

public IRubyObject string()

match_string

initialize_copy

public IRubyObject initialize_copy(IRubyObject original)

Description copied from class: RubyBasicObject

rb_obj_init_copy Initializes this object as a copy of the original, that is the parameter to this object. Will make sure that the argument actually has the same real class as this object. It shouldn't be possible to initialize an object with something totally different.

Overrides:

initialize_copy in class RubyBasicObject

equals

public boolean equals(java.lang.Object other)

Description copied from class: RubyObject

This method is just a wrapper around the Ruby "==" method, provided so that RubyObjects can be used as keys in the Java HashMap object underlying RubyHash.

Overrides:

equals in class RubyObject

eql_p

public IRubyObject eql_p(IRubyObject obj)

Description copied from class: RubyBasicObject

rb_obj_equal Just like "==" and "equal?", "eql?" will use identity equality for Object.

Overrides:

eql_p in class RubyBasicObject

hash

public RubyFixnum hash()

Description copied from class: RubyBasicObject

rb_obj_id Will return the hash code of this object. In comparison to MRI, this method will use the Java identity hash code instead of using rb_obj_id, since the usage of id in JRuby will incur the cost of some. ObjectSpace maintenance.

Overrides:

hash in class RubyBasicObject