mirror of
https://github.com/icsharpcode/ILSpy.git
synced 2026-10-12 11:09:54 +00:00
The grammar-production doc comments were transcribed in ANTLR style and often copied the C# spec verbatim, including sub-rules the AST does not model. Rewrite them as W3C EBNF (::=, ?, *, +), unroll sub-productions that are not themselves AST nodes (e.g. anonymous_function_modifier -> 'async'), and shape each production to the node's actual members. Render top-level alternations of node productions as multi-line <code> blocks; keep operator and keyword token lists inline. Assisted-by: Claude:claude-opus-4-8:Claude Code
127 lines
3.9 KiB
C#
127 lines
3.9 KiB
C#
//
|
|
// SyntaxTree.cs
|
|
//
|
|
// Author:
|
|
// Mike Krüger <[email protected]>
|
|
//
|
|
// Copyright (c) 2010 Novell, Inc (http://www.novell.com)
|
|
//
|
|
// 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.
|
|
|
|
using System.Collections.Generic;
|
|
|
|
using ICSharpCode.Decompiler.Util;
|
|
|
|
namespace ICSharpCode.Decompiler.CSharp.Syntax
|
|
{
|
|
/// <summary>
|
|
/// <c>compilation_unit ::= extern_alias_directive* using_directive* global_attributes? compilation_unit_body</c> (C# grammar §14.2)
|
|
/// </summary>
|
|
[DecompilerAstNode(hasNullNode: false)]
|
|
public partial class SyntaxTree : AstNode
|
|
{
|
|
public static readonly Role<AstNode> MemberRole = new Role<AstNode>("Member", AstNode.Null);
|
|
|
|
public override NodeType NodeType {
|
|
get {
|
|
return NodeType.Unknown;
|
|
}
|
|
}
|
|
|
|
string fileName;
|
|
|
|
/// <summary>
|
|
/// Gets/Sets the file name of this syntax tree.
|
|
/// </summary>
|
|
public string FileName {
|
|
get { return fileName; }
|
|
set {
|
|
fileName = value;
|
|
}
|
|
}
|
|
|
|
[Slot("MemberRole")]
|
|
public partial AstNodeCollection<AstNode> Members { get; }
|
|
|
|
IList<string> conditionalSymbols = null;
|
|
|
|
/// <summary>
|
|
/// Gets the conditional symbols used to parse the source file. Note that this list contains
|
|
/// the conditional symbols at the start of the first token in the file - including the ones defined
|
|
/// in the source file.
|
|
/// </summary>
|
|
public IList<string> ConditionalSymbols {
|
|
get {
|
|
return conditionalSymbols ?? EmptyList<string>.Instance;
|
|
}
|
|
internal set {
|
|
conditionalSymbols = value;
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// Gets the expression that was on top of the parse stack.
|
|
/// This is the only way to get an expression that isn't part of a statment.
|
|
/// (eg. when an error follows an expression).
|
|
///
|
|
/// This is used for code completion to 'get the expression before a token - like ., <, ('.
|
|
/// </summary>
|
|
public AstNode TopExpression {
|
|
get;
|
|
internal set;
|
|
}
|
|
|
|
public SyntaxTree()
|
|
{
|
|
}
|
|
|
|
/// <summary>
|
|
/// Gets all defined types in this syntax tree.
|
|
/// </summary>
|
|
/// <returns>
|
|
/// A list containing <see cref="TypeDeclaration"/> or <see cref="DelegateDeclaration"/> nodes.
|
|
/// </returns>
|
|
public IEnumerable<EntityDeclaration> GetTypes(bool includeInnerTypes = false)
|
|
{
|
|
Stack<AstNode> nodeStack = new Stack<AstNode>();
|
|
nodeStack.Push(this);
|
|
while (nodeStack.Count > 0)
|
|
{
|
|
var curNode = nodeStack.Pop();
|
|
if (curNode is TypeDeclaration || curNode is DelegateDeclaration)
|
|
{
|
|
yield return (EntityDeclaration)curNode;
|
|
}
|
|
foreach (var child in curNode.Children)
|
|
{
|
|
if (!(child is Statement || child is Expression) &&
|
|
(child.Slot?.Kind != SlotKind.TypeMember || ((child is TypeDeclaration || child is DelegateDeclaration) && includeInnerTypes)))
|
|
nodeStack.Push(child);
|
|
}
|
|
}
|
|
}
|
|
|
|
protected internal override bool DoMatch(AstNode other, PatternMatching.Match match)
|
|
{
|
|
SyntaxTree o = other as SyntaxTree;
|
|
return o != null && this.Members.DoMatch(o.Members, match);
|
|
}
|
|
}
|
|
}
|