Class TypeVariableType

    • Method Detail

      • getName

        public String getName()
        Description copied from interface: IType
        The fully qualified name of this intrinsic type.
        Specified by:
        getName in interface IType
      • getDisplayName

        public String getDisplayName()
        Description copied from interface: IType
        The display name of this intrinsic type. Often this is simply the same as IType.getName(), but in some cases a type may want to modify it's name for presentation to the user.
        Specified by:
        getDisplayName in interface IType
      • getRelativeName

        public String getRelativeName()
        Description copied from interface: IType
        The relative or unqualified name. For a class this should be just the class name without the package name.
        Specified by:
        getRelativeName in interface IType
      • getNameWithBoundingType

        public String getNameWithBoundingType()
      • getNamespace

        public String getNamespace()
        Description copied from interface: IType
        The namespace for this class. For a java class this will be the package, while for other types of intrinsic types it could be another logical name.
        Specified by:
        getNamespace in interface IType
      • getTypeLoader

        public ITypeLoader getTypeLoader()
        Description copied from interface: IType
        Returns the type loader responsible for loading this intrinsic type.
        Specified by:
        getTypeLoader in interface IType
      • isInterface

        public boolean isInterface()
        Description copied from interface: IType
        Returns true if this type is an interface.
        Specified by:
        isInterface in interface IType
      • isEnum

        public boolean isEnum()
        Description copied from interface: IType
        Returns true if this type is an enumeration.
        Specified by:
        isEnum in interface IType
      • getInterfaces

        public IType[] getInterfaces()
        Specified by:
        getInterfaces in interface IType
        Returns:
        If this is a class, returns a list of all the interfaces this type implements. Similarly, if this is an interface, returns a list of all the interfaces this type extends. In any case, returns an empty list if this type neither implements nor extends interfaces.
      • getSupertype

        public IType getSupertype()
        Description copied from interface: IType
        Returns the type representing the supertype of this type. Returns null if this type has no supertype.
        Specified by:
        getSupertype in interface IType
      • getEnclosingType

        public IType getEnclosingType()
        Description copied from interface: IType
        Returns the type immediately enclosing this type. If this type is not enclosed, returns null.
        Specified by:
        getEnclosingType in interface IType
      • getGenericType

        public IType getGenericType()
        Description copied from interface: IType
        If this is a parameterized type, returns the generic type this type parameterizes. Otherwise, returns null.
        Specified by:
        getGenericType in interface IType
      • isFinal

        public boolean isFinal()
        Description copied from interface: IType
        True if this type cannot be extended.
        Specified by:
        isFinal in interface IType
      • isParameterizedType

        public boolean isParameterizedType()
        Description copied from interface: IType
        Returns true if this ia a Parameterized Type.

        Note a Parameterzied Type is not the same as a Generic Type. The difference is that a Parameterized Type is a concrete version of a Generic Type. For instance, the class ArrayList is a Generic Type, while the class ArrayList is a Parameterized Type of the the Generic Type ArrayList.

        Specified by:
        isParameterizedType in interface IType
      • getGenericTypeVariables

        public GenericTypeVariable[] getGenericTypeVariables()
        Description copied from interface: IType
        Returns an array of GenericTypeVariables declared with this Generic Type. Otherwise, returns null if this is not a Generic Type.
        Specified by:
        getGenericTypeVariables in interface IType
      • getParameterizedType

        public IType getParameterizedType​(IType... ofType)
        Description copied from interface: IType
        Assuming this intrinsic type is a Generic type, return the parameterized type associated with the given list of type parameters. If the type has not been created yet, creates the parameterized type. Successive calls to this method having identical parameter types must return the identical parameterized type.
        Specified by:
        getParameterizedType in interface IType
        Parameters:
        ofType - The type parameters.
        Returns:
        The concrete type associated with the type parameters.
      • getTypeParameters

        public IType[] getTypeParameters()
        Description copied from interface: IType
        If this is a parameterized type, returns the specific types used to create this type, null otherwies.
        Specified by:
        getTypeParameters in interface IType
      • getAllTypesInHierarchy

        public Set<IType> getAllTypesInHierarchy()
        Description copied from interface: IType
        Returns a Set of all IIntrinsicTypes that this class is assignable from, including this class. This includes implemented interfaces and superclasses, recursively up the hieararchy. For array types, this will be a Set of all types that its component type is assignable from.
        Specified by:
        getAllTypesInHierarchy in interface IType
      • isArray

        public boolean isArray()
        Description copied from interface: IType
        True if this is an array.
        Specified by:
        isArray in interface IType
      • isPrimitive

        public boolean isPrimitive()
        Description copied from interface: IType
        True if this type represents a primitive type e.g., Java int, char, etc.
        Specified by:
        isPrimitive in interface IType
      • getArrayType

        public IType getArrayType()
        Description copied from interface: IType
        Make an array type from this type. E.g., String -> String[]
        Specified by:
        getArrayType in interface IType
      • makeArrayInstance

        public Object makeArrayInstance​(int iLength)
        Description copied from interface: IType
        Construct an array instance of specified length.
        Specified by:
        makeArrayInstance in interface IType
      • getArrayLength

        public int getArrayLength​(Object array)
                           throws IllegalArgumentException
        Description copied from interface: IType
        Returns the length of the specified array object.
        Specified by:
        getArrayLength in interface IType
        Parameters:
        array - An array instance of this intrinsic type.
        Returns:
        The length of the array.
        Throws:
        IllegalArgumentException - If the object argument is not an array.
      • getComponentType

        public IType getComponentType()
        Description copied from interface: IType
        If this is an array type, a type representing the component type of the array. Otherwise null.
        Specified by:
        getComponentType in interface IType
      • isAssignableFrom

        public boolean isAssignableFrom​(IType type)
        A type variable type is assignable only to/from itself or a reference thereof.

        For example:

           function foo( t: T, s: S )
           {
             t = s         // illegal, T and S may not have the same type at runtime
             t = "hello"   // illegal, T may not be a String
             var x: T = t  // ok, x and t are both of type T
           }
        Specified by:
        isAssignableFrom in interface IType
      • equals

        public boolean equals​(Object obj)
        Ok, here's the deal. By all rights type variable types should have identity equality. That's not the case right now for at least these two reasons:
        • We compile in multiple phases (header, decl, def). Each phase recompiles the header, including type vars. Each time a new type var type is created for the type var definition. It's not too hard to re-use the prior type var type, but then there's this problem...
        • If a subclass is generic and parameterizes its super with its type vars the super parameterizd type retains whatever the type var type from the first phase of the subclass' compilation. And, in studio, we don't refresh the type system, just the type we're editing. So the super class parameterized with the subclass' type vars and whatever else stemming from there that refs the type vars remains. So the subclass can be edited and refreshed a zillion time, but the super parameterized class will still have the type var from way back.
        Probably the best way to handle this is to make TypeVariableType a loadable type i.e., there will only ever be a single ref for a particular type var. The challege is not so much with class type vars, but with function type vars, since 1) we parse them before we parse the function's args we don't quite have a fq name (yay! for overloading), and 2) function types themselves are non-loadable and must remain that way as long as other types are permitted to be non-loadable. Specifically, since a param type in a function can be of any type, the fq name of the function may not be unique i.e., the reason a type is non-loadable is usually because it can't have a unique name. (yay! again for overloading)
        Overrides:
        equals in class Object
      • hashCode

        public int hashCode()
        Overrides:
        hashCode in class Object
      • isMutable

        public boolean isMutable()
        Description copied from interface: IType
        Are intances of this type mutable? Note sometimes it's difficult to determine. For instance, java classes don't contain any information about mutability. In which case we always assume mutable, even when the underlying type may in fact be immutable. E.g., even though java.lang.String is not mutable, its corresponding JavaIntrinsicType will say it is.
        Specified by:
        isMutable in interface IType
        Returns:
        True if this type is mutable.
      • getTypeInfo

        public ITypeInfo getTypeInfo()
        Description copied from interface: IType
        Get the type information for this intrinsic type.
        Specified by:
        getTypeInfo in interface IType
        See Also:
        ITypeInfo
      • unloadTypeInfo

        public void unloadTypeInfo()
        Description copied from interface: IType
        Unload or nullify any references to this IType's ITypeInfo.
        Specified by:
        unloadTypeInfo in interface IType
      • isValid

        public boolean isValid()
        Description copied from interface: IType
        Defines this type if it is not yet fully defined. For instance, if this type has source code associated with it, it must fully compile the source for it to be fully defined.
        Specified by:
        isValid in interface IType
        Returns:
        true if this type is valid.
      • getModifiers

        public int getModifiers()
        Description copied from interface: IType
        Returns the modifiers for this type, encoded in an integer. The modifiers consist of the constants for public, protected, private, final, static, abstract they should be decoded using the methods of class Modifier.
        Specified by:
        getModifiers in interface IType
        See Also:
        Modifier
      • isAbstract

        public boolean isAbstract()
        Specified by:
        isAbstract in interface IType
      • isDiscarded

        public boolean isDiscarded()
        Description copied from interface: IType
        True if this type has been replaced with a newer version of the same name in the type system.
        Specified by:
        isDiscarded in interface IType
      • setDiscarded

        public void setDiscarded​(boolean bDiscarded)
        Specified by:
        setDiscarded in interface IType
      • isCompoundType

        public boolean isCompoundType()
        Specified by:
        isCompoundType in interface IType