gnu.kawa.lispexpr

Class LangObjType

java.lang.Object

gnu.bytecode.Type

gnu.bytecode.ObjectType

gnu.bytecode.SpecialObjectType

gnu.kawa.lispexpr.LangObjType

All Implemented Interfaces:

TypeValue, java.lang.reflect.Type

Direct Known Subclasses:

SeqSizeType

public class LangObjType
extends SpecialObjectType
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.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	LangObjType.ArgListBuilder
static class	LangObjType.SimpleVectorBuilder

Nested classes/interfaces inherited from class gnu.bytecode.Type

Type.NeverReturns

Field Summary

Fields

Modifier and Type	Field and Description
static LangObjType	argListType
static LangObjType	argVectorType
static LangObjType	bitvectorType
static LangObjType	c16vectorType
static LangObjType	constVectorType
static LangObjType	dflonumType
static LangObjType	dynamicType
static LangObjType	f32vectorType
static LangObjType	f64vectorType
static LangObjType	filepathType
static LangObjType	gvectorType
static LangObjType	integerType
static LangObjType	istringType Immutuable string, implemented using IString
static LangObjType	jstringType Wrapper for java.lang.String, with extra coercions.
static LangObjType	listType
static LangObjType	numericType
static LangObjType	pathType
static LangObjType	procedureType
static LangObjType	promiseType
static LangObjType	rationalType
static LangObjType	realType
static LangObjType	regexType
static LangObjType	s16vectorType
static LangObjType	s32vectorType
static LangObjType	s64vectorType
static LangObjType	s8vectorType
static LangObjType	sequenceType
static LangObjType	stringType
static LangObjType	typeClass
static LangObjType	typeClassType
static ClassType	typeLangObjType
static LangObjType	typeType
static LangObjType	u16vectorType
static LangObjType	u32vectorType
static LangObjType	u64vectorType
static LangObjType	u8vectorType
static LangObjType	URIType
static LangObjType	vectorType

Fields inherited from class gnu.bytecode.SpecialObjectType

implementationType

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, javalangannotationAnnotationType, javalangBooleanType, javalangCharacterType, javalangClassType, javalanginvokeMethodHandleType, 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

Modifier and Type	Method and Description
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 FVector	coerceToConstVector(java.lang.Object obj)
static Procedure	coerceToProcedure(java.lang.Object obj)
static Procedure	coerceToProcedureOrNull(java.lang.Object value)
static Type	coerceToType(java.lang.Object obj)
static Type	coerceToTypeOrNull(java.lang.Object type)
static U8Vector	coerceToU8Vector(java.lang.Object obj)
protected Method	coercionOrNullMethod()
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.
java.lang.String	elementGetterMethodName()
java.lang.String	elementSetterMethodName()
void	emitCoerceFromObject(CodeAttr code) Compile (in given method) cast from Object to this Type.
boolean	emitCoercionOrNull(CodeAttr code)
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 ....
java.lang.String	encodeType(Language language)
CompileBuildObject	getBuildObject()
Procedure	getConstructor() Get the constructor function for this type.
ObjectType	getConstructorType()
Type	getElementType()
static LangObjType	getInstanceFromClass(java.lang.String name)
int	isCompatibleWithValue(Type valueType) If this is the target type, is a given source type compatible?

Methods inherited from class gnu.bytecode.SpecialObjectType

getDeclaredMethod, getField, getImplementationType, getInterfaces, getMethod, getMethods, getRealType, getReflectClass, getSuperclass

Methods inherited from class gnu.bytecode.ObjectType

getContextClass, getContextClassLoader, getInternalName, getMethods, isExisting, isInstance, setExisting

Methods inherited from class gnu.bytecode.Type

coerceToObject, emitCoerceToObject, emitIsInstance, getGenericSignature, getMaybeGenericSignature, getName, getRawType, getSignature, getSize, getSizeInWords, getType, hashCode, isCompatibleWithValue, isInterface, isMoreSpecific, isSame, isSubtype, isValidJavaTypeName, isVoid, lookupType, lowestCommonSharedType, lowestCommonSuperType, make, make, printSignature, promote, promoteIfUnsigned, registerTypeForClass, setGenericSignature, 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

Methods inherited from interface gnu.expr.TypeValue

getImplementationType

Methods inherited from interface java.lang.reflect.Type

getTypeName

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

gvectorType

public static final LangObjType gvectorType

constVectorType

public static final LangObjType constVectorType

s8vectorType

public static final LangObjType s8vectorType

u8vectorType

public static final LangObjType u8vectorType

s16vectorType

public static final LangObjType s16vectorType

u16vectorType

public static final LangObjType u16vectorType

s32vectorType

public static final LangObjType s32vectorType

u32vectorType

public static final LangObjType u32vectorType

s64vectorType

public static final LangObjType s64vectorType

u64vectorType

public static final LangObjType u64vectorType

f32vectorType

public static final LangObjType f32vectorType

f64vectorType

public static final LangObjType f64vectorType

c16vectorType

public static final LangObjType c16vectorType

bitvectorType

public static final LangObjType bitvectorType

regexType

public static final LangObjType regexType

stringType

public static final LangObjType stringType

jstringType

public static final LangObjType jstringType

Wrapper for java.lang.String, with extra coercions.

istringType

public static final LangObjType istringType

Immutuable string, implemented using IString

listType

public static final LangObjType listType

procedureType

public static final LangObjType procedureType

promiseType

public static final LangObjType promiseType

sequenceType

public static final LangObjType sequenceType

dynamicType

public static final LangObjType dynamicType

argListType

public static final LangObjType argListType

argVectorType

public static final LangObjType argVectorType

typeLangObjType

public static final ClassType typeLangObjType

Method Detail

getInstanceFromClass

public static LangObjType getInstanceFromClass(java.lang.String name)

isCompatibleWithValue

public int isCompatibleWithValue(Type valueType)

Description copied from class: Type

If this is the target type, is a given source type compatible?

Overrides:

isCompatibleWithValue in class Type

Returns:

-1 if not compatible; 0 if need to check at run-time; 1 if compatible; 2 if compatible and no conversion or cast needed. We also return 0 for some "narrowing" conversions even if we know they will always succeed, so as to make such conversions less preferred when doing method overloading.

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 SpecialObjectType

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)

coerceToConstVector

public static FVector coerceToConstVector(java.lang.Object obj)

coerceToProcedureOrNull

public static Procedure coerceToProcedureOrNull(java.lang.Object value)

coerceToProcedure

public static Procedure coerceToProcedure(java.lang.Object obj)

coerceToU8Vector

public static U8Vector coerceToU8Vector(java.lang.Object obj)

coercionOrNullMethod

protected Method coercionOrNullMethod()

emitCoercionOrNull

public boolean emitCoercionOrNull(CodeAttr code)

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. The result is actually of the implementation type, boxed as appropriate, so it is suitable for standard reflective operations, like the arguments to Field#set or Method#invoke. 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

getConstructorType

public ObjectType getConstructorType()

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 (<init> methods) should be used.

Specified by:

getConstructor in interface TypeValue

encodeType

public java.lang.String encodeType(Language language)

Specified by:

encodeType in interface TypeValue

getElementType

public Type getElementType()

elementGetterMethodName

public java.lang.String elementGetterMethodName()

elementSetterMethodName

public java.lang.String elementSetterMethodName()

getBuildObject

public CompileBuildObject getBuildObject()