out参数不用赋值？这么神奇吗！

Posted 2022-04-01 My空格IO

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了out参数不用赋值？这么神奇吗！相关的知识，希望对你有一定的参考价值。

首先提醒大家一下，docs.microsoft.com上的《C# 指南》是这样描述out 参数修饰符^[1]的：

作为 out 参数传递的变量在方法调用中传递之前不必进行初始化。但是，被调用的方法需要在返回之前赋一个值。

请注意上面加粗的话，然后看看下面的代码片段，你觉得它能否编译通过：

private void Test(out System.Reflection.ParameterModifier obj)
 
//什么也不做

如果你很肯定地回答“不能”，那么恭喜你——答错了。我当初看到这段代码的第一感觉也是不能，但发现代码确实能够编译通过。

分析原因

难道是语法改变了，官方文档没更新？ 我又测试了一下：

private void Test2(out string obj)//编译失败
 

private void Test3(out int obj)//编译失败

out参数不用赋值？这么神奇吗！_字段

难道这个类型有什么特殊之处？ 我把dotnet/runtime中的ParameterModifier源代码^[2]复制到本地项目,编译同样提示CS0177错误，WTF！！！

private void Test(out ParameterModifier obj)
 

public readonly struct ParameterModifier

    private readonly bool[] _byRef;

    public ParameterModifier(int parameterCount)
    
        if (parameterCount <= 0)
            throw new ArgumentException();

        _byRef = new bool[parameterCount];
    

    public bool this[int index]
    
        get => _byRef[index];
        set => _byRef[index] = value;
    

#if CORECLR
    internal bool[] IsByRefArray => _byRef;
#endif

out参数不用赋值？这么神奇吗！_编译错误_02

深入Roslyn

应该是编译器做了什么特殊处理！

于是我clone了dotnet/roslyn源代码^[3],本来想调试源代码的，结果由于编译时依赖包一直下载不下来，干脆直接读源代码了。

通过查找错误提示"must be assigned to before control leaves the current method"，定位到CSharpResources.resx，确认错误编码为ERR_ParamUnassigned:

<data name="ERR_ParamUnassigned" xml:space="preserve">
    <value>The out parameter 0 must be assigned to before control leaves the current method</value>
  </data>

查找ERR_ParamUnassigned，定位到了编译错误信息被添加的位置（DefiniteAssignment.cs文件内的ReportUnassignedOutParameter方法）；

protected virtual void ReportUnassignedOutParameter(ParameterSymbol parameter, SyntaxNode node, Location location)

    ......
    if (Diagnostics != null && this.State.Reachable)
    
        ......

        if (!reported)
        
            Debug.Assert(!parameter.IsThis);
            Diagnostics.Add(ErrorCode.ERR_ParamUnassigned, location, parameter.Name);

因为同样的方法定义，只是参数类型不一样导致编译报错，因此猜测这个方法肯定进入了，只是this.State.Reachable值不同的原因，Reachable的代码如下：

public bool Reachable

    get
    
        return Assigned.Capacity <= 0 || !IsAssigned(0);
    

public bool IsAssigned(int slot)

    return /*(slot == -1) || */Assigned[slot];


public void Assign(int slot)

    if (slot == -1)
        return;
    Assigned[slot] = true;

继续查找Assign的调用位置，发现一段很有意思的代码：

Debug.Assert(!_emptyStructTypeCache.IsEmptyStructType(type));
......
state.Assign(slot);

IsEmptyStructType是不是意味着空Struct不检查？立马来试试：

private void Test(out EmptyStruct obj)///编译通过
 


public struct EmptyStruct

继续探究

但是ParameterModifier明显不是空Struct,而且更奇怪的是为什么将源代码复制到本地项目又不能编译了。 带着这个疑问，我们继续深挖：

private bool IsEmptyStructType(TypeSymbol type, ConsList<NamedTypeSymbol> typesWithMembersOfThisType)

    ......
    result = CheckStruct(typesWithMembersOfThisType, nts);
    ......
    return result;


private bool CheckStruct(ConsList<NamedTypeSymbol> typesWithMembersOfThisType, NamedTypeSymbol nts)

    if (!typesWithMembersOfThisType.ContainsReference(nts))
    
        ......
        return CheckStructInstanceFields(typesWithMembersOfThisType, nts);
    

    return true;

private bool CheckStructInstanceFields(ConsList<NamedTypeSymbol> typesWithMembersOfThisType, NamedTypeSymbol type)

    // PERF: we get members of the OriginalDefinition to not create substituted members/types 
    //       unless necessary.
    foreach (var member in type.OriginalDefinition.GetMembersUnordered())
    
        if (member.IsStatic)
        
            continue;
        
        var field = GetActualField(member, type);
        if ((object)field != null)
        
            var actualFieldType = field.Type;
            if (!IsEmptyStructType(actualFieldType, typesWithMembersOfThisType))
            
                return false;
            
        
    

    return true;

代码检查每个字段的类型是否是“空Struct”。这意味着如果所有实例字段都是“空Struct”，则原始类型也被视为“空Struct”，否则为“非空Struct”。看来关键就在GetActualField了：

private FieldSymbol GetActualField(Symbol member, NamedTypeSymbol type)

    switch (member.Kind)
    
        case SymbolKind.Field:
            var field = (FieldSymbol)member;
            // Do not report virtual tuple fields.
            // They are additional aliases to the fields of the underlying struct or nested extensions.
            // and as such are already accounted for via the nonvirtual fields.
            if (field.IsVirtualTupleField)
            
                return null;
            

            return (field.IsFixedSizeBuffer || ShouldIgnoreStructField(field, field.Type)) ? null : field.AsMember(type);

        case SymbolKind.Event:
            var eventSymbol = (EventSymbol)member;
            return (!eventSymbol.HasAssociatedField || ShouldIgnoreStructField(eventSymbol, eventSymbol.Type)) ? null : eventSymbol.AssociatedField.AsMember(type);
    

    return null;


private bool ShouldIgnoreStructField(Symbol member, TypeSymbol memberType)

    return _dev12CompilerCompatibility &&                             // when were trying to be compatible with the native compiler, we ignore
           ((object)member.ContainingAssembly != _sourceAssembly ||   // imported fields
            member.ContainingModule.Ordinal != 0) &&                      //     (an added module is imported)
           IsIgnorableType(memberType) &&                                 // of reference type (but not type parameters, looking through arrays)
           !IsAccessibleInAssembly(member, _sourceAssembly);          // that are inaccessible to our assembly.

必须是Struct和代码不在同一个程序集（((object)member.ContainingAssembly != _sourceAssembly），字段类型必须是引用类型或数组(IsIgnorableType),并且是私有的（!IsAccessibleInAssembly）。我们来验证一下，将ParameterModifier源代码复制到类库中：

//ConsoleApp1.csproj
private void Test(out ClassLibrary1.ParameterModifier obj)



//ClassLibrary1.csproj
namespace ClassLibrary1

    public readonly struct ParameterModifier
    
        private readonly bool[] _byRef; //编译通过
        //private readonly string _byRef; //编译通过
        //private readonly int _byRef; //编译失败
        //public readonly bool[] _byRef; //编译失败