Package org.jruby.util

Class TypeConverter

java.lang.Object

org.jruby.util.TypeConverter

public class TypeConverter
extends Object

Field Summary

Fields

Modifier and Type	Field	Description
private static final String[]	IMPLICIT_CONVERTED_METHODS

Constructor Summary

Constructors

Constructor	Description
TypeConverter()

Method Summary

Modifier and Type	Method	Description
static IRubyObject	checkArrayType(Ruby runtime, IRubyObject obj)
static IRubyObject	checkArrayType(IRubyObject obj)	Deprecated.
static IRubyObject	checkArrayType(ThreadContext context, IRubyObject obj)
static IRubyObject	checkArrayType(ThreadContext context, JavaSites.CheckedSites sites, IRubyObject obj)
static IRubyObject	checkData(IRubyObject obj)	Checks that this object is of type DATA and then returns it, otherwise raises failure (MRI: Check_Type(obj, T_DATA))
static IRubyObject	checkFloatType(Ruby runtime, IRubyObject obj)
static IRubyObject	checkHashType(Ruby runtime, IRubyObject obj)
static IRubyObject	checkHashType(Ruby runtime, IRubyObject obj, boolean raise)
static IRubyObject	checkHashType(ThreadContext context, JavaSites.CheckedSites sites, IRubyObject obj)
static RubySymbol	checkID(Ruby runtime, String name)	Convert the supplied object into an internal identifier String.
static RubySymbol	checkID(IRubyObject obj)	Convert the supplied object into an internal identifier String.
static IRubyObject	checkIntegerType(Ruby runtime, IRubyObject obj, String method)
static IRubyObject	checkIntegerType(ThreadContext context, IRubyObject obj)
static IRubyObject	checkStringType(Ruby runtime, IRubyObject obj)
static IRubyObject	checkStringType(ThreadContext context, JavaSites.CheckedSites sites, IRubyObject obj)
static IRubyObject	checkStringType(ThreadContext context, JavaSites.CheckedSites sites, IRubyObject obj, RubyClass target)
static void	checkType(ThreadContext context, IRubyObject x, RubyModule type)
static String	convertToIdentifier(IRubyObject obj)	Deprecated.
static IRubyObject	convertToInteger(ThreadContext context, IRubyObject val, int base)
static IRubyObject	convertToInteger(ThreadContext context, IRubyObject val, int base, boolean exception)
static IRubyObject	convertToType(IRubyObject obj, RubyClass target, int convertMethodIndex, String convertMethod)	Deprecated.
static IRubyObject	convertToType(IRubyObject obj, RubyClass target, int convertMethodIndex, String convertMethod, boolean raise)	Deprecated.
static IRubyObject	convertToType(IRubyObject obj, RubyClass target, String convertMethod)	Converts this object to type 'targetType' using 'convertMethod' method and raises TypeError exception on failure (MRI: rb_convert_type).
static IRubyObject	convertToType(IRubyObject obj, RubyClass target, String convertMethod, boolean raise)	Converts this object to type 'targetType' using 'convertMethod' method (MRI: convert_type).
static IRubyObject	convertToType(ThreadContext context, IRubyObject obj, RubyClass target, String convertMethod, boolean raise)
static IRubyObject	convertToType(ThreadContext context, IRubyObject obj, RubyClass target, JavaSites.CheckedSites sites)	Converts this object to type 'targetType' using 'convertMethod' method and raises TypeError exception on failure (MRI: rb_convert_type).
static IRubyObject	convertToType(ThreadContext context, IRubyObject obj, RubyClass target, JavaSites.CheckedSites sites, boolean raise)	Converts this object to type 'targetType' using 'convertMethod' method (MRI: convert_type 1.9).
static IRubyObject	convertToType19(IRubyObject obj, RubyClass target, String convertMethod)	Deprecated.
static IRubyObject	convertToType19(IRubyObject obj, RubyClass target, String convertMethod, boolean raise)	Deprecated.
static IRubyObject	convertToType19(ThreadContext context, IRubyObject obj, RubyClass target, JavaSites.CheckedSites sites)	Deprecated.
static IRubyObject	convertToType19(ThreadContext context, IRubyObject obj, RubyClass target, JavaSites.CheckedSites sites, boolean raise)	Deprecated.
static IRubyObject	convertToTypeOrRaise(IRubyObject obj, RubyClass target, String convertMethod)	Deprecated.
static IRubyObject	convertToTypeWithCheck(IRubyObject obj, RubyClass target, int convertMethodIndex, String convertMethod)	Deprecated.
static IRubyObject	convertToTypeWithCheck(IRubyObject obj, RubyClass target, String convertMethod)	Higher level conversion utility similar to convertToType but it can throw an additional TypeError during conversion (MRI: rb_check_convert_type).
static IRubyObject	convertToTypeWithCheck(ThreadContext context, IRubyObject obj, RubyClass target, JavaSites.CheckedSites sites)	Higher level conversion utility similar to convertToType but it can throw an additional TypeError during conversion (MRI: rb_check_convert_type).
static IRubyObject	convertToTypeWithCheck19(IRubyObject obj, RubyClass target, String convertMethod)	Deprecated.
static IRubyObject	convertToTypeWithCheck19(ThreadContext context, IRubyObject obj, RubyClass target, JavaSites.CheckedSites sites)	Deprecated.
static IRubyObject	handleImplicitlyUncoercibleObject(boolean raise, IRubyObject obj, RubyClass target)	Deprecated.
static IRubyObject	handleUncoercibleObject(boolean raise, IRubyObject obj, RubyClass target)
static IRubyObject	handleUncoercibleObject(Ruby runtime, IRubyObject obj, RubyClass target, boolean raise)
static IRubyObject	ioCheckIO(Ruby runtime, IRubyObject obj)
static RubyIO	ioGetIO(Ruby runtime, IRubyObject obj)
private static boolean	isImplicitTypeError(String methodID)
static RaiseException	newTypeError(Ruby runtime, IRubyObject obj, RubyClass target, String methodName, IRubyObject val)
static RaiseException	newTypeError(IRubyObject obj, RubyClass target, String convertMethod, IRubyObject val)
static RaiseException	newTypeErrorMismatch(Ruby runtime, IRubyObject obj, RubyClass target, String methodName, IRubyObject val)
private static IRubyObject	raiseIntegerBaseError(ThreadContext context, boolean exception)
static RubyArray	rb_Array(ThreadContext context, IRubyObject val)
private static JavaSites.TypeConverterSites	sites(ThreadContext context)
static RubyArray	to_ary(ThreadContext context, IRubyObject ary)
static RubyFloat	toFloat(Ruby runtime, IRubyObject obj)
static RubyString	typeAsString(IRubyObject obj)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

IMPLICIT_CONVERTED_METHODS

private static final String[] IMPLICIT_CONVERTED_METHODS

Constructor Details

TypeConverter

public TypeConverter()

Method Details

convertToType

public static IRubyObject convertToType(IRubyObject obj,
 RubyClass target,
 String convertMethod,
 boolean raise)

Converts this object to type 'targetType' using 'convertMethod' method (MRI: convert_type).

Parameters:

obj - the object to convert

target - is the type we are trying to convert to

convertMethod - is the method to be called to try and convert to target type

raise - will throw an Error if conversion does not work

Returns:

the converted value

convertToType

public static IRubyObject convertToType(ThreadContext context,
 IRubyObject obj,
 RubyClass target,
 String convertMethod,
 boolean raise)

convertToType

public static IRubyObject convertToType(ThreadContext context,
 IRubyObject obj,
 RubyClass target,
 JavaSites.CheckedSites sites,
 boolean raise)

Converts this object to type 'targetType' using 'convertMethod' method (MRI: convert_type 1.9).

Parameters:

obj - the object to convert

target - is the type we are trying to convert to

sites - is the CheckedSites call sites to be called to try and convert to targetType

raise - will throw an Error if conversion does not work

Returns:

the converted value

convertToType

public static IRubyObject convertToType(IRubyObject obj,
 RubyClass target,
 String convertMethod)

Converts this object to type 'targetType' using 'convertMethod' method and raises TypeError exception on failure (MRI: rb_convert_type).

Parameters:

obj - the object to convert

target - is the type we are trying to convert to

convertMethod - is the method to be called to try and convert to targeType

Returns:

the converted value

convertToType

public static IRubyObject convertToType(ThreadContext context,
 IRubyObject obj,
 RubyClass target,
 JavaSites.CheckedSites sites)

Converts this object to type 'targetType' using 'convertMethod' method and raises TypeError exception on failure (MRI: rb_convert_type).

Parameters:

obj - the object to convert

target - is the type we are trying to convert to

sites - is the CheckedSites call sites to use to dispatch the convert method

Returns:

the converted value

convertToType19

@Deprecated
public static IRubyObject convertToType19(IRubyObject obj,
 RubyClass target,
 String convertMethod,
 boolean raise)

Deprecated.

convertToType19

@Deprecated
public static IRubyObject convertToType19(ThreadContext context,
 IRubyObject obj,
 RubyClass target,
 JavaSites.CheckedSites sites,
 boolean raise)

Deprecated.

convertToType19

@Deprecated
public static IRubyObject convertToType19(IRubyObject obj,
 RubyClass target,
 String convertMethod)

Deprecated.

convertToType19

@Deprecated
public static IRubyObject convertToType19(ThreadContext context,
 IRubyObject obj,
 RubyClass target,
 JavaSites.CheckedSites sites)

Deprecated.

toFloat

public static RubyFloat toFloat(Ruby runtime,
 IRubyObject obj)

checkData

public static IRubyObject checkData(IRubyObject obj)

Checks that this object is of type DATA and then returns it, otherwise raises failure (MRI: Check_Type(obj, T_DATA))

Parameters:

obj - the object to check

Returns:

the converted value

typeAsString

public static RubyString typeAsString(IRubyObject obj)

checkID

public static RubySymbol checkID(IRubyObject obj)

Convert the supplied object into an internal identifier String. Basically, symbols are stored internally as raw bytes from whatever encoding they were originally sourced from. When methods are stored they must also get stored in this same raw fashion so that if we use symbols to look up methods or make symbols from these method names they will match up. For 2.2 compatibility, we also force all incoming identifiers to get anchored as hard-referenced symbols.

checkID

public static RubySymbol checkID(Ruby runtime,
 String name)

Convert the supplied object into an internal identifier String. Basically, symbols are stored internally as raw bytes from whatever encoding they were originally sourced from. When methods are stored they must also get stored in this same raw fashion so that if we use symbols to look up methods or make symbols from these method names they will match up. For 2.2 compatibility, we also force all incoming identifiers to get anchored as hard-referenced symbols.

convertToTypeWithCheck

public static IRubyObject convertToTypeWithCheck(IRubyObject obj,
 RubyClass target,
 String convertMethod)

Higher level conversion utility similar to convertToType but it can throw an additional TypeError during conversion (MRI: rb_check_convert_type).

Parameters:

obj - the object to convert

target - is the type we are trying to convert to

convertMethod - is the method to be called to try and convert to targeType

Returns:

the converted value

convertToTypeWithCheck

public static IRubyObject convertToTypeWithCheck(ThreadContext context,
 IRubyObject obj,
 RubyClass target,
 JavaSites.CheckedSites sites)

Higher level conversion utility similar to convertToType but it can throw an additional TypeError during conversion (MRI: rb_check_convert_type).

Parameters:

obj - the object to convert

target - is the type we are trying to convert to

sites - the CheckedSites call sites to use for coersion

Returns:

the converted value

convertToTypeWithCheck19

@Deprecated
public static IRubyObject convertToTypeWithCheck19(IRubyObject obj,
 RubyClass target,
 String convertMethod)

Deprecated.

convertToTypeWithCheck19

@Deprecated
public static IRubyObject convertToTypeWithCheck19(ThreadContext context,
 IRubyObject obj,
 RubyClass target,
 JavaSites.CheckedSites sites)

Deprecated.

newTypeError

public static RaiseException newTypeError(IRubyObject obj,
 RubyClass target,
 String convertMethod,
 IRubyObject val)

newTypeError

public static RaiseException newTypeError(Ruby runtime,
 IRubyObject obj,
 RubyClass target,
 String methodName,
 IRubyObject val)

newTypeErrorMismatch

public static RaiseException newTypeErrorMismatch(Ruby runtime,
 IRubyObject obj,
 RubyClass target,
 String methodName,
 IRubyObject val)

checkIntegerType

public static IRubyObject checkIntegerType(ThreadContext context,
 IRubyObject obj)

checkIntegerType

public static IRubyObject checkIntegerType(Ruby runtime,
 IRubyObject obj,
 String method)

checkFloatType

public static IRubyObject checkFloatType(Ruby runtime,
 IRubyObject obj)

checkHashType

public static IRubyObject checkHashType(Ruby runtime,
 IRubyObject obj)

checkHashType

public static IRubyObject checkHashType(Ruby runtime,
 IRubyObject obj,
 boolean raise)

checkHashType

public static IRubyObject checkHashType(ThreadContext context,
 JavaSites.CheckedSites sites,
 IRubyObject obj)

checkStringType

public static IRubyObject checkStringType(Ruby runtime,
 IRubyObject obj)

checkStringType

public static IRubyObject checkStringType(ThreadContext context,
 JavaSites.CheckedSites sites,
 IRubyObject obj)

checkStringType

public static IRubyObject checkStringType(ThreadContext context,
 JavaSites.CheckedSites sites,
 IRubyObject obj,
 RubyClass target)

checkArrayType

public static IRubyObject checkArrayType(Ruby runtime,
 IRubyObject obj)

checkArrayType

public static IRubyObject checkArrayType(ThreadContext context,
 JavaSites.CheckedSites sites,
 IRubyObject obj)

ioCheckIO

public static IRubyObject ioCheckIO(Ruby runtime,
 IRubyObject obj)

ioGetIO

public static RubyIO ioGetIO(Ruby runtime,
 IRubyObject obj)

checkArrayType

public static IRubyObject checkArrayType(ThreadContext context,
 IRubyObject obj)

checkArrayType

@Deprecated
public static IRubyObject checkArrayType(IRubyObject obj)

Deprecated.

handleUncoercibleObject

public static IRubyObject handleUncoercibleObject(boolean raise,
 IRubyObject obj,
 RubyClass target)

handleUncoercibleObject

public static IRubyObject handleUncoercibleObject(Ruby runtime,
 IRubyObject obj,
 RubyClass target,
 boolean raise)

handleImplicitlyUncoercibleObject

@Deprecated
public static IRubyObject handleImplicitlyUncoercibleObject(boolean raise,
 IRubyObject obj,
 RubyClass target)

Deprecated.

checkType

public static void checkType(ThreadContext context,
 IRubyObject x,
 RubyModule type)

convertToInteger

public static IRubyObject convertToInteger(ThreadContext context,
 IRubyObject val,
 int base,
 boolean exception)

convertToInteger

public static IRubyObject convertToInteger(ThreadContext context,
 IRubyObject val,
 int base)

rb_Array

public static RubyArray rb_Array(ThreadContext context,
 IRubyObject val)

to_ary

public static RubyArray to_ary(ThreadContext context,
 IRubyObject ary)

raiseIntegerBaseError

private static IRubyObject raiseIntegerBaseError(ThreadContext context,
 boolean exception)

sites

private static JavaSites.TypeConverterSites sites(ThreadContext context)

convertToType

@Deprecated
public static IRubyObject convertToType(IRubyObject obj,
 RubyClass target,
 int convertMethodIndex,
 String convertMethod,
 boolean raise)

Deprecated.

convertToType

@Deprecated
public static IRubyObject convertToType(IRubyObject obj,
 RubyClass target,
 int convertMethodIndex,
 String convertMethod)

Deprecated.

convertToTypeWithCheck

@Deprecated
public static IRubyObject convertToTypeWithCheck(IRubyObject obj,
 RubyClass target,
 int convertMethodIndex,
 String convertMethod)

Deprecated.

convertToIdentifier

@Deprecated
public static String convertToIdentifier(IRubyObject obj)

Deprecated.

convertToTypeOrRaise

@Deprecated
public static IRubyObject convertToTypeOrRaise(IRubyObject obj,
 RubyClass target,
 String convertMethod)

Deprecated.

Higher level conversion utility similar to convertToType but it can throw an additional TypeError during conversion (MRI: rb_check_convert_type).

Parameters:

obj - the object to convert

target - is the type we are trying to convert to

convertMethod - is the method to be called to try and convert to targeType

Returns:

the converted value

isImplicitTypeError

private static boolean isImplicitTypeError(String methodID)