From 04b3c4e3704808d33e6af1fb4128438ca7f2e6e6 Mon Sep 17 00:00:00 2001
From: BEN ABT <mail@benjamin-abt.com>
Date: Sat, 1 Jun 2024 18:15:26 +0200
Subject: [PATCH] add HasValue

---
 src/StrongOf/Strong.cs                  | 39 +++++++++++++++++++------
 tests/StrongOf.UnitTests/StrongTests.cs |  5 ++++
 2 files changed, 35 insertions(+), 9 deletions(-)

diff --git a/src/StrongOf/Strong.cs b/src/StrongOf/Strong.cs
index b80af68..f214264 100644
--- a/src/StrongOf/Strong.cs
+++ b/src/StrongOf/Strong.cs
@@ -30,26 +30,47 @@ public static bool IsNotNull<TStrong>(TStrong? strong)
     }
 
     /// <summary>
-    /// Checks if the given strong string is null or empty.
+    /// Determines whether the specified <typeparamref name="TStrong"/> instance is <c>null</c> or empty.
     /// </summary>
-    /// <typeparam name="TStrong">The type of the strong string.</typeparam>
-    /// <param name="strong">The strong string to check.</param>
-    /// <returns>true if the strong string is null or empty; otherwise, false.</returns>
+    /// <typeparam name="TStrong">The type of the strong string. Must inherit from <see cref="StrongString{TStrong}"/>.</typeparam>
+    /// <param name="strong">The <typeparamref name="TStrong"/> instance to check.</param>
+    /// <returns>
+    /// <c>true</c> if the <paramref name="strong"/> instance is <c>null</c> or empty; otherwise, <c>false</c>.
+    /// </returns>
     public static bool IsNullOrEmpty<TStrong>(TStrong? strong)
         where TStrong : StrongString<TStrong>
     {
         return strong is null || strong.IsEmpty();
     }
 
+
+    /// <summary>
+    /// Determines whether the specified <typeparamref name="TStrong"/> instance has a value.
+    /// </summary>
+    /// <typeparam name="TStrong">The type of the strong string. Must inherit from <see cref="StrongString{TStrong}"/>.</typeparam>
+    /// <param name="strong">The <typeparamref name="TStrong"/> instance to check.</param>
+    /// <returns>
+    /// <c>true</c> if the <paramref name="strong"/> instance is not <c>null</c> and is not empty; otherwise, <c>false</c>.
+    /// </returns>
+    public static bool HasValue<TStrong>(TStrong? strong)
+        where TStrong : StrongString<TStrong>
+    {
+        return IsNotNullOrEmpty(strong);
+    }
+
+
     /// <summary>
-    /// Checks if the given strong string is not null or empty.
+    /// Determines whether the specified <typeparamref name="TStrong"/> instance is not <c>null</c> and not empty.
     /// </summary>
-    /// <typeparam name="TStrong">The type of the strong string.</typeparam>
-    /// <param name="strong">The strong string to check.</param>
-    /// <returns>true if the strong string is not null or empty; otherwise, false.</returns>
+    /// <typeparam name="TStrong">The type of the strong string. Must inherit from <see cref="StrongString{TStrong}"/>.</typeparam>
+    /// <param name="strong">The <typeparamref name="TStrong"/> instance to check.</param>
+    /// <returns>
+    /// <c>true</c> if the <paramref name="strong"/> instance is not <c>null</c> and not empty; otherwise, <c>false</c>.
+    /// </returns>
     public static bool IsNotNullOrEmpty<TStrong>(TStrong? strong)
-       where TStrong : StrongString<TStrong>
+        where TStrong : StrongString<TStrong>
     {
         return strong is not null && strong.IsEmpty() is false;
     }
+
 }
diff --git a/tests/StrongOf.UnitTests/StrongTests.cs b/tests/StrongOf.UnitTests/StrongTests.cs
index bfd8748..efc752a 100644
--- a/tests/StrongOf.UnitTests/StrongTests.cs
+++ b/tests/StrongOf.UnitTests/StrongTests.cs
@@ -46,6 +46,7 @@ public void IsNullOrEmpty_ShouldReturnTrue_WhenStrongStringIsEmpty()
     {
         TestStringOf strongString = new("");
         Assert.True(Strong.IsNullOrEmpty(strongString));
+        Assert.False(Strong.HasValue(strongString));
     }
 
     [Fact]
@@ -53,6 +54,7 @@ public void IsNullOrEmpty_ShouldReturnFalse_WhenStrongStringIsNotNullOrEmpty()
     {
         TestStringOf strongString = new("test");
         Assert.False(Strong.IsNullOrEmpty(strongString));
+        Assert.True(Strong.HasValue(strongString));
     }
 
     [Fact]
@@ -60,6 +62,7 @@ public void IsNotNullOrEmpty_ShouldReturnTrue_WhenStrongStringIsNotNullOrEmpty()
     {
         TestStringOf strongString = new("test");
         Assert.True(Strong.IsNotNullOrEmpty(strongString));
+        Assert.True(Strong.HasValue(strongString));
     }
 
     [Fact]
@@ -67,6 +70,7 @@ public void IsNotNullOrEmpty_ShouldReturnFalse_WhenStrongStringIsNull()
     {
         TestStringOf? strongString = null;
         Assert.False(Strong.IsNotNullOrEmpty(strongString));
+        Assert.False(Strong.HasValue(strongString));
     }
 
     [Fact]
@@ -74,5 +78,6 @@ public void IsNotNullOrEmpty_ShouldReturnFalse_WhenStrongStringIsEmpty()
     {
         TestStringOf strongString = new("");
         Assert.False(Strong.IsNotNullOrEmpty(strongString));
+        Assert.False(Strong.HasValue(strongString));
     }
 }