Converted some of the existing extension methods into .NET 10 extension blocks.

Author: MrMatthewLayton

OnixLabs.Core/Extensions.Array.cs

@@ -25,37 +25,45 @@ namespace OnixLabs.Core;
 public static class ArrayExtensions
 {
     /// <summary>
-    /// Creates a copy of the current <see cref="T:T[]"/>.
+    /// Provides extensions for generic arrays.
     /// </summary>
-    /// <param name="array">The current <see cref="T:T[]"/> to copy.</param>
-    /// <typeparam name="T">The underlying type of the array.</typeparam>
-    /// <returns>Returns an exact copy of the current <see cref="T:T[]"/>.</returns>
-    public static T[] Copy<T>(this T[] array) => [..array];
+    /// <param name="receiver">The current generic array.</param>
+    /// <typeparam name="T">The underlying element type of the current generic array.</typeparam>
+    extension<T>(T[] receiver)
+    {
+        /// <summary>
+        /// Creates a copy of the current <typeparamref name="T"/> array.
+        /// </summary>
+        /// <returns>Returns an exact copy of the current <typeparamref name="T"/> array.</returns>
+        public T[] Copy() => [..receiver];
 
-    /// <summary>
-    /// Creates a copy of the current <see cref="T:T[]"/>.
-    /// </summary>
-    /// <param name="array">The current <see cref="T:T[]"/> to copy.</param>
-    /// <param name="index">The index of the array to begin copying from.</param>
-    /// <param name="count">The number of elements of the array to copy.</param>
-    /// <typeparam name="T">The underlying type of the array.</typeparam>
-    /// <returns>Returns an exact copy of the current <see cref="T:T[]"/>.</returns>
-    public static T[] Copy<T>(this T[] array, int index, int count) => [..array[index..(index + count)]];
+        /// <summary>
+        /// Creates a copy of the current <typeparamref name="T"/> array.
+        /// </summary>
+        /// <param name="index">The index of the array to begin copying from.</param>
+        /// <param name="count">The number of elements of the array to copy.</param>
+        /// <returns>Returns an exact copy of the current <typeparamref name="T"/> array.</returns>
+        public T[] Copy(int index, int count) => [..receiver[index..(index + count)]];
 
-    /// <summary>
-    /// Concatenates the current <see cref="T:T[]"/> with another <see cref="T:T[]"/>.
-    /// </summary>
-    /// <param name="array">The source <see cref="T:T[]"/> to concatenate with the other <see cref="T:T[]"/>.</param>
-    /// <param name="other">The other <see cref="T:T[]"/> to concatenate with the source <see cref="T:T[]"/>.</param>
-    /// <typeparam name="T">The underlying type of the <see cref="T:T[]"/>.</typeparam>
-    /// <returns>Returns the current <see cref="T:T[]"/> concatenated with the other <see cref="T:T[]"/>.</returns>
-    public static T[] ConcatenateWith<T>(this T[] array, T[] other) => [..array, ..other];
+        /// <summary>
+        /// Concatenates the current <typeparamref name="T"/> array with another <typeparamref name="T"/> array.
+        /// </summary>
+        /// <param name="other">The other <typeparamref name="T"/> array to concatenate with the current <typeparamref name="T"/> array.</param>
+        /// <returns>Returns a new <typeparamref name="T"/> array, consisting of the current <typeparamref name="T"/> array concatenated with the other <typeparamref name="T"/> array.</returns>
+        public T[] ConcatenateWith(T[] other) => [..receiver, ..other];
+    }
 
     /// <summary>
-    /// Obtains the <see cref="string"/> representation of the current <see cref="T:Byte[]"/>.
+    /// Provides extension methods for <see cref="byte"/> arrays.
     /// </summary>
-    /// <param name="array">The <see cref="T:Byte[]"/> instance from which to obtain a <see cref="string"/> representation.</param>
-    /// <param name="encoding">The <see cref="Encoding"/> which will be used to convert the current <see cref="T:Byte[]"/> into a <see cref="string"/> representation.</param>
-    /// <returns>Returns the <see cref="string"/> representation of the current <see cref="T:Byte[]"/>.</returns>
-    public static string ToString(this byte[] array, Encoding encoding) => encoding.GetString(array);
+    /// <param name="array">The current <see cref="byte"/> array.</param>
+    extension(byte[] array)
+    {
+        /// <summary>
+        /// Obtains the <see cref="string"/> representation of the current <see cref="byte"/> array.
+        /// </summary>
+        /// <param name="encoding">The <see cref="Encoding"/> which will be used to convert the current <see cref="byte"/> array into a <see cref="string"/> representation.</param>
+        /// <returns>Returns the <see cref="string"/> representation of the current <see cref="byte"/> array.</returns>
+        public string ToString(Encoding encoding) => encoding.GetString(array);
+    }
 }

OnixLabs.Core/Extensions.DateTime.cs

@@ -24,16 +24,21 @@ namespace OnixLabs.Core;
 public static class DateTimeExtensions
 {
     /// <summary>
-    /// Obtains a <see cref="DateOnly"/> instance from the current <see cref="DateTime"/> instance.
+    /// Provides extension methods for <see cref="DateTime"/> instances.
     /// </summary>
-    /// <param name="value">The <see cref="DateTime"/> instance from which to obtain a <see cref="DateOnly"/> instance.</param>
-    /// <returns>Returns the <see cref="DateOnly"/> instance obtained from the current <see cref="DateTime"/> instance.</returns>
-    public static DateOnly ToDateOnly(this DateTime value) => DateOnly.FromDateTime(value);
+    /// <param name="receiver">The current <see cref="DateTime"/> instance.</param>
+    extension(DateTime receiver)
+    {
+        /// <summary>
+        /// Obtains a <see cref="DateOnly"/> instance from the current <see cref="DateTime"/> instance.
+        /// </summary>
+        /// <returns>Returns the <see cref="DateOnly"/> instance obtained from the current <see cref="DateTime"/> instance.</returns>
+        public DateOnly ToDateOnly() => DateOnly.FromDateTime(receiver);
 
-    /// <summary>
-    /// Obtains a <see cref="TimeOnly"/> instance from the current <see cref="TimeOnly"/> instance.
-    /// </summary>
-    /// <param name="value">The <see cref="DateTime"/> instance from which to obtain a <see cref="TimeOnly"/> instance.</param>
-    /// <returns>Returns the <see cref="TimeOnly"/> instance obtained from the current <see cref="DateTime"/> instance.</returns>
-    public static TimeOnly ToTimeOnly(this DateTime value) => TimeOnly.FromDateTime(value);
+        /// <summary>
+        /// Obtains a <see cref="TimeOnly"/> instance from the current <see cref="TimeOnly"/> instance.
+        /// </summary>
+        /// <returns>Returns the <see cref="TimeOnly"/> instance obtained from the current <see cref="DateTime"/> instance.</returns>
+        public TimeOnly ToTimeOnly() => TimeOnly.FromDateTime(receiver);
+    }
 }

OnixLabs.Core/Extensions.Random.cs

@@ -25,11 +25,17 @@ namespace OnixLabs.Core;
 public static class RandomExtensions
 {
     /// <summary>
-    /// Obtains a random element from the specified <see cref="IReadOnlyList{T}"/> items.
+    /// Provides extension methods for <see cref="Random"/> instances.
     /// </summary>
     /// <param name="random">The current <see cref="Random"/> instance.</param>
-    /// <param name="items">The <see cref="IReadOnlyList{T}"/> items from which to obtain a random element.</param>
-    /// <typeparam name="T">The underlying type of the <see cref="IReadOnlyList{T}"/> collection.</typeparam>
-    /// <returns>Returns a random element from the specified <see cref="IReadOnlyList{T}"/> items.</returns>
-    public static T Next<T>(this Random random, IReadOnlyList<T> items) => items[random.Next(0, items.Count)];
+    extension(Random random)
+    {
+        /// <summary>
+        /// Obtains a random element from the specified <see cref="IReadOnlyList{T}"/> items.
+        /// </summary>
+        /// <param name="items">The <see cref="IReadOnlyList{T}"/> items from which to obtain a random element.</param>
+        /// <typeparam name="T">The underlying type of the <see cref="IReadOnlyList{T}"/> collection.</typeparam>
+        /// <returns>Returns a random element from the specified <see cref="IReadOnlyList{T}"/> items.</returns>
+        public T Next<T>(IReadOnlyList<T> items) => items[random.Next(0, items.Count)];
+    }
 }

OnixLabs.Core/Extensions.ReadOnlySequence.cs

@@ -24,22 +24,26 @@ namespace OnixLabs.Core;
 public static class ReadOnlySequenceExtensions
 {
     /// <summary>
-    /// Copies the current <see cref="ReadOnlySequence{T}"/> to the specified <see cref="T:[]"/> by reference.
+    /// Provides extension methods for <see cref="ReadOnlySequence{T}"/> instances.
     /// </summary>
-    /// <param name="sequence">The current <see cref="ReadOnlySequence{T}"/> to copy.</param>
-    /// <param name="array">The <see cref="T:[]"/> to copy to.</param>
-    /// <typeparam name="T">The underlying type of the specified <see cref="ReadOnlySequence{T}"/> and <see cref="T:[]"/>.</typeparam>
-    public static void CopyTo<T>(this ReadOnlySequence<T> sequence, out T[] array)
+    /// <param name="sequence">The current <see cref="ReadOnlySequence{T}"/> instance.</param>
+    /// <typeparam name="T">The underlying type of the current <see cref="ReadOnlySequence{T}"/> instance.</typeparam>
+    extension<T>(ReadOnlySequence<T> sequence)
     {
-        if (sequence.IsSingleSegment)
+        /// <summary>
+        /// Copies the current <see cref="ReadOnlySequence{T}"/> to the specified <typeparamref name="T"/> array.
+        /// </summary>
+        /// <param name="array">The <typeparamref name="T"/> array to copy in to.</param>
+        public void CopyTo(out T[] array)
         {
-            array = sequence.First.Span.ToArray();
-        }
-        else
-        {
-            // ReSharper disable once HeapView.ObjectAllocation.Evident
-            array = new T[sequence.Length];
-            sequence.CopyTo(array);
+            if (sequence.IsSingleSegment)
+                array = sequence.First.Span.ToArray();
+            else
+            {
+                // ReSharper disable once HeapView.ObjectAllocation.Evident
+                array = new T[sequence.Length];
+                sequence.CopyTo(array);
+            }
         }
     }
 }