(#7) Move CharExtensions to child namespace

- Deprecate Random methods in favour of RandomExtensions methods
This commit is contained in:
Oliver Booth 2021-03-07 18:09:27 +00:00
parent 163b304ad1
commit 9bcd1eabce
2 changed files with 21 additions and 90 deletions

View File

@ -1,90 +0,0 @@
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
namespace X10D
{
/// <summary>
/// Extension methods for <see cref="char" />.
/// </summary>
public static class CharExtensions
{
/// <summary>
/// Generates a new random string by filling it with characters found in <see cref="chars" />.
/// </summary>
/// <param name="chars">The character set.</param>
/// <param name="length">The length of the string to generate.</param>
/// <returns>Returns a <see cref="string" /> containing <paramref name="length" /> characters.</returns>
public static string Random(this char[] chars, int length)
{
return chars.Random(length, RandomExtensions.Random);
}
/// <summary>
/// Generates a new random string by filling it with characters found in <see cref="chars" />.
/// </summary>
/// <param name="chars">The character set.</param>
/// <param name="length">The length of the string to generate.</param>
/// <param name="random">The <see cref="System.Random" /> instance.</param>
/// <returns>Returns a <see cref="string" /> containing <paramref name="length" /> characters.</returns>
/// <exception cref="ArgumentNullException"><paramref name="random" /> is <see langword="null" />.</exception>
public static string Random(this char[] chars, int length, Random random)
{
if (chars is null)
{
throw new ArgumentNullException(nameof(chars));
}
if (random is null)
{
throw new ArgumentNullException(nameof(random));
}
var builder = new StringBuilder(length);
for (var i = 0; i < length; i++)
{
builder.Append(chars[random.Next(0, chars.Length)]);
}
return builder.ToString();
}
/// <summary>
/// Generates a new random string by filling it with characters found in <see cref="chars" />.
/// </summary>
/// <param name="chars">The character set.</param>
/// <param name="length">The length of the string to generate.</param>
/// <returns>Returns a <see cref="string" /> containing <paramref name="length" /> characters.</returns>
public static string Random(this IEnumerable<char> chars, int length)
{
return chars.Random(length, RandomExtensions.Random);
}
/// <summary>
/// Generates a new random string by filling it with characters found in <see cref="chars" />.
/// </summary>
/// <param name="chars">The character set.</param>
/// <param name="length">The length of the string to generate.</param>
/// <param name="random">The <see cref="System.Random" /> instance.</param>
/// <returns>Returns a <see cref="string" /> containing <paramref name="length" /> characters.</returns>
public static string Random(this IEnumerable<char> chars, int length, Random random)
{
return chars.ToArray().Random(length, random);
}
/// <summary>
/// Repeats a character a specified number of times.
/// </summary>
/// <param name="c">The character to repeat.</param>
/// <param name="count">The repeat count.</param>
/// <returns>
/// Returns a <see cref="string" /> whose value is <paramref name="c" /> repeated
/// <paramref name="count" /> times.
/// </returns>
public static string Repeat(this char c, int count)
{
return new string(c, count);
}
}
}

View File

@ -0,0 +1,21 @@
namespace X10D.CharExtensions
{
/// <summary>
/// Extension methods for <see cref="char" />.
/// </summary>
public static class CharExtensions
{
/// <summary>
/// Returns a string composed of the current character repeated a specified number of times.
/// </summary>
/// <param name="value">The character to repeat.</param>
/// <param name="count">The number of times to repeat.</param>
/// <returns>
/// A <see cref="string" /> composed of <paramref name="value" /> repeated <paramref name="count" /> times.
/// </returns>
public static string Repeat(this char value, int count)
{
return new(value, count);
}
}
}