mirror of https://github.com/icsharpcode/ILSpy.git
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
354 lines
17 KiB
354 lines
17 KiB
// Copyright (c) 2010-2013 AlphaSierraPapa for the SharpDevelop Team |
|
// |
|
// Permission is hereby granted, free of charge, to any person obtaining a copy of this |
|
// software and associated documentation files (the "Software"), to deal in the Software |
|
// without restriction, including without limitation the rights to use, copy, modify, merge, |
|
// publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons |
|
// to whom the Software is furnished to do so, subject to the following conditions: |
|
// |
|
// The above copyright notice and this permission notice shall be included in all copies or |
|
// substantial portions of the Software. |
|
// |
|
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, |
|
// INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR |
|
// PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE |
|
// FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR |
|
// OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
|
// DEALINGS IN THE SOFTWARE. |
|
|
|
#nullable enable |
|
|
|
using System; |
|
using System.Collections.Generic; |
|
|
|
namespace ICSharpCode.Decompiler.TypeSystem |
|
{ |
|
/// <summary> |
|
/// This interface represents a resolved type in the type system. |
|
/// </summary> |
|
/// <remarks> |
|
/// <para> |
|
/// A type is potentially |
|
/// - a type definition (<see cref="ITypeDefinition"/>, i.e. a class, struct, interface, delegate, or built-in primitive type) |
|
/// - a parameterized type (<see cref="ParameterizedType"/>, e.g. List<int>) |
|
/// - a type parameter (<see cref="ITypeParameter"/>, e.g. T) |
|
/// - an array (<see cref="ArrayType"/>) |
|
/// - a pointer (<see cref="PointerType"/>) |
|
/// - a managed reference (<see cref="ByReferenceType"/>) |
|
/// - one of the special types (<see cref="SpecialType.UnknownType"/>, <see cref="SpecialType.NullType"/>, |
|
/// <see cref="SpecialType.Dynamic"/>, <see cref="SpecialType.UnboundTypeArgument"/>) |
|
/// |
|
/// The <see cref="IType.Kind"/> property can be used to switch on the kind of a type. |
|
/// </para> |
|
/// <para> |
|
/// IType uses the null object pattern: <see cref="SpecialType.UnknownType"/> serves as the null object. |
|
/// Methods or properties returning IType never return null unless documented otherwise. |
|
/// </para> |
|
/// <para> |
|
/// Types should be compared for equality using the <see cref="IEquatable{IType}.Equals(IType)"/> method. |
|
/// Identical types do not necessarily use the same object reference. |
|
/// </para> |
|
/// </remarks> |
|
public interface IType : INamedElement, IEquatable<IType> |
|
{ |
|
/// <summary> |
|
/// Gets the type kind. |
|
/// </summary> |
|
TypeKind Kind { get; } |
|
|
|
/// <summary> |
|
/// Gets whether the type is a reference type or value type. |
|
/// </summary> |
|
/// <returns> |
|
/// true, if the type is a reference type. |
|
/// false, if the type is a value type. |
|
/// null, if the type is not known (e.g. unconstrained generic type parameter or type not found) |
|
/// </returns> |
|
bool? IsReferenceType { get; } |
|
|
|
/// <summary> |
|
/// Gets whether this type is "ref-like": a ByReferenceType or "ref struct". |
|
/// </summary> |
|
bool IsByRefLike { get; } |
|
|
|
/// <summary> |
|
/// Gets the nullability annotation on this type. |
|
/// </summary> |
|
Nullability Nullability { get; } |
|
|
|
/// <summary> |
|
/// Creates a new type that is a copy of this type, with the changed nullability annotation. |
|
/// </summary> |
|
IType ChangeNullability(Nullability newNullability); |
|
|
|
/// <summary> |
|
/// Gets the underlying type definition. |
|
/// Can return null for types which do not have a type definition (for example arrays, pointers, type parameters). |
|
/// </summary> |
|
ITypeDefinition? GetDefinition(); |
|
|
|
/// <summary> |
|
/// Gets the underlying type definition or UnkownType, if unknown. |
|
/// Can return null for types which do not have a type definition (for example arrays, pointers, type parameters). |
|
/// </summary> |
|
ITypeDefinitionOrUnknown? GetDefinitionOrUnknown(); |
|
|
|
/// <summary> |
|
/// Gets the parent type, if this is a nested type. |
|
/// Returns null for top-level types. |
|
/// </summary> |
|
IType? DeclaringType { get; } |
|
|
|
/// <summary> |
|
/// Gets the number of type parameters. |
|
/// </summary> |
|
int TypeParameterCount { get; } |
|
|
|
/// <summary> |
|
/// Gets the type parameters. |
|
/// Returns an empty list if this type is not generic. |
|
/// </summary> |
|
IReadOnlyList<ITypeParameter> TypeParameters { get; } |
|
|
|
/// <summary> |
|
/// Gets the type arguments passed to this type. |
|
/// If this type is a generic type definition that is not parameterized, this property returns the type parameters, |
|
/// as if the type was parameterized with its own type arguments (<c>class C<T> { C<T> field; }</c>). |
|
/// </summary> |
|
IReadOnlyList<IType> TypeArguments { get; } |
|
|
|
/// <summary> |
|
/// Calls ITypeVisitor.Visit for this type. |
|
/// </summary> |
|
/// <returns>The return value of the ITypeVisitor.Visit call</returns> |
|
IType AcceptVisitor(TypeVisitor visitor); |
|
|
|
/// <summary> |
|
/// Calls ITypeVisitor.Visit for all children of this type, and reconstructs this type with the children based |
|
/// on the return values of the visit calls. |
|
/// </summary> |
|
/// <returns>A copy of this type, with all children replaced by the return value of the corresponding visitor call. |
|
/// If the visitor returned the original types for all children (or if there are no children), returns <c>this</c>. |
|
/// </returns> |
|
IType VisitChildren(TypeVisitor visitor); |
|
|
|
/// <summary> |
|
/// Gets the direct base types. |
|
/// </summary> |
|
/// <returns>Returns the direct base types including interfaces</returns> |
|
IEnumerable<IType> DirectBaseTypes { get; } |
|
|
|
/// <summary> |
|
/// Gets a type visitor that performs the substitution of class type parameters with the type arguments |
|
/// of this parameterized type. |
|
/// Returns TypeParameterSubstitution.Identity if the type is not parametrized. |
|
/// </summary> |
|
TypeParameterSubstitution GetSubstitution(); |
|
|
|
/// <summary> |
|
/// Gets inner classes (including inherited inner classes). |
|
/// </summary> |
|
/// <param name="filter">The filter used to select which types to return. |
|
/// The filter is tested on the original type definitions (before parameterization).</param> |
|
/// <param name="options">Specified additional options for the GetMembers() operation.</param> |
|
/// <remarks> |
|
/// <para> |
|
/// If the nested type is generic, this method will return a parameterized type, |
|
/// where the additional type parameters are set to <see cref="SpecialType.UnboundTypeArgument"/>. |
|
/// </para> |
|
/// <para> |
|
/// Type parameters belonging to the outer class will have the value copied from the outer type |
|
/// if it is a parameterized type. Otherwise, those existing type parameters will be self-parameterized, |
|
/// and thus 'leaked' to the caller in the same way the GetMembers() method does not specialize members |
|
/// from an <see cref="ITypeDefinition"/> and 'leaks' type parameters in member signatures. |
|
/// </para> |
|
/// </remarks> |
|
/// <example> |
|
/// <code> |
|
/// class Base<T> { |
|
/// class Nested<X> {} |
|
/// } |
|
/// class Derived<A, B> : Base<B> {} |
|
/// |
|
/// Derived[string,int].GetNestedTypes() = { Base`1+Nested`1[int, unbound] } |
|
/// Derived.GetNestedTypes() = { Base`1+Nested`1[`1, unbound] } |
|
/// Base[`1].GetNestedTypes() = { Base`1+Nested`1[`1, unbound] } |
|
/// Base.GetNestedTypes() = { Base`1+Nested`1[`0, unbound] } |
|
/// </code> |
|
/// </example> |
|
IEnumerable<IType> GetNestedTypes(Predicate<ITypeDefinition>? filter = null, GetMemberOptions options = GetMemberOptions.None); |
|
|
|
// Note that we cannot 'leak' the additional type parameter as we leak the normal type parameters, because |
|
// the index might collide. For example, |
|
// class Base<T> { class Nested<X> {} } |
|
// class Derived<A, B> : Base<B> { } |
|
// |
|
// Derived<string, int>.GetNestedTypes() = Base+Nested<int, UnboundTypeArgument> |
|
// Derived.GetNestedTypes() = Base+Nested<`1, > |
|
// Here `1 refers to B, and there's no way to return X as it would collide with B. |
|
|
|
/// <summary> |
|
/// Gets inner classes (including inherited inner classes) |
|
/// that have <c>typeArguments.Count</c> additional type parameters. |
|
/// </summary> |
|
/// <param name="typeArguments">The type arguments passed to the inner class</param> |
|
/// <param name="filter">The filter used to select which types to return. |
|
/// The filter is tested on the original type definitions (before parameterization).</param> |
|
/// <param name="options">Specified additional options for the GetMembers() operation.</param> |
|
/// <remarks> |
|
/// Type parameters belonging to the outer class will have the value copied from the outer type |
|
/// if it is a parameterized type. Otherwise, those existing type parameters will be self-parameterized, |
|
/// and thus 'leaked' to the caller in the same way the GetMembers() method does not specialize members |
|
/// from an <see cref="ITypeDefinition"/> and 'leaks' type parameters in member signatures. |
|
/// </remarks> |
|
IEnumerable<IType> GetNestedTypes(IReadOnlyList<IType> typeArguments, Predicate<ITypeDefinition>? filter = null, GetMemberOptions options = GetMemberOptions.None); |
|
|
|
/// <summary> |
|
/// Gets all instance constructors for this type. |
|
/// </summary> |
|
/// <param name="filter">The filter used to select which constructors to return. |
|
/// The filter is tested on the original method definitions (before specialization).</param> |
|
/// <param name="options">Specified additional options for the GetMembers() operation.</param> |
|
/// <remarks> |
|
/// <para>The result does not include static constructors. |
|
/// Constructors in base classes are not returned by default, as GetMemberOptions.IgnoreInheritedMembers is the default value.</para> |
|
/// <para> |
|
/// For methods on parameterized types, type substitution will be performed on the method signature, |
|
/// and the appropriate <see cref="Implementation.SpecializedMethod"/> will be returned. |
|
/// </para> |
|
/// </remarks> |
|
IEnumerable<IMethod> GetConstructors(Predicate<IMethod>? filter = null, GetMemberOptions options = GetMemberOptions.IgnoreInheritedMembers); |
|
|
|
/// <summary> |
|
/// Gets all methods that can be called on this type. |
|
/// </summary> |
|
/// <param name="filter">The filter used to select which methods to return. |
|
/// The filter is tested on the original method definitions (before specialization).</param> |
|
/// <param name="options">Specified additional options for the GetMembers() operation.</param> |
|
/// <remarks> |
|
/// <para> |
|
/// The result does not include constructors or accessors. |
|
/// </para> |
|
/// <para> |
|
/// For methods on parameterized types, type substitution will be performed on the method signature, |
|
/// and the appropriate <see cref="Implementation.SpecializedMethod"/> will be returned. |
|
/// </para> |
|
/// <para> |
|
/// If the method being returned is generic, and this type is a parameterized type where the type |
|
/// arguments involve another method's type parameters, the resulting specialized signature |
|
/// will be ambiguous as to which method a type parameter belongs to. |
|
/// For example, "List[[``0]].GetMethods()" will return "ConvertAll(Converter`2[[``0, ``0]])". |
|
/// |
|
/// If possible, use the other GetMethods() overload to supply type arguments to the method, |
|
/// so that both class and method type parameter can be substituted at the same time, so that |
|
/// the ambiguity can be avoided. |
|
/// </para> |
|
/// </remarks> |
|
IEnumerable<IMethod> GetMethods(Predicate<IMethod>? filter = null, GetMemberOptions options = GetMemberOptions.None); |
|
|
|
/// <summary> |
|
/// Gets all generic methods that can be called on this type with the specified type arguments. |
|
/// </summary> |
|
/// <param name="typeArguments">The type arguments used for the method call.</param> |
|
/// <param name="filter">The filter used to select which methods to return. |
|
/// The filter is tested on the original method definitions (before specialization).</param> |
|
/// <param name="options">Specified additional options for the GetMembers() operation.</param> |
|
/// <remarks> |
|
/// <para>The result does not include constructors or accessors.</para> |
|
/// <para> |
|
/// Type substitution will be performed on the method signature, creating a <see cref="Implementation.SpecializedMethod"/> |
|
/// with the specified type arguments. |
|
/// </para> |
|
/// <para> |
|
/// When the list of type arguments is empty, this method acts like the GetMethods() overload without |
|
/// the type arguments parameter - that is, it also returns generic methods, |
|
/// and the other overload's remarks about ambiguous signatures apply here as well. |
|
/// </para> |
|
/// </remarks> |
|
IEnumerable<IMethod> GetMethods(IReadOnlyList<IType> typeArguments, Predicate<IMethod>? filter = null, GetMemberOptions options = GetMemberOptions.None); |
|
|
|
/// <summary> |
|
/// Gets all properties that can be called on this type. |
|
/// </summary> |
|
/// <param name="filter">The filter used to select which properties to return. |
|
/// The filter is tested on the original property definitions (before specialization).</param> |
|
/// <param name="options">Specified additional options for the GetMembers() operation.</param> |
|
/// <remarks> |
|
/// For properties on parameterized types, type substitution will be performed on the property signature, |
|
/// and the appropriate <see cref="Implementation.SpecializedProperty"/> will be returned. |
|
/// </remarks> |
|
IEnumerable<IProperty> GetProperties(Predicate<IProperty>? filter = null, GetMemberOptions options = GetMemberOptions.None); |
|
|
|
/// <summary> |
|
/// Gets all fields that can be accessed on this type. |
|
/// </summary> |
|
/// <param name="filter">The filter used to select which constructors to return. |
|
/// The filter is tested on the original field definitions (before specialization).</param> |
|
/// <param name="options">Specified additional options for the GetMembers() operation.</param> |
|
/// <remarks> |
|
/// For fields on parameterized types, type substitution will be performed on the field's return type, |
|
/// and the appropriate <see cref="Implementation.SpecializedField"/> will be returned. |
|
/// </remarks> |
|
IEnumerable<IField> GetFields(Predicate<IField>? filter = null, GetMemberOptions options = GetMemberOptions.None); |
|
|
|
/// <summary> |
|
/// Gets all events that can be accessed on this type. |
|
/// </summary> |
|
/// <param name="filter">The filter used to select which events to return. |
|
/// The filter is tested on the original event definitions (before specialization).</param> |
|
/// <param name="options">Specified additional options for the GetMembers() operation.</param> |
|
/// <remarks> |
|
/// For fields on parameterized types, type substitution will be performed on the event's return type, |
|
/// and the appropriate <see cref="Implementation.SpecializedEvent"/> will be returned. |
|
/// </remarks> |
|
IEnumerable<IEvent> GetEvents(Predicate<IEvent>? filter = null, GetMemberOptions options = GetMemberOptions.None); |
|
|
|
/// <summary> |
|
/// Gets all members that can be called on this type. |
|
/// </summary> |
|
/// <param name="filter">The filter used to select which members to return. |
|
/// The filter is tested on the original member definitions (before specialization).</param> |
|
/// <param name="options">Specified additional options for the GetMembers() operation.</param> |
|
/// <remarks> |
|
/// <para> |
|
/// The resulting list is the union of GetFields(), GetProperties(), GetMethods() and GetEvents(). |
|
/// It does not include constructors. |
|
/// For parameterized types, type substitution will be performed. |
|
/// </para> |
|
/// <para> |
|
/// For generic methods, the remarks about ambiguous signatures from the |
|
/// <see cref="GetMethods(Predicate{IMethod}, GetMemberOptions)"/> method apply here as well. |
|
/// </para> |
|
/// </remarks> |
|
IEnumerable<IMember> GetMembers(Predicate<IMember>? filter = null, GetMemberOptions options = GetMemberOptions.None); |
|
|
|
/// <summary> |
|
/// Gets all accessors belonging to properties or events on this type. |
|
/// </summary> |
|
/// <param name="filter">The filter used to select which members to return. |
|
/// The filter is tested on the original member definitions (before specialization).</param> |
|
/// <param name="options">Specified additional options for the GetMembers() operation.</param> |
|
/// <remarks> |
|
/// Accessors are not returned by GetMembers() or GetMethods(). |
|
/// </remarks> |
|
IEnumerable<IMethod> GetAccessors(Predicate<IMethod>? filter = null, GetMemberOptions options = GetMemberOptions.None); |
|
} |
|
|
|
[Flags] |
|
public enum GetMemberOptions |
|
{ |
|
/// <summary> |
|
/// No options specified - this is the default. |
|
/// Members will be specialized, and inherited members will be included. |
|
/// </summary> |
|
None = 0x00, |
|
/// <summary> |
|
/// Do not specialize the returned members - directly return the definitions. |
|
/// </summary> |
|
ReturnMemberDefinitions = 0x01, |
|
/// <summary> |
|
/// Do not list inherited members - only list members defined directly on this type. |
|
/// </summary> |
|
IgnoreInheritedMembers = 0x02 |
|
} |
|
}
|
|
|