|
// 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);
}
|