在编译时强制执行狭义的隐式强制

时间:2015-09-30 18:19:53

标签: c# compile-time coercion

我正在尝试定义一个结构,该结构使用具有受限制的数字范围的变量,以及来自整数的隐式强制。如果在此结构中使用任何常量或其他硬编码值,我希望能够强制构建错误。

这是我想要完成的一个例子。

    byte a = 123; // Allowed
    byte b = 123123; // Not allowed
    const int x = 123;
    const int y = 123123;
    byte c = x; // Allowed
    byte d = y; // Not allowed

理想情况下,我希望能够将数字限制在1到99之间,以便MyStruct s = 50;但是MyStruct s = 150;导致编译时错误,如上面的字节b和d。

我找到了something similar for a different language,但没有找到C#。

1 个答案:

答案 0 :(得分:1)

我认为您可以通过使用自定义属性和roslyn代码分析来实现此目的。让我勾勒一个解决方案。这应该至少解决用文字初始化的第一个用例。

首先,您需要一个适用于您的结构的自定义属性,以允许代码分析能够知道有效范围:

[AttributeUsage(System.AttributeTargets.Struct)]
public class MinMaxSizeAttribute : Attribute
{
    public int MinVal { get; set;}
    public int MaxVal { get; set;}
    public MinMaxSizeAttribute()
    {
    }
}

您在此处执行的操作是将最小值和最大值存储在属性中。这样,您可以稍后在源代码分析中使用它。

现在将此属性应用于struct声明:

[MinMaxSize(MinVal = 0, MaxVal = 100)]
public struct Foo
{
    //members and implicit conversion operators go here
}

现在struct Foo的类型信息包含值范围。接下来您需要DiagnosticAnalyzer来分析您的代码。

public class MyAnalyzer : DiagnosticAnalyzer
{
    internal static DiagnosticDescriptor Rule = new DiagnosticDescriptor("CS00042", 
        "Value not allowed here",
        @"Type {0} does not allow Values in this range", 
        "type checker", 
        DiagnosticSeverity.Error,
        isEnabledByDefault: true, description: "Value to big");
    public MyAnalyzer()
    {
    }

    #region implemented abstract members of DiagnosticAnalyzer

    public override void Initialize(AnalysisContext context)
    {
        context.RegisterSyntaxNodeAction(AnalyzeSyntaxTree, SyntaxKind.SimpleAssignmentExpression);
    }

    public override ImmutableArray<DiagnosticDescriptor> SupportedDiagnostics => ImmutableArray.Create(Rule);

    #endregion

    private static void AnalyzeSyntaxTree(SyntaxNodeAnalysisContext context)
    {

    }
}

这是参与代码分析的裸骨架。分析仪注册以分析分配:

context.RegisterSyntaxNodeAction(AnalyzeSyntaxTree, SyntaxKind.SimpleAssignmentExpression);

对于变量声明,您需要注册一个不同的SyntaxKind,但为了简单起见,我将在这里坚持一个。

让我们看一下分析逻辑:

private static void AnalyzeSyntaxTree(SyntaxNodeAnalysisContext context)
        {
            if (context.Node.IsKind(SyntaxKind.SimpleAssignmentExpression))
            {
                var assign = (AssignmentExpressionSyntax)context.Node;
                var leftType = context.SemanticModel.GetTypeInfo(assign.Left).GetType();
                var attr = leftType.GetCustomAttributes(typeof(MinMaxSizeAttribute), false).OfType<MinMaxSizeAttribute>().FirstOrDefault();
                if (attr != null && assign.Right.IsKind(SyntaxKind.NumericLiteralExpression))
                {
                    var numLitteral = (LiteralExpressionSyntax)assign.Right;
                    var t = numLitteral.Token;
                    if (t.Value.GetType().Equals(typeof(int)))
                    {
                        var intVal = (int)t.Value;
                        if (intVal > attr.MaxVal || intVal < attr.MaxVal)
                        {
                            Diagnostic.Create(Rule, assign.GetLocation(), leftType.Name);
                        }
                    }
                }
            }
        }

分析器的作用是检查左侧的类型是否与MinMaxSize相关联,如果是,则检查右侧是否为文字。当它是文字时,它会尝试获取整数值,并将其与与该类型相关联的MinValMaxVal进行比较。如果值超出该范围,则会报告诊断错误。

请注意,所有这些代码大多未经测试。它编译并通过了一些基本测试。但它只是为了说明一个可能的解决方案。有关详细信息,请查看Rsolyn Docs

您希望涵盖的第二种情况更为复杂,因为您需要应用dataflow analyzes来获取x的值。