path join

apiCount.include.md

@@ -1,4 +1,4 @@
-**API count: 897**
+**API count: 892**
 
 ### Per Target Framework
 

api_list.include.md

@@ -688,6 +688,7 @@
  * `string GetRelativePath(string, string)` [reference](https://learn.microsoft.com/en-us/dotnet/api/system.io.path.getrelativepath?view=net-11.0)
  * `bool HasExtension(ReadOnlySpan<char>)` [reference](https://learn.microsoft.com/en-us/dotnet/api/system.io.path.getfilenamewithoutextension?view=net-11.0#system-io-path-getfilenamewithoutextension(system-readonlyspan((system-char))))
  * `bool IsPathRooted(ReadOnlySpan<char>)` [reference](https://learn.microsoft.com/en-us/dotnet/api/system.io.path.ispathrooted?view=net-11.0#system-io-path-ispathrooted(system-readonlyspan((system-char))))
+ * `string Join(string?[])` [reference](https://learn.microsoft.com/en-us/dotnet/api/system.io.path.join?view=net-11.0#system-io-path-join(system-string()))
  * `ReadOnlySpan<char> TrimEndingDirectorySeparator(ReadOnlySpan<char>)` [reference](https://learn.microsoft.com/en-us/dotnet/api/system.io.path.trimendingdirectoryseparator?view=net-11.0#system-io-path-trimendingdirectoryseparator(system-readonlyspan((system-char))))
  * `string TrimEndingDirectorySeparator(string)` [reference](https://learn.microsoft.com/en-us/dotnet/api/system.io.path.trimendingdirectoryseparator?view=net-11.0#system-io-path-trimendingdirectoryseparator(system-string))
 

readme.md

@@ -1219,6 +1219,7 @@ The class `Polyfill` includes the following extension methods:
  * `string GetRelativePath(string, string)` [reference](https://learn.microsoft.com/en-us/dotnet/api/system.io.path.getrelativepath?view=net-11.0)
  * `bool HasExtension(ReadOnlySpan<char>)` [reference](https://learn.microsoft.com/en-us/dotnet/api/system.io.path.getfilenamewithoutextension?view=net-11.0#system-io-path-getfilenamewithoutextension(system-readonlyspan((system-char))))
  * `bool IsPathRooted(ReadOnlySpan<char>)` [reference](https://learn.microsoft.com/en-us/dotnet/api/system.io.path.ispathrooted?view=net-11.0#system-io-path-ispathrooted(system-readonlyspan((system-char))))
+ * `string Join(string?[])` [reference](https://learn.microsoft.com/en-us/dotnet/api/system.io.path.join?view=net-11.0#system-io-path-join(system-string()))
  * `ReadOnlySpan<char> TrimEndingDirectorySeparator(ReadOnlySpan<char>)` [reference](https://learn.microsoft.com/en-us/dotnet/api/system.io.path.trimendingdirectoryseparator?view=net-11.0#system-io-path-trimendingdirectoryseparator(system-readonlyspan((system-char))))
  * `string TrimEndingDirectorySeparator(string)` [reference](https://learn.microsoft.com/en-us/dotnet/api/system.io.path.trimendingdirectoryseparator?view=net-11.0#system-io-path-trimendingdirectoryseparator(system-string))
 

src/Consume/Consume.cs

@@ -781,6 +781,7 @@ void Stopwatch_Methods()
     void Path_Methods()
     {
         var relative = Path.GetRelativePath("/folder1/folder2", "/folder1/folder3");
+        var joined = Path.Join("a", "b", "c");
 #if FeatureMemory
         var rooted = Path.IsPathRooted("/root".AsSpan());
 #endif

src/Polyfill/PathPolyfill.cs

@@ -110,6 +110,39 @@ public static string TrimEndingDirectorySeparator(string path)
 
             return path;
         }
+
+        /// <summary>
+        /// Concatenates a span of paths into a single path.
+        /// </summary>
+        //Link: https://learn.microsoft.com/en-us/dotnet/api/system.io.path.join?view=net-11.0#system-io-path-join(system-string())
+        public static string Join(params string?[] paths)
+        {
+            if (paths.Length == 0)
+            {
+                return string.Empty;
+            }
+
+            var builder = new System.Text.StringBuilder();
+
+            foreach (var path in paths)
+            {
+                if (string.IsNullOrEmpty(path))
+                {
+                    continue;
+                }
+
+                if (builder.Length > 0 &&
+                    !IsDirectorySeparator(builder[builder.Length - 1]) &&
+                    !IsDirectorySeparator(path![0]))
+                {
+                    builder.Append(Path.DirectorySeparatorChar);
+                }
+
+                builder.Append(path);
+            }
+
+            return builder.ToString();
+        }
 #endif
         static bool IsRoot(string path) =>
             Path.IsPathRooted(path) && Path.GetDirectoryName(path) == null;

src/Split/net461/PathPolyfill.cs

@@ -77,6 +77,32 @@ public static string TrimEndingDirectorySeparator(string path)
 			}
 			return path;
 		}
+		/// <summary>
+		/// Concatenates a span of paths into a single path.
+		/// </summary>
+		public static string Join(params string?[] paths)
+		{
+			if (paths.Length == 0)
+			{
+				return string.Empty;
+			}
+			var builder = new System.Text.StringBuilder();
+			foreach (var path in paths)
+			{
+				if (string.IsNullOrEmpty(path))
+				{
+					continue;
+				}
+				if (builder.Length > 0 &&
+					!IsDirectorySeparator(builder[builder.Length - 1]) &&
+					!IsDirectorySeparator(path![0]))
+				{
+					builder.Append(Path.DirectorySeparatorChar);
+				}
+				builder.Append(path);
+			}
+			return builder.ToString();
+		}
 		static bool IsRoot(string path) =>
 			Path.IsPathRooted(path) && Path.GetDirectoryName(path) == null;
 		static bool IsDirectorySeparator(char c) =>

src/Split/net462/PathPolyfill.cs

@@ -77,6 +77,32 @@ public static string TrimEndingDirectorySeparator(string path)
 			}
 			return path;
 		}
+		/// <summary>
+		/// Concatenates a span of paths into a single path.
+		/// </summary>
+		public static string Join(params string?[] paths)
+		{
+			if (paths.Length == 0)
+			{
+				return string.Empty;
+			}
+			var builder = new System.Text.StringBuilder();
+			foreach (var path in paths)
+			{
+				if (string.IsNullOrEmpty(path))
+				{
+					continue;
+				}
+				if (builder.Length > 0 &&
+					!IsDirectorySeparator(builder[builder.Length - 1]) &&
+					!IsDirectorySeparator(path![0]))
+				{
+					builder.Append(Path.DirectorySeparatorChar);
+				}
+				builder.Append(path);
+			}
+			return builder.ToString();
+		}
 		static bool IsRoot(string path) =>
 			Path.IsPathRooted(path) && Path.GetDirectoryName(path) == null;
 		static bool IsDirectorySeparator(char c) =>

src/Split/net47/PathPolyfill.cs

@@ -77,6 +77,32 @@ public static string TrimEndingDirectorySeparator(string path)
 			}
 			return path;
 		}
+		/// <summary>
+		/// Concatenates a span of paths into a single path.
+		/// </summary>
+		public static string Join(params string?[] paths)
+		{
+			if (paths.Length == 0)
+			{
+				return string.Empty;
+			}
+			var builder = new System.Text.StringBuilder();
+			foreach (var path in paths)
+			{
+				if (string.IsNullOrEmpty(path))
+				{
+					continue;
+				}
+				if (builder.Length > 0 &&
+					!IsDirectorySeparator(builder[builder.Length - 1]) &&
+					!IsDirectorySeparator(path![0]))
+				{
+					builder.Append(Path.DirectorySeparatorChar);
+				}
+				builder.Append(path);
+			}
+			return builder.ToString();
+		}
 		static bool IsRoot(string path) =>
 			Path.IsPathRooted(path) && Path.GetDirectoryName(path) == null;
 		static bool IsDirectorySeparator(char c) =>

src/Split/net471/PathPolyfill.cs

@@ -77,6 +77,32 @@ public static string TrimEndingDirectorySeparator(string path)
 			}
 			return path;
 		}
+		/// <summary>
+		/// Concatenates a span of paths into a single path.
+		/// </summary>
+		public static string Join(params string?[] paths)
+		{
+			if (paths.Length == 0)
+			{
+				return string.Empty;
+			}
+			var builder = new System.Text.StringBuilder();
+			foreach (var path in paths)
+			{
+				if (string.IsNullOrEmpty(path))
+				{
+					continue;
+				}
+				if (builder.Length > 0 &&
+					!IsDirectorySeparator(builder[builder.Length - 1]) &&
+					!IsDirectorySeparator(path![0]))
+				{
+					builder.Append(Path.DirectorySeparatorChar);
+				}
+				builder.Append(path);
+			}
+			return builder.ToString();
+		}
 		static bool IsRoot(string path) =>
 			Path.IsPathRooted(path) && Path.GetDirectoryName(path) == null;
 		static bool IsDirectorySeparator(char c) =>

src/Split/net472/PathPolyfill.cs

@@ -77,6 +77,32 @@ public static string TrimEndingDirectorySeparator(string path)
 			}
 			return path;
 		}
+		/// <summary>
+		/// Concatenates a span of paths into a single path.
+		/// </summary>
+		public static string Join(params string?[] paths)
+		{
+			if (paths.Length == 0)
+			{
+				return string.Empty;
+			}
+			var builder = new System.Text.StringBuilder();
+			foreach (var path in paths)
+			{
+				if (string.IsNullOrEmpty(path))
+				{
+					continue;
+				}
+				if (builder.Length > 0 &&
+					!IsDirectorySeparator(builder[builder.Length - 1]) &&
+					!IsDirectorySeparator(path![0]))
+				{
+					builder.Append(Path.DirectorySeparatorChar);
+				}
+				builder.Append(path);
+			}
+			return builder.ToString();
+		}
 		static bool IsRoot(string path) =>
 			Path.IsPathRooted(path) && Path.GetDirectoryName(path) == null;
 		static bool IsDirectorySeparator(char c) =>

src/Split/net48/PathPolyfill.cs

@@ -77,6 +77,32 @@ public static string TrimEndingDirectorySeparator(string path)
 			}
 			return path;
 		}
+		/// <summary>
+		/// Concatenates a span of paths into a single path.
+		/// </summary>
+		public static string Join(params string?[] paths)
+		{
+			if (paths.Length == 0)
+			{
+				return string.Empty;
+			}
+			var builder = new System.Text.StringBuilder();
+			foreach (var path in paths)
+			{
+				if (string.IsNullOrEmpty(path))
+				{
+					continue;
+				}
+				if (builder.Length > 0 &&
+					!IsDirectorySeparator(builder[builder.Length - 1]) &&
+					!IsDirectorySeparator(path![0]))
+				{
+					builder.Append(Path.DirectorySeparatorChar);
+				}
+				builder.Append(path);
+			}
+			return builder.ToString();
+		}
 		static bool IsRoot(string path) =>
 			Path.IsPathRooted(path) && Path.GetDirectoryName(path) == null;
 		static bool IsDirectorySeparator(char c) =>

src/Split/net481/PathPolyfill.cs

@@ -77,6 +77,32 @@ public static string TrimEndingDirectorySeparator(string path)
 			}
 			return path;
 		}
+		/// <summary>
+		/// Concatenates a span of paths into a single path.
+		/// </summary>
+		public static string Join(params string?[] paths)
+		{
+			if (paths.Length == 0)
+			{
+				return string.Empty;
+			}
+			var builder = new System.Text.StringBuilder();
+			foreach (var path in paths)
+			{
+				if (string.IsNullOrEmpty(path))
+				{
+					continue;
+				}
+				if (builder.Length > 0 &&
+					!IsDirectorySeparator(builder[builder.Length - 1]) &&
+					!IsDirectorySeparator(path![0]))
+				{
+					builder.Append(Path.DirectorySeparatorChar);
+				}
+				builder.Append(path);
+			}
+			return builder.ToString();
+		}
 		static bool IsRoot(string path) =>
 			Path.IsPathRooted(path) && Path.GetDirectoryName(path) == null;
 		static bool IsDirectorySeparator(char c) =>

src/Split/netcoreapp2.0/PathPolyfill.cs

@@ -77,6 +77,32 @@ public static string TrimEndingDirectorySeparator(string path)
 			}
 			return path;
 		}
+		/// <summary>
+		/// Concatenates a span of paths into a single path.
+		/// </summary>
+		public static string Join(params string?[] paths)
+		{
+			if (paths.Length == 0)
+			{
+				return string.Empty;
+			}
+			var builder = new System.Text.StringBuilder();
+			foreach (var path in paths)
+			{
+				if (string.IsNullOrEmpty(path))
+				{
+					continue;
+				}
+				if (builder.Length > 0 &&
+					!IsDirectorySeparator(builder[builder.Length - 1]) &&
+					!IsDirectorySeparator(path![0]))
+				{
+					builder.Append(Path.DirectorySeparatorChar);
+				}
+				builder.Append(path);
+			}
+			return builder.ToString();
+		}
 		static bool IsRoot(string path) =>
 			Path.IsPathRooted(path) && Path.GetDirectoryName(path) == null;
 		static bool IsDirectorySeparator(char c) =>

src/Split/netcoreapp2.1/PathPolyfill.cs

@@ -47,6 +47,32 @@ public static string TrimEndingDirectorySeparator(string path)
 			}
 			return path;
 		}
+		/// <summary>
+		/// Concatenates a span of paths into a single path.
+		/// </summary>
+		public static string Join(params string?[] paths)
+		{
+			if (paths.Length == 0)
+			{
+				return string.Empty;
+			}
+			var builder = new System.Text.StringBuilder();
+			foreach (var path in paths)
+			{
+				if (string.IsNullOrEmpty(path))
+				{
+					continue;
+				}
+				if (builder.Length > 0 &&
+					!IsDirectorySeparator(builder[builder.Length - 1]) &&
+					!IsDirectorySeparator(path![0]))
+				{
+					builder.Append(Path.DirectorySeparatorChar);
+				}
+				builder.Append(path);
+			}
+			return builder.ToString();
+		}
 		static bool IsRoot(string path) =>
 			Path.IsPathRooted(path) && Path.GetDirectoryName(path) == null;
 		static bool IsDirectorySeparator(char c) =>

src/Split/netcoreapp2.2/PathPolyfill.cs

@@ -47,6 +47,32 @@ public static string TrimEndingDirectorySeparator(string path)
 			}
 			return path;
 		}
+		/// <summary>
+		/// Concatenates a span of paths into a single path.
+		/// </summary>
+		public static string Join(params string?[] paths)
+		{
+			if (paths.Length == 0)
+			{
+				return string.Empty;
+			}
+			var builder = new System.Text.StringBuilder();
+			foreach (var path in paths)
+			{
+				if (string.IsNullOrEmpty(path))
+				{
+					continue;
+				}
+				if (builder.Length > 0 &&
+					!IsDirectorySeparator(builder[builder.Length - 1]) &&
+					!IsDirectorySeparator(path![0]))
+				{
+					builder.Append(Path.DirectorySeparatorChar);
+				}
+				builder.Append(path);
+			}
+			return builder.ToString();
+		}
 		static bool IsRoot(string path) =>
 			Path.IsPathRooted(path) && Path.GetDirectoryName(path) == null;
 		static bool IsDirectorySeparator(char c) =>