262 lines
5.8 KiB
C#
262 lines
5.8 KiB
C#
//
|
|
// Author:
|
|
// Jb Evain (jbevain@gmail.com)
|
|
//
|
|
// Copyright (c) 2008 - 2015 Jb Evain
|
|
// Copyright (c) 2008 - 2011 Novell, Inc.
|
|
//
|
|
// Licensed under the MIT/X11 license.
|
|
//
|
|
|
|
using System;
|
|
using System.Collections.Generic;
|
|
using System.Text;
|
|
|
|
namespace MonoFN.Cecil.Rocks {
|
|
|
|
public class DocCommentId {
|
|
StringBuilder id;
|
|
|
|
DocCommentId ()
|
|
{
|
|
id = new StringBuilder ();
|
|
}
|
|
|
|
void WriteField (FieldDefinition field)
|
|
{
|
|
WriteDefinition ('F', field);
|
|
}
|
|
|
|
void WriteEvent (EventDefinition @event)
|
|
{
|
|
WriteDefinition ('E', @event);
|
|
}
|
|
|
|
void WriteType (TypeDefinition type)
|
|
{
|
|
id.Append ('T').Append (':');
|
|
WriteTypeFullName (type);
|
|
}
|
|
|
|
void WriteMethod (MethodDefinition method)
|
|
{
|
|
WriteDefinition ('M', method);
|
|
|
|
if (method.HasGenericParameters) {
|
|
id.Append ('`').Append ('`');
|
|
id.Append (method.GenericParameters.Count);
|
|
}
|
|
|
|
if (method.HasParameters)
|
|
WriteParameters (method.Parameters);
|
|
|
|
if (IsConversionOperator (method))
|
|
WriteReturnType (method);
|
|
}
|
|
|
|
static bool IsConversionOperator (MethodDefinition self)
|
|
{
|
|
if (self == null)
|
|
throw new ArgumentNullException ("self");
|
|
|
|
return self.IsSpecialName
|
|
&& (self.Name == "op_Explicit" || self.Name == "op_Implicit");
|
|
}
|
|
|
|
void WriteReturnType (MethodDefinition method)
|
|
{
|
|
id.Append ('~');
|
|
WriteTypeSignature (method.ReturnType);
|
|
}
|
|
|
|
void WriteProperty (PropertyDefinition property)
|
|
{
|
|
WriteDefinition ('P', property);
|
|
|
|
if (property.HasParameters)
|
|
WriteParameters (property.Parameters);
|
|
}
|
|
|
|
void WriteParameters (IList<ParameterDefinition> parameters)
|
|
{
|
|
id.Append ('(');
|
|
WriteList (parameters, p => WriteTypeSignature (p.ParameterType));
|
|
id.Append (')');
|
|
}
|
|
|
|
void WriteTypeSignature (TypeReference type)
|
|
{
|
|
switch (type.MetadataType) {
|
|
case MetadataType.Array:
|
|
WriteArrayTypeSignature ((ArrayType)type);
|
|
break;
|
|
case MetadataType.ByReference:
|
|
WriteTypeSignature (((ByReferenceType)type).ElementType);
|
|
id.Append ('@');
|
|
break;
|
|
case MetadataType.FunctionPointer:
|
|
WriteFunctionPointerTypeSignature ((FunctionPointerType)type);
|
|
break;
|
|
case MetadataType.GenericInstance:
|
|
WriteGenericInstanceTypeSignature ((GenericInstanceType)type);
|
|
break;
|
|
case MetadataType.Var:
|
|
id.Append ('`');
|
|
id.Append (((GenericParameter)type).Position);
|
|
break;
|
|
case MetadataType.MVar:
|
|
id.Append ('`').Append ('`');
|
|
id.Append (((GenericParameter)type).Position);
|
|
break;
|
|
case MetadataType.OptionalModifier:
|
|
WriteModiferTypeSignature ((OptionalModifierType)type, '!');
|
|
break;
|
|
case MetadataType.RequiredModifier:
|
|
WriteModiferTypeSignature ((RequiredModifierType)type, '|');
|
|
break;
|
|
case MetadataType.Pointer:
|
|
WriteTypeSignature (((PointerType)type).ElementType);
|
|
id.Append ('*');
|
|
break;
|
|
default:
|
|
WriteTypeFullName (type);
|
|
break;
|
|
}
|
|
}
|
|
|
|
void WriteGenericInstanceTypeSignature (GenericInstanceType type)
|
|
{
|
|
if (type.ElementType.IsTypeSpecification ())
|
|
throw new NotSupportedException ();
|
|
|
|
WriteTypeFullName (type.ElementType, stripGenericArity: true);
|
|
id.Append ('{');
|
|
WriteList (type.GenericArguments, WriteTypeSignature);
|
|
id.Append ('}');
|
|
}
|
|
|
|
void WriteList<T> (IList<T> list, Action<T> action)
|
|
{
|
|
for (int i = 0; i < list.Count; i++) {
|
|
if (i > 0)
|
|
id.Append (',');
|
|
|
|
action (list [i]);
|
|
}
|
|
}
|
|
|
|
void WriteModiferTypeSignature (IModifierType type, char id)
|
|
{
|
|
WriteTypeSignature (type.ElementType);
|
|
this.id.Append (id);
|
|
WriteTypeSignature (type.ModifierType);
|
|
}
|
|
|
|
void WriteFunctionPointerTypeSignature (FunctionPointerType type)
|
|
{
|
|
id.Append ("=FUNC:");
|
|
WriteTypeSignature (type.ReturnType);
|
|
|
|
if (type.HasParameters)
|
|
WriteParameters (type.Parameters);
|
|
}
|
|
|
|
void WriteArrayTypeSignature (ArrayType type)
|
|
{
|
|
WriteTypeSignature (type.ElementType);
|
|
|
|
if (type.IsVector) {
|
|
id.Append ("[]");
|
|
return;
|
|
}
|
|
|
|
id.Append ("[");
|
|
|
|
WriteList (type.Dimensions, dimension => {
|
|
if (dimension.LowerBound.HasValue)
|
|
id.Append (dimension.LowerBound.Value);
|
|
|
|
id.Append (':');
|
|
|
|
if (dimension.UpperBound.HasValue)
|
|
id.Append (dimension.UpperBound.Value - (dimension.LowerBound.GetValueOrDefault () + 1));
|
|
});
|
|
|
|
id.Append ("]");
|
|
}
|
|
|
|
void WriteDefinition (char id, IMemberDefinition member)
|
|
{
|
|
this.id.Append (id)
|
|
.Append (':');
|
|
|
|
WriteTypeFullName (member.DeclaringType);
|
|
this.id.Append ('.');
|
|
WriteItemName (member.Name);
|
|
}
|
|
|
|
void WriteTypeFullName (TypeReference type, bool stripGenericArity = false)
|
|
{
|
|
if (type.DeclaringType != null) {
|
|
WriteTypeFullName (type.DeclaringType);
|
|
id.Append ('.');
|
|
}
|
|
|
|
if (!string.IsNullOrEmpty (type.Namespace)) {
|
|
id.Append (type.Namespace);
|
|
id.Append ('.');
|
|
}
|
|
|
|
var name = type.Name;
|
|
|
|
if (stripGenericArity) {
|
|
var index = name.LastIndexOf ('`');
|
|
if (index > 0)
|
|
name = name.Substring (0, index);
|
|
}
|
|
|
|
id.Append (name);
|
|
}
|
|
|
|
void WriteItemName (string name)
|
|
{
|
|
id.Append (name.Replace ('.', '#').Replace ('<', '{').Replace ('>', '}'));
|
|
}
|
|
|
|
public override string ToString ()
|
|
{
|
|
return id.ToString ();
|
|
}
|
|
|
|
public static string GetDocCommentId (IMemberDefinition member)
|
|
{
|
|
if (member == null)
|
|
throw new ArgumentNullException ("member");
|
|
|
|
var documentId = new DocCommentId ();
|
|
|
|
switch (member.MetadataToken.TokenType) {
|
|
case TokenType.Field:
|
|
documentId.WriteField ((FieldDefinition)member);
|
|
break;
|
|
case TokenType.Method:
|
|
documentId.WriteMethod ((MethodDefinition)member);
|
|
break;
|
|
case TokenType.TypeDef:
|
|
documentId.WriteType ((TypeDefinition)member);
|
|
break;
|
|
case TokenType.Event:
|
|
documentId.WriteEvent ((EventDefinition)member);
|
|
break;
|
|
case TokenType.Property:
|
|
documentId.WriteProperty ((PropertyDefinition)member);
|
|
break;
|
|
default:
|
|
throw new NotSupportedException (member.FullName);
|
|
}
|
|
|
|
return documentId.ToString ();
|
|
}
|
|
}
|
|
}
|