org.jruby.util
Class TypeConverter

java.lang.Object
  org.jruby.util.TypeConverter

public class TypeConverter
extends java.lang.Object

Constructor Summary

TypeConverter()

Method Summary

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	checkHashType(Ruby runtime, IRubyObject obj)
static IRubyObject	convertToType(IRubyObject obj, RubyClass target, int convertMethodIndex, java.lang.String convertMethod) Deprecated.
static IRubyObject	convertToType(IRubyObject obj, RubyClass target, int convertMethodIndex, java.lang.String convertMethod, boolean raise) Deprecated.
static IRubyObject	convertToType(IRubyObject obj, RubyClass target, java.lang.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, java.lang.String convertMethod, boolean raise) Converts this object to type 'targetType' using 'convertMethod' method (MRI: convert_type).
static IRubyObject	convertToType19(IRubyObject obj, RubyClass target, java.lang.String convertMethod) Converts this object to type 'targetType' using 'convertMethod' method and raises TypeError exception on failure (MRI: rb_convert_type in 1.9).
static IRubyObject	convertToType19(IRubyObject obj, RubyClass target, java.lang.String convertMethod, boolean raise) Converts this object to type 'targetType' using 'convertMethod' method (MRI: convert_type 1.9).
static IRubyObject	convertToTypeOrRaise(IRubyObject obj, RubyClass target, java.lang.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(IRubyObject obj, RubyClass target, int convertMethodIndex, java.lang.String convertMethod) Deprecated.
static IRubyObject	convertToTypeWithCheck(IRubyObject obj, RubyClass target, java.lang.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	convertToTypeWithCheck19(IRubyObject obj, RubyClass target, java.lang.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	handleUncoercibleObject(boolean raise, IRubyObject obj, RubyClass target)

Methods inherited from class java.lang.Object

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

Constructor Detail

TypeConverter

public TypeConverter()

Method Detail

convertToType

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

Deprecated.

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

Parameters:

obj - the object to convert

targetType - is the type we are trying to convert to

convertMethodIndex - the fast index to use for calling the method

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

raiseOnError - will throw an Error if conversion does not work

Returns:

the converted value

convertToType

public static final IRubyObject convertToType(IRubyObject obj,
                                              RubyClass target,
                                              java.lang.String convertMethod,
                                              boolean raise)

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

Parameters:

obj - the object to convert

targetType - is the type we are trying to convert to

convertMethodIndex - the fast index to use for calling the method

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

raiseOnError - will throw an Error if conversion does not work

Returns:

the converted value

convertToType19

public static final IRubyObject convertToType19(IRubyObject obj,
                                                RubyClass target,
                                                java.lang.String convertMethod,
                                                boolean raise)

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

Parameters:

obj - the object to convert

targetType - is the type we are trying to convert to

convertMethodIndex - the fast index to use for calling the method

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

raiseOnError - will throw an Error if conversion does not work

Returns:

the converted value

convertToType

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

Deprecated.

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

targetType - is the type we are trying to convert to

convertMethodIndex - the fast index to use for calling the method

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

Returns:

the converted value

convertToType

public static final IRubyObject convertToType(IRubyObject obj,
                                              RubyClass target,
                                              java.lang.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

targetType - 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

convertToType19

public static final IRubyObject convertToType19(IRubyObject obj,
                                                RubyClass target,
                                                java.lang.String convertMethod)

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

Parameters:

obj - the object to convert

targetType - 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

checkData

public static final 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

convertToTypeWithCheck

@Deprecated
public static final IRubyObject convertToTypeWithCheck(IRubyObject obj,
                                                                  RubyClass target,
                                                                  int convertMethodIndex,
                                                                  java.lang.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

targetType - is the type we are trying to convert to

convertMethodIndex - the fast index to use for calling the method

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

Returns:

the converted value

convertToTypeWithCheck

public static final IRubyObject convertToTypeWithCheck(IRubyObject obj,
                                                       RubyClass target,
                                                       java.lang.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

targetType - is the type we are trying to convert to

convertMethodIndex - the fast index to use for calling the method

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

Returns:

the converted value

convertToTypeWithCheck19

public static final IRubyObject convertToTypeWithCheck19(IRubyObject obj,
                                                         RubyClass target,
                                                         java.lang.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

targetType - is the type we are trying to convert to

convertMethodIndex - the fast index to use for calling the method

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

Returns:

the converted value

convertToTypeOrRaise

public static final IRubyObject convertToTypeOrRaise(IRubyObject obj,
                                                     RubyClass target,
                                                     java.lang.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

targetType - 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

checkHashType

public static IRubyObject checkHashType(Ruby runtime,
                                        IRubyObject obj)

handleUncoercibleObject

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

Throws:

RaiseException