From d7e7304243faf947eb2c2f3e040f163c4ad9bce4 Mon Sep 17 00:00:00 2001
From: Elivo <elivo@me.com>
Date: Sun, 30 Mar 2025 21:15:32 +0800
Subject: [PATCH] =?UTF-8?q?=E5=A2=9E=E5=8A=A0=20TextUtility.Lock=EF=BC=8C?=
 =?UTF-8?q?=E5=AE=9E=E7=8E=B0=E7=BA=BF=E7=A8=8B=E9=94=81=E3=80=82?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 Apewer/Internals/Locker.cs | 75 ++++++++++++++++++++++++++++++++++++++
 Apewer/TextUtility.cs      | 26 +++++++++++++
 2 files changed, 101 insertions(+)
 create mode 100644 Apewer/Internals/Locker.cs

diff --git a/Apewer/Internals/Locker.cs b/Apewer/Internals/Locker.cs
new file mode 100644
index 0000000..c38bdc5
--- /dev/null
+++ b/Apewer/Internals/Locker.cs
@@ -0,0 +1,75 @@
+using System;
+using System.Collections.Generic;
+using System.Text;
+
+namespace Apewer.Internals
+{
+
+    /// <summary>锁。</summary>
+    internal class Locker
+    {
+
+        Dictionary<int, Class<object>> _pool = new Dictionary<int, Class<object>>();
+
+        /// <summary>标记指定的字符串。</summary>
+        static int Key(string s) => s == null ? 0 : s.GetHashCode();
+
+        /// <summary>清除所有缓存的锁。</summary>
+        public void Clear()
+        {
+            lock (_pool)
+            {
+                _pool.Clear();
+            }
+        }
+
+        /// <summary>锁定字符串，执行 Action。</summary>
+        public void InLock(string text, Action action)
+        {
+            if (action == null) return;
+
+            var key = Key(text);
+            Class<object> locker;
+            lock (_pool)
+            {
+                if (!_pool.TryGetValue(key, out locker))
+                {
+                    locker = new Class<object>();
+                    _pool.Add(key, locker);
+                }
+            }
+
+            lock (locker.Value)
+            {
+                action.Invoke();
+            }
+        }
+
+        /// <summary>锁定字符串，执行 Func。</summary>
+        public T InLock<T>(string text, Func<T> func)
+        {
+            if (func == null) return default;
+
+            var key = Key(text);
+            Class<object> locker;
+            lock (_pool)
+            {
+                if (!_pool.TryGetValue(key, out locker))
+                {
+                    locker = new Class<object>();
+                    _pool.Add(key, locker);
+                }
+            }
+
+            T result;
+            lock (locker.Value)
+            {
+                result = func.Invoke();
+            }
+            return result;
+        }
+
+    }
+
+
+}
diff --git a/Apewer/TextUtility.cs b/Apewer/TextUtility.cs
index 00cb80a..e0d964a 100644
--- a/Apewer/TextUtility.cs
+++ b/Apewer/TextUtility.cs
@@ -1044,6 +1044,32 @@ namespace Apewer
             return trim ? Trim(middle, trimBlank) : middle;
         }
 
+        #region Lock
+
+        static Locker _locker = new Locker();
+
+        /// <summary>锁定文本，在锁中执行函数。</summary>
+        /// <param name="text">要锁定的文本。</param>
+        /// <param name="inLock">要在锁中执行的函数。</param>
+        /// <exception cref="ArgumentNullException"></exception>
+        public static T Lock<T>(this string text, Func<T> inLock)
+        {
+            if (inLock == null) throw new ArgumentNullException(nameof(inLock));
+            return _locker.InLock(text, inLock);
+        }
+
+        /// <summary>锁定文本，在锁中执行函数。</summary>
+        /// <param name="text">要锁定的文本。</param>
+        /// <param name="inLock">要在锁中执行的函数。</param>
+        /// <exception cref="ArgumentNullException"></exception>
+        public static void Lock<T>(this string text, Action inLock)
+        {
+            if (inLock == null) throw new ArgumentNullException(nameof(inLock));
+            _locker.InLock(text, inLock);
+        }
+
+        #endregion
+
         #region encoding
 
         /// <summary>检查字节数组包含 UTF-8 BOM 头。</summary>