Merge pull request #8 from Crequency/dev=main

[Pull Request] More extensions functions added.

Author: Dynesshely

Common.BasicHelper/IO/DirectoryHelper.cs

@@ -0,0 +1,39 @@
+using Common.BasicHelper.Utils.Extensions;
+using System.Collections.Generic;
+using System.IO;
+using System.Linq;
+
+namespace Common.BasicHelper.IO;
+
+public class DirectoryHelper
+{
+    /// <summary>
+    /// 获取一个文件夹包括子文件夹及其子文件的总大小
+    /// </summary>
+    /// <param name="path">文件夹路径</param>
+    /// <returns>总大小</returns>
+    public static long GetDirectorySize(string path)
+    {
+        var result = 0L;
+
+        var dir = path.GetFullPath();
+
+        if (!Directory.Exists(dir)) return result;
+
+        var pendingFolders = new Queue<DirectoryInfo>();
+
+        pendingFolders.Enqueue(new DirectoryInfo(dir));
+
+        while (pendingFolders.Count > 0)
+        {
+            var folder = pendingFolders.Dequeue();
+
+            result += folder.GetFiles().Sum(file => file.Length);
+
+            foreach (var subFolder in folder.GetDirectories())
+                pendingFolders.Enqueue(subFolder);
+        }
+
+        return result;
+    }
+}

Common.BasicHelper/Utils/Extensions/BinaryHelper.cs

@@ -0,0 +1,82 @@
+using System.Text;
+
+namespace Common.BasicHelper.Utils.Extensions;
+
+public static class BinaryHelper
+{
+    /// <summary>
+    /// 二进制内容转 UTF8 字符串
+    /// </summary>
+    /// <param name="content">字节数组</param>
+    /// <param name="index">内容起始下标</param>
+    /// <param name="count">内容长度</param>
+    /// <returns>UTF8 字符串</returns>
+    public static string ToUTF8(this byte[] content, int? index = null, int? count = null)
+    {
+        if (index is null || count is null)
+            return Encoding.UTF8.GetString(content);
+        else
+            return Encoding.UTF8.GetString(
+                content,
+                index ?? 0,
+                count ?? content.Length
+            );
+    }
+
+    /// <summary>
+    /// 二进制内容转 UTF32 字符串
+    /// </summary>
+    /// <param name="content">字节数组</param>
+    /// <param name="index">内容起始下标</param>
+    /// <param name="count">内容长度</param>
+    /// <returns>UTF32 字符串</returns>
+    public static string ToUTF32(this byte[] content, int? index = null, int? count = null)
+    {
+        if (index is null || count is null)
+            return Encoding.UTF32.GetString(content);
+        else
+            return Encoding.UTF32.GetString(
+                content,
+                index ?? 0,
+                count ?? content.Length
+            );
+    }
+
+    /// <summary>
+    /// 二进制内容转 Unicode 字符串
+    /// </summary>
+    /// <param name="content">字节数组</param>
+    /// <param name="index">内容起始下标</param>
+    /// <param name="count">内容长度</param>
+    /// <returns>Unicode 字符串</returns>
+    public static string ToUnicode(this byte[] content, int? index = null, int? count = null)
+    {
+        if (index is null || count is null)
+            return Encoding.Unicode.GetString(content);
+        else
+            return Encoding.Unicode.GetString(
+                content,
+                index ?? 0,
+                count ?? content.Length
+            );
+    }
+
+    /// <summary>
+    /// 二进制内容转 ASCII 字符串
+    /// </summary>
+    /// <param name="content">字节数组</param>
+    /// <param name="index">内容起始下标</param>
+    /// <param name="count">内容长度</param>
+    /// <returns>ASCII 字符串</returns>
+    public static string ToASCII(this byte[] content, int? index = null, int? count = null)
+    {
+        if (index is null || count is null)
+            return Encoding.ASCII.GetString(content);
+        else
+            return Encoding.ASCII.GetString(
+                content,
+                index ?? 0,
+                count ?? content.Length
+            );
+    }
+}

Common.BasicHelper/Utils/Extensions/StringHelper.cs

@@ -1,4 +1,5 @@
-using System;
+using Common.BasicHelper.IO;
+using System;
 using System.IO;
 using System.Text;
 using System.Threading.Tasks;
@@ -116,4 +117,46 @@ public static void Throw<T>(this string? message) where T : Exception
         var exp = Activator.CreateInstance(typeof(T), message);
         throw (exp as T) ?? new Exception(message);
     }
+
+    /// <summary>
+    /// 获取给定路径的完整路径
+    /// </summary>
+    /// <param name="path">路径</param>
+    /// <returns>完整路径</returns>
+    public static string GetFullPath(this string path) => Path.GetFullPath(path);
+
+    /// <summary>
+    /// 获取给定路径的完整大小 (字节数)
+    /// </summary>
+    /// <param name="path">路径</param>
+    /// <returns>给定路径的完整字节数</returns>
+    public static long GetTotalSize(this string path) => DirectoryHelper.GetDirectorySize(path);
+
+    /// <summary>
+    /// 使用 UTF8 编码将字符串转换为字节数组
+    /// </summary>
+    /// <param name="text">字符串</param>
+    /// <returns>字节数组</returns>
+    public static byte[] FromUTF8(this string text) => Encoding.UTF8.GetBytes(text);
+
+    /// <summary>
+    /// 使用 UTF32 编码将字符串转换为字节数组
+    /// </summary>
+    /// <param name="text">字符串</param>
+    /// <returns>字节数组</returns>
+    public static byte[] FromUTF32(this string text) => Encoding.UTF32.GetBytes(text);
+
+    /// <summary>
+    /// 使用 Unicode 编码将字符串转换为字节数组
+    /// </summary>
+    /// <param name="text">字符串</param>
+    /// <returns>字节数组</returns>
+    public static byte[] FromUnicode(this string text) => Encoding.Unicode.GetBytes(text);
+
+    /// <summary>
+    /// 使用 ASCII 编码将字符串转换为字节数组
+    /// </summary>
+    /// <param name="text">字符串</param>
+    /// <returns>字节数组</returns>
+    public static byte[] FromASCII(this string text) => Encoding.ASCII.GetBytes(text);
 }

view-samples.ps1

@@ -0,0 +1,2 @@
+
+dotnet run --project .\Common.BasicHelper.Samples\

view-samples.sh

@@ -0,0 +1,4 @@
+
+dotnet run --project ./Common.BasicHelper.Samples/
+
+