gnu.kawa.lispexpr
Class LangObjType

java.lang.Object
  extended by gnu.bytecode.Type
      extended by gnu.bytecode.ObjectType
          extended by gnu.kawa.lispexpr.LangObjType
All Implemented Interfaces:
TypeValue, java.lang.reflect.Type

public class LangObjType
extends ObjectType
implements TypeValue

A wrapper around a class type. A LangObjType is implemented using some class type, but may have a custom (language-specific) coercion method, constructor, and name.


Field Summary
static LangObjType dflonumType
           
static LangObjType filepathType
           
static LangObjType integerType
           
static LangObjType listType
           
static LangObjType numericType
           
static LangObjType pathType
           
static LangObjType rationalType
           
static LangObjType realType
           
static LangObjType regexType
           
static LangObjType stringType
           
static LangObjType typeClass
           
static LangObjType typeClassType
           
static ClassType typeLangObjType
           
static LangObjType typeType
           
static LangObjType URIType
           
static LangObjType vectorType
           
 
Fields inherited from class gnu.bytecode.ObjectType
flags
 
Fields inherited from class gnu.bytecode.Type
boolean_ctype, boolean_type, booleanType, booleanValue_method, byte_type, byteType, char_type, charType, clone_method, double_type, doubleType, doubleValue_method, errorType, float_type, floatType, floatValue_method, int_type, intType, intValue_method, java_lang_Class_type, javalangBooleanType, javalangClassType, javalangNumberType, javalangObjectType, javalangStringType, javalangThrowableType, long_type, longType, longValue_method, neverReturnsType, nullType, number_type, objectType, pointer_type, reflectClass, short_type, shortType, string_type, throwable_type, toString_method, tostring_type, toStringType, typeArray0, void_type, voidType
 
Method Summary
static DFloNum coerceDFloNum(java.lang.Object value)
           
 java.lang.Object coerceFromObject(java.lang.Object obj)
          Convert an object to a value of this Type.
static IntNum coerceIntNum(java.lang.Object value)
           
static Numeric coerceNumeric(java.lang.Object value)
           
static RatNum coerceRatNum(java.lang.Object value)
           
static RealNum coerceRealNum(java.lang.Object value)
           
static java.lang.Class coerceToClass(java.lang.Object obj)
           
static java.lang.Class coerceToClassOrNull(java.lang.Object type)
           
static ClassType coerceToClassType(java.lang.Object obj)
           
static ClassType coerceToClassTypeOrNull(java.lang.Object type)
           
static Type coerceToType(java.lang.Object obj)
           
static Type coerceToTypeOrNull(java.lang.Object type)
           
 int compare(Type other)
          Return a numeric code showing "subtype" relationship: 1: if other is a pure subtype of this; 0: if has the same values; -1: if this is a pure subtype of other; -2: if they have values in common but neither is a subtype of the other; -3: if the types have no values in common.
 Expression convertValue(Expression value)
          Return converted expression or null.
 void emitCoerceFromObject(CodeAttr code)
          Compile (in given method) cast from Object to this Type.
 void emitConvertFromPrimitive(Type stackType, CodeAttr code)
          Convert from stackType (usually PrimType) to this type.
 void emitIsInstance(Variable incoming, Compilation comp, Target target)
          Emit code for incoming instanceof this_type.
 void emitTestIf(Variable incoming, Declaration decl, Compilation comp)
          Emit code for if (incoming instanceof this_type) decl = incoming ....
 Procedure getConstructor()
          Get the constructor function for this type.
 Method getDeclaredMethod(java.lang.String name, int argCount)
           
 Field getField(java.lang.String name, int mask)
           
 Type getImplementationType()
          The type used to implement types not natively understood by the JVM.
 Method getMethod(java.lang.String name, Type[] arg_types)
           
 int getMethods(Filter filter, int searchSupers, java.util.List<Method> result)
           
 Type getRealType()
          If this is a type alias, get the aliased type.
 java.lang.Class getReflectClass()
          Get the java.lang.Class object for the representation type.
 
Methods inherited from class gnu.bytecode.ObjectType
getContextClass, getContextClassLoader, getInternalName, getMethods, isExisting, isInstance, promote, setExisting
 
Methods inherited from class gnu.bytecode.Type
coerceToObject, emitCoerceToObject, emitIsInstance, getName, getSignature, getSize, getSizeInWords, getType, hashCode, isMoreSpecific, isSubtype, isValidJavaTypeName, isVoid, lookupType, lowestCommonSuperType, make, printSignature, registerTypeForClass, setName, setReflectClass, setSignature, signatureLength, signatureLength, signatureToName, signatureToPrimitive, signatureToType, signatureToType, swappedCompareResult, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Field Detail

pathType

public static final LangObjType pathType

filepathType

public static final LangObjType filepathType

URIType

public static final LangObjType URIType

typeClass

public static final LangObjType typeClass

typeType

public static final LangObjType typeType

typeClassType

public static final LangObjType typeClassType

numericType

public static final LangObjType numericType

realType

public static final LangObjType realType

rationalType

public static final LangObjType rationalType

integerType

public static final LangObjType integerType

dflonumType

public static final LangObjType dflonumType

vectorType

public static final LangObjType vectorType

regexType

public static final LangObjType regexType

stringType

public static final LangObjType stringType

listType

public static final LangObjType listType

typeLangObjType

public static final ClassType typeLangObjType
Method Detail

compare

public int compare(Type other)
Description copied from class: Type
Return a numeric code showing "subtype" relationship: 1: if other is a pure subtype of this; 0: if has the same values; -1: if this is a pure subtype of other; -2: if they have values in common but neither is a subtype of the other; -3: if the types have no values in common. "Same values" is rather loose; by "A is a subtype of B" we mean that all instance of A can be "widened" to B. More formally, A.compare(B) returns: 1: all B values can be converted to A without a coercion failure (i.e. a ClassCastException or overflow or major loss of information), but not vice versa. 0: all A values can be converted to B without a coercion failure and vice versa; -1: all A values can be converted to B without a coercion failure but not vice versa; -2: there are (potentially) some A values that can be converted to B, and some B values can be converted to A; -3: there are no A values that can be converted to B, and neither are there any B values that can be converted to A.

Overrides:
compare in class ObjectType

getField

public Field getField(java.lang.String name,
                      int mask)
Overrides:
getField in class ObjectType

getMethod

public Method getMethod(java.lang.String name,
                        Type[] arg_types)
Overrides:
getMethod in class ObjectType

getDeclaredMethod

public Method getDeclaredMethod(java.lang.String name,
                                int argCount)

getMethods

public int getMethods(Filter filter,
                      int searchSupers,
                      java.util.List<Method> result)
Overrides:
getMethods in class ObjectType

getReflectClass

public java.lang.Class getReflectClass()
Description copied from class: ObjectType
Get the java.lang.Class object for the representation type.

Overrides:
getReflectClass in class ObjectType

getRealType

public Type getRealType()
Description copied from class: Type
If this is a type alias, get the aliased type.

Overrides:
getRealType in class Type

getImplementationType

public Type getImplementationType()
Description copied from class: Type
The type used to implement types not natively understood by the JVM. Usually, the identity function. However, a language might handle union types or template types or type expressions calculated at run time. In that case return the type used at the JVM level, and known at compile time.

Specified by:
getImplementationType in interface TypeValue
Overrides:
getImplementationType in class ObjectType

emitIsInstance

public void emitIsInstance(Variable incoming,
                           Compilation comp,
                           Target target)
Description copied from interface: TypeValue
Emit code for incoming instanceof this_type. The implementation can use InstanceOf .emitIsInstance which is a conveniece method that calls emitTestIf.

Specified by:
emitIsInstance in interface TypeValue
Parameters:
incoming - Contains the value we are testing to see if it has the the type of 'this'. If null, use top-of-stack.
comp - The compilation state.
target - Where to leave the result.

coerceNumeric

public static Numeric coerceNumeric(java.lang.Object value)

coerceRealNum

public static RealNum coerceRealNum(java.lang.Object value)

coerceDFloNum

public static DFloNum coerceDFloNum(java.lang.Object value)

coerceRatNum

public static RatNum coerceRatNum(java.lang.Object value)

coerceIntNum

public static IntNum coerceIntNum(java.lang.Object value)

coerceToClassOrNull

public static java.lang.Class coerceToClassOrNull(java.lang.Object type)

coerceToClass

public static java.lang.Class coerceToClass(java.lang.Object obj)

coerceToClassTypeOrNull

public static ClassType coerceToClassTypeOrNull(java.lang.Object type)

coerceToClassType

public static ClassType coerceToClassType(java.lang.Object obj)

coerceToTypeOrNull

public static Type coerceToTypeOrNull(java.lang.Object type)

coerceToType

public static Type coerceToType(java.lang.Object obj)

emitTestIf

public void emitTestIf(Variable incoming,
                       Declaration decl,
                       Compilation comp)
Description copied from interface: TypeValue
Emit code for if (incoming instanceof this_type) decl = incoming .... This method is designed for typeswitch applications, where this call is the first part of a conditional, so it must be followed by calls to emitElse and emitFi.

Specified by:
emitTestIf in interface TypeValue
Parameters:
incoming - Contains the value we are testing to see if it has the type of this. If null, use top-of-stack. May not be null if decl is non-null.
decl - If non-null, assign value after coercion to Declaration.
comp - The compilation state.

coerceFromObject

public java.lang.Object coerceFromObject(java.lang.Object obj)
Description copied from class: Type
Convert an object to a value of this Type. Throw a ClassCastException when this is not possible.

Overrides:
coerceFromObject in class ObjectType

emitConvertFromPrimitive

public void emitConvertFromPrimitive(Type stackType,
                                     CodeAttr code)
Description copied from class: Type
Convert from stackType (usually PrimType) to this type. However, we might only convert part-way, to some object type. If converting to this type might fail at run-time, only convert to Object (as by emitCoerceToObject); a caller can use stackType.emitConvertFromObject to convert the rest, but that might throw an exception. (This is a bit of a kludge.)

Overrides:
emitConvertFromPrimitive in class Type

convertValue

public Expression convertValue(Expression value)
Description copied from interface: TypeValue
Return converted expression or null.

Specified by:
convertValue in interface TypeValue

emitCoerceFromObject

public void emitCoerceFromObject(CodeAttr code)
Description copied from class: ObjectType
Compile (in given method) cast from Object to this Type.

Overrides:
emitCoerceFromObject in class ObjectType

getConstructor

public Procedure getConstructor()
Description copied from interface: TypeValue
Get the constructor function for this type. Returns null if there is no contructor function. Also returns null if this extends ClassType or ArrayType and standard Java constructors ( methods) should be used.

Specified by:
getConstructor in interface TypeValue