Merge pull request #106 from feO2x/features/span-is-empty-or-white-space

IsEmptyOrWhiteSpace for Span<T> and Memory<T>

Author: feO2x

Code/Light.GuardClauses.Tests/StringAssertions/IsEmptyOrWhiteSpaceTests.cs

@@ -0,0 +1,120 @@
+using System;
+using FluentAssertions;
+using Xunit;
+
+namespace Light.GuardClauses.Tests.StringAssertions;
+
+public static class IsEmptyOrWhiteSpaceTests
+{
+    [Fact]
+    public static void EmptySpan()
+    {
+        var span = new Span<char>([]);
+        span.IsEmptyOrWhiteSpace().Should().BeTrue();
+    }
+
+    [Fact]
+    public static void WhiteSpaceSpan()
+    {
+        var span = new Span<char>(" \t\n".ToCharArray());
+        span.IsEmptyOrWhiteSpace().Should().BeTrue();
+    }
+
+    [Fact]
+    public static void NonWhiteSpaceSpan()
+    {
+        var span = new Span<char>("abc".ToCharArray());
+        span.IsEmptyOrWhiteSpace().Should().BeFalse();
+    }
+
+    [Fact]
+    public static void MixedSpan()
+    {
+        var span = new Span<char>(" a\t".ToCharArray());
+        span.IsEmptyOrWhiteSpace().Should().BeFalse();
+    }
+
+    [Fact]
+    public static void EmptyReadOnlySpan()
+    {
+        var readOnlySpan = string.Empty.AsSpan();
+        readOnlySpan.IsEmptyOrWhiteSpace().Should().BeTrue();
+    }
+
+    [Fact]
+    public static void WhiteSpaceReadOnlySpan()
+    {
+        var readOnlySpan = " \t\n".AsSpan();
+        readOnlySpan.IsEmptyOrWhiteSpace().Should().BeTrue();
+    }
+
+    [Fact]
+    public static void NonWhiteSpaceReadOnlySpan()
+    {
+        var readOnlySpan = "abc".AsSpan();
+        readOnlySpan.IsEmptyOrWhiteSpace().Should().BeFalse();
+    }
+
+    [Fact]
+    public static void MixedReadOnlySpan()
+    {
+        var readOnlySpan = " a\t".AsSpan();
+        readOnlySpan.IsEmptyOrWhiteSpace().Should().BeFalse();
+    }
+
+    [Fact]
+    public static void EmptyMemory()
+    {
+        var memory = new Memory<char>([]);
+        memory.IsEmptyOrWhiteSpace().Should().BeTrue();
+    }
+
+    [Fact]
+    public static void WhiteSpaceMemory()
+    {
+        var memory = new Memory<char>(" \t\n".ToCharArray());
+        memory.IsEmptyOrWhiteSpace().Should().BeTrue();
+    }
+
+    [Fact]
+    public static void NonWhiteSpaceMemory()
+    {
+        var memory = new Memory<char>("abc".ToCharArray());
+        memory.IsEmptyOrWhiteSpace().Should().BeFalse();
+    }
+
+    [Fact]
+    public static void MixedMemory()
+    {
+        var memory = new Memory<char>(" a\t".ToCharArray());
+        memory.IsEmptyOrWhiteSpace().Should().BeFalse();
+    }
+
+    [Fact]
+    public static void EmptyReadOnlyMemory()
+    {
+        var readOnlyMemory = new ReadOnlyMemory<char>([]);
+        readOnlyMemory.IsEmptyOrWhiteSpace().Should().BeTrue();
+    }
+
+    [Fact]
+    public static void WhiteSpaceReadOnlyMemory()
+    {
+        var readOnlyMemory = new ReadOnlyMemory<char>(" \t\n".ToCharArray());
+        readOnlyMemory.IsEmptyOrWhiteSpace().Should().BeTrue();
+    }
+
+    [Fact]
+    public static void NonWhiteSpaceReadOnlyMemory()
+    {
+        var readOnlyMemory = new ReadOnlyMemory<char>("abc".ToCharArray());
+        readOnlyMemory.IsEmptyOrWhiteSpace().Should().BeFalse();
+    }
+
+    [Fact]
+    public static void MixedReadOnlyMemory()
+    {
+        var readOnlyMemory = new ReadOnlyMemory<char>(" a\t".ToCharArray());
+        readOnlyMemory.IsEmptyOrWhiteSpace().Should().BeFalse();
+    }
+}

Code/Light.GuardClauses/Check.IsEmptyOrWhiteSpace.cs

@@ -0,0 +1,51 @@
+using System;
+using System.Runtime.CompilerServices;
+
+namespace Light.GuardClauses;
+
+public static partial class Check
+{
+    /// <summary>
+    /// Checks if the specified span is empty or contains only white space characters.
+    /// </summary>
+    /// <param name="span">The span to be checked.</param>
+    [MethodImpl(MethodImplOptions.AggressiveInlining)]
+    public static bool IsEmptyOrWhiteSpace(this Span<char> span) => ((ReadOnlySpan<char>) span).IsEmptyOrWhiteSpace();
+
+    /// <summary>
+    /// Checks if the specified span is empty or contains only white space characters.
+    /// </summary>
+    /// <param name="span">The span to be checked.</param>
+    [MethodImpl(MethodImplOptions.AggressiveInlining)]
+    public static bool IsEmptyOrWhiteSpace(this ReadOnlySpan<char> span)
+    {
+        if (span.IsEmpty)
+        {
+            return true;
+        }
+
+        foreach (var character in span)
+        {
+            if (!character.IsWhiteSpace())
+            {
+                return false;
+            }
+        }
+
+        return true;
+    }
+
+    /// <summary>
+    /// Checks if the specified memory is empty or contains only white space characters.
+    /// </summary>
+    /// <param name="memory">The memory to be checked.</param>
+    [MethodImpl(MethodImplOptions.AggressiveInlining)]
+    public static bool IsEmptyOrWhiteSpace(this Memory<char> memory) => memory.Span.IsEmptyOrWhiteSpace();
+
+    /// <summary>
+    /// Checks if the specified memory is empty or contains only white space characters.
+    /// </summary>
+    /// <param name="memory">The memory to be checked.</param>
+    [MethodImpl(MethodImplOptions.AggressiveInlining)]
+    public static bool IsEmptyOrWhiteSpace(this ReadOnlyMemory<char> memory) => memory.Span.IsEmptyOrWhiteSpace();
+}