codebuilder/src/NetEvolve.CodeBuilder/CSharpCodeBuilder.AppendIf.cs at 43f7eb1f8b24edb31971fdacbdc46e1a2118845e · dailydevops/codebuilder · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
namespace NetEvolve.CodeBuilder;

using System;
using System.Runtime.CompilerServices;

public partial class CSharpCodeBuilder
{
    /// <summary>
    /// Appends a boolean value 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 AppendIf(bool condition, bool value) => condition ? Append(value) : this;

    /// <summary>
    /// Appends a character repeated a specified number of times 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 AppendIf(bool condition, char value, int repeatCount) =>
        condition ? Append(value, repeatCount) : this;

    /// <summary>
    /// Appends a character 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 AppendIf(bool condition, char value) => condition ? Append(value) : this;

    /// <summary>
    /// Appends a subset of an array of characters 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 AppendIf(bool condition, char[]? value, int startIndex, int charCount) =>
        condition ? Append(value, startIndex, charCount) : this;

    /// <summary>
    /// Appends an array of characters 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 AppendIf(bool condition, char[]? value) => condition ? Append(value) : this;

    /// <summary>
    /// Appends characters from a pointer 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 AppendIf(bool condition, char* value, int length) =>
        condition ? Append(value, length) : this;

    /// <summary>
    /// Appends a read-only memory of characters 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 AppendIf(bool condition, ReadOnlyMemory<char> value) => condition ? Append(value) : this;

    /// <summary>
    /// Appends a subset of a read-only memory of characters 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 AppendIf(bool condition, ReadOnlyMemory<char> value, int startIndex, int count) =>
        condition ? Append(value, startIndex, count) : this;

    /// <summary>
    /// Appends a read-only span of characters 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, the method returns without appending anything.</remarks>
    [MethodImpl(MethodImplOptions.AggressiveInlining)]
    public CSharpCodeBuilder AppendIf(bool condition, ReadOnlySpan<char> value) => condition ? Append(value) : this;

    /// <summary>
    /// Appends a subset of a read-only span of characters 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, the method returns without appending anything.</remarks>
    [MethodImpl(MethodImplOptions.AggressiveInlining)]
    public CSharpCodeBuilder AppendIf(bool condition, ReadOnlySpan<char> value, int startIndex, int count) =>
        condition ? Append(value, startIndex, count) : this;

    /// <summary>
    /// Appends a subset of a string 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>
    /// <param name="startIndex">The starting position in the string.</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 string is null or empty, the method returns without appending anything.</remarks>
    [MethodImpl(MethodImplOptions.AggressiveInlining)]
    public CSharpCodeBuilder AppendIf(bool condition, string? value, int startIndex, int count) =>
        condition ? Append(value, startIndex, count) : this;

    /// <summary>
    /// Appends a string 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 AppendIf(bool condition, string? value) => condition ? Append(value) : this;
}