From 1601084cb4f5c8be6a60a2868aca8ff79aaf9bd0 Mon Sep 17 00:00:00 2001
From: Oliver Booth <me@olivr.me>
Date: Tue, 20 Oct 2020 14:58:48 +0100
Subject: [PATCH] =?UTF-8?q?=E2=9C=A8=20Add=20string.WithAlternative?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 X10D/src/StringExtensions.cs | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/X10D/src/StringExtensions.cs b/X10D/src/StringExtensions.cs
index 50a80a8..d722cd2 100644
--- a/X10D/src/StringExtensions.cs
+++ b/X10D/src/StringExtensions.cs
@@ -373,5 +373,27 @@
 
             return TimeSpanParser.Parse(str);
         }
+
+        /// <summary>
+        ///     Returns the current string, or an alternative value if the current string is null or empty, or optionally if the
+        ///     current string consists of only whitespace.
+        /// </summary>
+        /// <param name="value">The value to check.</param>
+        /// <param name="alternative">The alternative value if <paramref name="value" /> does not meet the criteria.</param>
+        /// <param name="includeWhiteSpace">
+        ///     Optional. If set to <see langword="true" />, <paramref name="alternative" /> will be returned also if
+        ///     <paramref name="value" /> only consists of whitespace.
+        /// </param>
+        /// <returns>Returns <paramref name="value" /> or <paramref name="alternative" />.</returns>
+        /// <exception cref="ArgumentNullException"><paramref name="alternative" /> is <see langword="null" />.</exception>
+        public static string WithAlternative(this string? value, string alternative, bool includeWhiteSpace = false)
+        {
+            if (alternative is null)
+            {
+                throw new ArgumentNullException(nameof(alternative));
+            }
+
+            return (includeWhiteSpace ? value?.AsNullIfWhiteSpace() : value?.AsNullIfEmpty()) ?? alternative;
+        }
     }
 }