CSharpCodeBuilder.AppendLineIf.cs

namespace NetEvolve.CodeBuilder;

using System;
using System.Runtime.CompilerServices;

public partial class CSharpCodeBuilder
{
    /// <summary>
    /// Appends a line terminator to the current builder if the specified condition is true.
    /// </summary>
    /// <param name="condition">The condition that determines whether to append the line terminator.</param>
    /// <returns>The current <see cref="CSharpCodeBuilder"/> instance to allow for method chaining.</returns>
    [MethodImpl(MethodImplOptions.AggressiveInlining)]
    public CSharpCodeBuilder AppendLineIf(bool condition) => condition ? AppendLine() : this;

    /// <summary>
    /// Appends a string followed by a line terminator to the current builder if the specified condition is true.
    /// </summary>
    /// <param name="condition">The condition that determines whether to append the value.</param>
    /// <param name="value">The string to append.</param>
    /// <returns>The current <see cref="CSharpCodeBuilder"/> instance to allow for method chaining.</returns>
    /// <remarks>If the string is null or empty, the method returns without appending anything.</remarks>
    [MethodImpl(MethodImplOptions.AggressiveInlining)]
    public CSharpCodeBuilder AppendLineIf(bool condition, string? value) => condition ? AppendLine(value) : this;

    /// <summary>
    /// Appends a read-only memory of characters followed by a line terminator to the current builder if the specified condition is true.
    /// </summary>
    /// <param name="condition">The condition that determines whether to append the value.</param>
    /// <param name="value">The read-only memory containing the characters to append.</param>
    /// <returns>The current <see cref="CSharpCodeBuilder"/> instance to allow for method chaining.</returns>
    /// <remarks>If the memory is empty, the method returns without appending anything.</remarks>
    [MethodImpl(MethodImplOptions.AggressiveInlining)]
    public CSharpCodeBuilder AppendLineIf(bool condition, ReadOnlyMemory<char> value) =>
        condition ? AppendLine(value) : this;

    /// <summary>
    /// Appends a subset of a read-only memory of characters followed by a line terminator to the current builder if the specified condition is true.
    /// </summary>
    /// <param name="condition">The condition that determines whether to append the value.</param>
    /// <param name="value">The read-only memory containing the characters to append.</param>
    /// <param name="startIndex">The starting position in the memory.</param>
    /// <param name="count">The number of characters to append.</param>
    /// <returns>The current <see cref="CSharpCodeBuilder"/> instance to allow for method chaining.</returns>
    /// <remarks>If the memory is empty, the method returns without appending anything.</remarks>
    [MethodImpl(MethodImplOptions.AggressiveInlining)]
    public CSharpCodeBuilder AppendLineIf(bool condition, ReadOnlyMemory<char> value, int startIndex, int count) =>
        condition ? AppendLine(value, startIndex, count) : this;

    /// <summary>
    /// Appends a read-only span of characters followed by a line terminator to the current builder if the specified condition is <see langword="true"/>.
    /// </summary>
    /// <param name="condition">The condition that determines whether to append the value.</param>
    /// <param name="value">The read-only span containing the characters to append.</param>
    /// <returns>The current <see cref="CSharpCodeBuilder"/> instance to allow for method chaining.</returns>
    /// <remarks>If the span is empty, only the line terminator is appended.</remarks>
    [MethodImpl(MethodImplOptions.AggressiveInlining)]
    public CSharpCodeBuilder AppendLineIf(bool condition, ReadOnlySpan<char> value) =>
        condition ? AppendLine(value) : this;

    /// <summary>
    /// Appends a subset of a read-only span of characters followed by a line terminator to the current builder if the specified condition is <see langword="true"/>.
    /// </summary>
    /// <param name="condition">The condition that determines whether to append the value.</param>
    /// <param name="value">The read-only span containing the characters to append.</param>
    /// <param name="startIndex">The starting position in the span.</param>
    /// <param name="count">The number of characters to append.</param>
    /// <returns>The current <see cref="CSharpCodeBuilder"/> instance to allow for method chaining.</returns>
    /// <remarks>If the span is empty, only the line terminator is appended.</remarks>
    [MethodImpl(MethodImplOptions.AggressiveInlining)]
    public CSharpCodeBuilder AppendLineIf(bool condition, ReadOnlySpan<char> value, int startIndex, int count) =>
        condition ? AppendLine(value, startIndex, count) : this;

    /// <summary>
    /// Appends an array of characters followed by a line terminator to the current builder if the specified condition is true.
    /// </summary>
    /// <param name="condition">The condition that determines whether to append the value.</param>
    /// <param name="value">The character array to append.</param>
    /// <returns>The current <see cref="CSharpCodeBuilder"/> instance to allow for method chaining.</returns>
    /// <remarks>If the array is null or empty, the method returns without appending anything.</remarks>
    [MethodImpl(MethodImplOptions.AggressiveInlining)]
    public CSharpCodeBuilder AppendLineIf(bool condition, char[]? value) => condition ? AppendLine(value) : this;

    /// <summary>
    /// Appends a subset of an array of characters followed by a line terminator to the current builder if the specified condition is true.
    /// </summary>
    /// <param name="condition">The condition that determines whether to append the value.</param>
    /// <param name="value">The character array to append.</param>
    /// <param name="startIndex">The starting position in the character array.</param>
    /// <param name="charCount">The number of characters to append.</param>
    /// <returns>The current <see cref="CSharpCodeBuilder"/> instance to allow for method chaining.</returns>
    /// <remarks>If the array is null or empty, the method returns without appending anything.</remarks>
    [MethodImpl(MethodImplOptions.AggressiveInlining)]
    public CSharpCodeBuilder AppendLineIf(bool condition, char[]? value, int startIndex, int charCount) =>
        condition ? AppendLine(value, startIndex, charCount) : this;

    /// <summary>
    /// Appends characters from a pointer followed by a line terminator to the current builder if the specified condition is true.
    /// </summary>
    /// <param name="condition">The condition that determines whether to append the value.</param>
    /// <param name="value">A pointer to a character array.</param>
    /// <param name="length">The number of characters to append.</param>
    /// <returns>The current <see cref="CSharpCodeBuilder"/> instance to allow for method chaining.</returns>
    /// <remarks>If the pointer is null or length is negative, the method returns without appending anything.</remarks>
    [MethodImpl(MethodImplOptions.AggressiveInlining)]
    public unsafe CSharpCodeBuilder AppendLineIf(bool condition, char* value, int length) =>
        condition ? AppendLine(value, length) : this;

    /// <summary>
    /// Appends a character followed by a line terminator to the current builder if the specified condition is true.
    /// </summary>
    /// <param name="condition">The condition that determines whether to append the value.</param>
    /// <param name="value">The character to append.</param>
    /// <returns>The current <see cref="CSharpCodeBuilder"/> instance to allow for method chaining.</returns>
    [MethodImpl(MethodImplOptions.AggressiveInlining)]
    public CSharpCodeBuilder AppendLineIf(bool condition, char value) => condition ? AppendLine(value) : this;

    /// <summary>
    /// Appends a character repeated a specified number of times followed by a line terminator to the current builder if the specified condition is true.
    /// </summary>
    /// <param name="condition">The condition that determines whether to append the value.</param>
    /// <param name="value">The character to append.</param>
    /// <param name="repeatCount">The number of times to repeat the character.</param>
    /// <returns>The current <see cref="CSharpCodeBuilder"/> instance to allow for method chaining.</returns>
    /// <exception cref="ArgumentOutOfRangeException">Thrown when <paramref name="repeatCount"/> is less than zero.</exception>
    [MethodImpl(MethodImplOptions.AggressiveInlining)]
    public CSharpCodeBuilder AppendLineIf(bool condition, char value, int repeatCount) =>
        condition ? AppendLine(value, repeatCount) : this;

    /// <summary>
    /// Appends a boolean value followed by a line terminator to the current builder if the specified condition is true.
    /// </summary>
    /// <param name="condition">The condition that determines whether to append the value.</param>
    /// <param name="value">The boolean value to append.</param>
    /// <returns>The current <see cref="CSharpCodeBuilder"/> instance to allow for method chaining.</returns>
    /// <remarks>Appends either <see langword="true"/> or <see langword="false"/> based on the value if the condition is <see langword="true"/>.</remarks>
    [MethodImpl(MethodImplOptions.AggressiveInlining)]
    public CSharpCodeBuilder AppendLineIf(bool condition, bool value) => condition ? AppendLine(value) : this;
}