File: SplitOrMergeIfStatements\IIfLikeStatementGenerator.cs
Web Access
Project: src\src\Features\Core\Portable\Microsoft.CodeAnalysis.Features.csproj (Microsoft.CodeAnalysis.Features)
// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
// See the LICENSE file in the project root for more information.
 
#nullable disable
 
using System.Collections.Immutable;
using Microsoft.CodeAnalysis.Editing;
using Microsoft.CodeAnalysis.Host;
 
namespace Microsoft.CodeAnalysis.SplitOrMergeIfStatements;
 
/// <summary>
/// When querying the syntax, C# else if chains are "flattened" and modeled to look like VB else-if clauses,
/// so an "ifOrElseIf" can be followed a sequence of else-if clauses and an optional final else clause.
/// These else-if clauses are treated as independent when removing or inserting.
/// </summary>
internal interface IIfLikeStatementGenerator : ILanguageService
{
    bool IsIfOrElseIf(SyntaxNode node);
 
    bool IsCondition(SyntaxNode expression, out SyntaxNode ifOrElseIf);
 
    bool IsElseIfClause(SyntaxNode node, out SyntaxNode parentIfOrElseIf);
 
    bool HasElseIfClause(SyntaxNode ifOrElseIf, out SyntaxNode elseIfClause);
 
    SyntaxNode GetCondition(SyntaxNode ifOrElseIf);
 
    /// <summary>
    /// Returns the topmost if statement for an else-if clause.
    /// </summary>
    SyntaxNode GetRootIfStatement(SyntaxNode ifOrElseIf);
 
    /// <summary>
    /// Returns the list of subsequent else-if clauses and a final else clause (if present).
    /// </summary>
    ImmutableArray<SyntaxNode> GetElseIfAndElseClauses(SyntaxNode ifOrElseIf);
 
    SyntaxNode WithCondition(SyntaxNode ifOrElseIf, SyntaxNode condition);
 
    SyntaxNode WithStatementInBlock(SyntaxNode ifOrElseIf, SyntaxNode statement);
 
    SyntaxNode WithStatementsOf(SyntaxNode ifOrElseIf, SyntaxNode otherIfOrElseIf);
 
    SyntaxNode WithElseIfAndElseClausesOf(SyntaxNode ifStatement, SyntaxNode otherIfStatement);
 
    /// <summary>
    /// Converts an else-if clause to an if statement, preserving its subsequent else-if and else clauses.
    /// </summary>
    SyntaxNode ToIfStatement(SyntaxNode ifOrElseIf);
 
    /// <summary>
    /// Convert an if statement to an else-if clause, discarding any of its else-if and else clauses.
    /// </summary>
    SyntaxNode ToElseIfClause(SyntaxNode ifOrElseIf);
 
    /// <summary>
    /// Inserts <paramref name="elseIfClause"/> as a new else-if clause directly below
    /// <paramref name="afterIfOrElseIf"/>, between it and any of its existing else-if clauses.
    /// </summary>
    void InsertElseIfClause(SyntaxEditor editor, SyntaxNode afterIfOrElseIf, SyntaxNode elseIfClause);
 
    /// <summary>
    /// Removes <paramref name="elseIfClause"/> from a sequence of else-if clauses, preserving any subsequent clauses.
    /// </summary>
    void RemoveElseIfClause(SyntaxEditor editor, SyntaxNode elseIfClause);
}