Add new string enxtensions: 'ToStringArray' ,'ArrayToString'.

Add new array extensions: 'AppendItem', 'AppendIfNotExists', 'RemoveItem', 'RemoveAtIdx'.

Author: I-RzR-I

src/DomainCommonExtensions/ArraysExtensions/ArrayExtensions.cs

@@ -14,31 +14,45 @@
 //  </summary>
 // ***********************************************************************
 
+using System;
+using System.Collections;
+using System.Collections.Generic;
+using System.Linq;
+using DomainCommonExtensions.CommonExtensions;
+using DomainCommonExtensions.DataTypeExtensions;
+
 namespace DomainCommonExtensions.ArraysExtensions
 {
+    /// -------------------------------------------------------------------------------------------------
     /// <summary>
-    ///     Array extensions
+    ///     Array extensions.
     /// </summary>
-    /// <remarks></remarks>
+    /// =================================================================================================
     public static class ArrayExtensions
     {
+        /// -------------------------------------------------------------------------------------------------
         /// <summary>
-        ///     Returns the first index of the given value
+        ///     Returns the first index of the given value.
         /// </summary>
-        /// <param name="array">Input array</param>
-        /// <param name="value">Value to search</param>
-        /// <returns></returns>
-        /// <typeparam name="T">Type of input</typeparam>
-        /// <remarks>In case when no found any value result is -1</remarks>
-        public static int IndexOf<T>(this T[] array, T value)
+        /// <remarks>
+        ///     In case when no found any value result is -1.
+        /// </remarks>
+        /// <typeparam name="T">Type of input.</typeparam>
+        /// <param name="source">Input source.</param>
+        /// <param name="value">Value to search.</param>
+        /// <returns>
+        ///     An int.
+        /// </returns>
+        /// =================================================================================================
+        public static int IndexOf<T>(this T[] source, T value)
         {
             const int index = -1;
             try
             {
-                if (array.IsNullOrEmptyEnumerable()) return index;
+                if (source.IsNullOrEmptyEnumerable()) return index;
 
-                for (var i = 0; i < array.Length; i++)
-                    if (Equals(array[i], value))
+                for (var i = 0; i < source.Length; i++)
+                    if (Equals(source[i], value))
                         return i;
             }
             catch
@@ -48,5 +62,143 @@ public static int IndexOf<T>(this T[] array, T value)
 
             return index;
         }
+
+        /// -------------------------------------------------------------------------------------------------
+        /// <summary>
+        ///     Append an item to source array.
+        /// </summary>
+        /// <typeparam name="T">Generic type parameter. Source type.</typeparam>
+        /// <param name="source">Input source.</param>
+        /// <param name="item">The item.</param>
+        /// <returns>
+        ///     Returns a new T[].
+        /// </returns>
+        /// =================================================================================================
+        public static T[] AppendItem<T>(this T[] source, T item)
+        {
+            if (source.IsNullOrEmptyEnumerable() && item.IsNull()) return new T[] { };
+            if (item.IsNull()) return source;
+            if (source.IsNullOrEmptyEnumerable()) return new[] { item };
+
+            var result = new T[source.Length + 1];
+            source.CopyTo(result, 0);
+            result[source.Length] = item;
+
+            return result;
+        }
+
+        /// -------------------------------------------------------------------------------------------------
+        /// <summary>
+        ///     Append an item/s to source array.
+        /// </summary>
+        /// <typeparam name="T">Generic type parameter. Source type.</typeparam>
+        /// <param name="source">Input source.</param>
+        /// <param name="items">A variable-length parameters list containing items.</param>
+        /// <returns>
+        ///     Returns a new T[].
+        /// </returns>
+        /// =================================================================================================
+        public static T[] AppendItem<T>(this T[] source, params T[] items)
+        {
+            if (source.IsNullOrEmptyEnumerable() && items.IsNullOrEmptyEnumerable()) return new T[] { };
+            if (items.IsNullOrEmptyEnumerable()) return source;
+            if (source.IsNullOrEmptyEnumerable()) return items;
+
+            var result = new T[source.Length + items.Length];
+            source.CopyTo(result, 0);
+            items.CopyTo(result, source.Length);
+
+            return result;
+        }
+
+        /// -------------------------------------------------------------------------------------------------
+        /// <summary>
+        ///     Append an item to source array.
+        /// </summary>
+        /// <typeparam name="T">Generic type parameter.</typeparam>
+        /// <param name="source">Input source.</param>
+        /// <param name="index">Zero-based index of the.</param>
+        /// <param name="item">The item.</param>
+        /// <returns>
+        ///     Returns a new T[].
+        /// </returns>
+        /// =================================================================================================
+        public static T[] AppendItem<T>(this T[] source, int index, T item)
+        {
+            if (source.IsNullOrEmptyEnumerable()) return new T[] { };
+            if (item.IsNull()) return source;
+            if (index.IsLessZero()) return source;
+
+            source[index] = item;
+
+            return source;
+        }
+
+        /// -------------------------------------------------------------------------------------------------
+        /// <summary>
+        ///     Append an items to source array.
+        /// </summary>
+        /// <typeparam name="T">Generic type parameter. Source type.</typeparam>
+        /// <param name="source">Input source.</param>
+        /// <param name="itemsToAppend">The items to append.</param>
+        /// <returns>
+        ///     Returns a new T[].
+        /// </returns>
+        /// =================================================================================================
+        public static T[] AppendIfNotExists<T>(this T[] source, T[] itemsToAppend)
+        {
+            if (source.IsNullOrEmptyEnumerable() && itemsToAppend.IsNullOrEmptyEnumerable()) return new T[] { };
+            if (source.IsNullOrEmptyEnumerable()) return itemsToAppend;
+            if (itemsToAppend.IsNullOrEmptyEnumerable()) return source;
+
+            return source.AppendItem((from t in itemsToAppend let existIdx = source.IndexOf(t) where existIdx == -1 select t).ToArray());
+        }
+
+        /// -------------------------------------------------------------------------------------------------
+        /// <summary>
+        ///     Removes the item from source array.
+        /// </summary>
+        /// <typeparam name="T">Generic type parameter. Source type.</typeparam>
+        /// <param name="source">Input source.</param>
+        /// <param name="item">The item.</param>
+        /// <returns>
+        ///     Returns a new T[].
+        /// </returns>
+        /// =================================================================================================
+        public static T[] RemoveItem<T>(this T[] source, T item)
+        {
+            if (source.IsNullOrEmptyEnumerable()) return new T[] { }; 
+            if (item.IsNull()) return source;
+
+            var idx = source.IndexOf(item);
+
+            return source.RemoveAtIdx(idx);
+        }
+
+        /// -------------------------------------------------------------------------------------------------
+        /// <summary>
+        ///     A T[] extension method that removes at index.
+        /// </summary>
+        /// <typeparam name="T">Generic type parameter. Source type.</typeparam>
+        /// <param name="source">Input source.</param>
+        /// <param name="index">Zero-based index of the.</param>
+        /// <returns>
+        ///     A T[].
+        /// </returns>
+        /// =================================================================================================
+        public static T[] RemoveAtIdx<T>(this T[] source, int index)
+        {
+            if (source.IsNullOrEmptyEnumerable()) return new T[] { }; 
+            if (index.IsLessZero()) return source;
+
+            T[] dest = new T[source.Length - 1];
+            if (index > 0)
+                Array.Copy(source, 0, dest, 0, index);
+
+            if (index < source.Length - 1)
+                Array.Copy(source, index + 1, dest, index, source.Length - index - 1);
+
+            return dest;
+        }
     }
 }

src/DomainCommonExtensions/DataTypeExtensions/StringExtensions.cs

@@ -34,8 +34,10 @@
 
 using System.Text.RegularExpressions;
 using CodeSource;
+using DomainCommonExtensions.ArraysExtensions;
 using DomainCommonExtensions.CommonExtensions;
 using DomainCommonExtensions.Resources;
+using static System.Net.Mime.MediaTypeNames;
 
 #endregion
 
@@ -1589,5 +1591,33 @@ public static string EscapeBackSlash(this string source, string customCharEscape
 
             return source;
         }
+
+        /// <summary>
+        ///     Cast source string to array of letters.
+        /// </summary>
+        /// <param name="source">Source string</param>
+        /// <param name="returnEmptyIfMissing">Indicate if source is empty return empty array, otherwise return null.</param>
+        /// <returns>Returns array of strings.</returns>
+        /// <remarks></remarks>
+        public static string[] ToStringArray(this string source, bool returnEmptyIfMissing = false)
+        {
+            if (source.IsMissing()) return returnEmptyIfMissing.IsTrue() ? new string[0] : null;
+
+            return source.ToCharArray().Select(c => c.ToString()).ToArray();
+        }
+        
+        /// <summary>
+        ///     Cast source array of letters/string value to one string.
+        /// </summary>
+        /// <param name="source">Source string array.</param>
+        /// <param name="returnEmptyIfMissing">Indicate if source is empty return string.Empty, otherwise return null.</param>
+        /// <returns>Returns string.</returns>
+        /// <remarks></remarks>
+        public static string ArrayToString(this string[] source, bool returnEmptyIfMissing = false)
+        {
+            if (source.IsNullOrEmptyEnumerable()) return returnEmptyIfMissing.IsTrue() ? string.Empty : null;
+
+            return string.Concat(source);
+        }
     }
 }