feature/try-get-value

Directory.Build.props

@@ -2,9 +2,9 @@
 
     <!--GLOBAL-->
     <PropertyGroup>
-        <Version>12.1.1</Version>
-        <PackageVersion>12.1.1</PackageVersion>
-        <AssemblyVersion>12.1.1</AssemblyVersion>
+        <Version>12.2.0</Version>
+        <PackageVersion>12.2.0</PackageVersion>
+        <AssemblyVersion>12.2.0</AssemblyVersion>
         <TargetFrameworks>net8.0;net9.0</TargetFrameworks>
         <LangVersion>13</LangVersion>
         <Nullable>enable</Nullable>

OnixLabs.Core.UnitTests/ObjectExtensionTests.cs

@@ -360,4 +360,32 @@ public async Task ToSuccessAsyncShouldProduceTheExpectedResult()
         Success<string> success = Assert.IsType<Success<string>>(result);
         Assert.Equal(expected, success.Value);
     }
+
+    [Fact(DisplayName = "TryGetNonNull should produce the expected result (true)")]
+    public void TryGetNotNullShouldProduceExpectedResultTrue()
+    {
+        // Given
+        const string? value = "Hello, World!";
+
+        // When
+        bool result = value.TryGetNonNull(out string output);
+
+        // Then
+        Assert.True(result);
+        Assert.NotNull(output);
+    }
+
+    [Fact(DisplayName = "TryGetNonNull should produce the expected result (false)")]
+    public void TryGetNotNullShouldProduceExpectedResultFalse()
+    {
+        // Given
+        const string? value = null;
+
+        // When
+        bool result = value.TryGetNonNull(out string? output);
+
+        // Then
+        Assert.False(result);
+        Assert.Null(output);
+    }
 }

OnixLabs.Core/Extensions.Object.cs

@@ -16,6 +16,7 @@
 using System.Collections;
 using System.Collections.Generic;
 using System.ComponentModel;
+using System.Diagnostics.CodeAnalysis;
 using System.Reflection;
 using System.Text;
 using System.Threading;
@@ -226,4 +227,23 @@ public static async Task<Optional<T>> ToOptionalAsync<T>(this Task<T?> value, Ca
     /// <returns>Returns a <see cref="Success{T}"/> representation of the current <see cref="Object"/>.</returns>
     public static async Task<Success<T>> ToSuccessAsync<T>(this Task<T> value, CancellationToken token = default) =>
         Result<T>.Success(await value.WaitAsync(token).ConfigureAwait(false));
+
+    /// <summary>
+    /// Attempts to extract a non-null value from the current nullable <see cref="Object"/>.
+    /// </summary>
+    /// <param name="value">The current nullable <see cref="Object"/> to test for nullability.</param>
+    /// <param name="result">The non-null value when this method returns <see langword="true"/>; otherwise, <see langword="null"/>.</param>
+    /// <typeparam name="T">The underlying type of the value.</typeparam>
+    /// <returns>Returns <see langword="true"/> if the current nullable <see cref="Object"/> is not null; otherwise, <see langword="false"/>.</returns>
+    public static bool TryGetNonNull<T>(this T? value, [NotNullWhen(true)] out T result)
+    {
+        if (value is null)
+        {
+            result = default!;
+            return false;
+        }
+
+        result = value;
+        return true;
+    }
 }