チェンジセット 1690 (default)

日時:

2024/09/19 10:00:04 (2週前)

更新者:

hizuya@…

ログメッセージ:

• Unicode の BOM を判定するメソッドを追加。

場所:

framework/trunk

ファイル:

• CoreLibrary/Sources/IO/IOUtility.cs (更新) (1個の差分)
• CoreTest/Sources/IO/IOUtilityTest.cs (更新) (2個の差分)

framework/trunk/CoreLibrary/Sources/IO/IOUtility.cs

@@ -1420 +1420 @@
 
         /// <summary>
+        /// バイト配列の先頭より BOM を読み取って Unicode エンコーディングを判定します。
+        /// </summary>
+        /// <param name="bytes">
+        /// バイト配列。
+        /// </param>
+        /// <param name="offset">
+        /// <paramref name="bytes"/> の開始オフセット。
+        /// </param>
+        /// <param name="length">
+        /// <paramref name="bytes"/> の <paramref name="offset"/> からの有効な長さ。
+        /// </param>
+        /// <returns>
+        /// 有効な BOM が有った場合は、そのエンコーディング。
+        /// それ以外の場合は <see langword="null"/> 参照です。
+        /// </returns>
+        public static Encoding DetectUnicodeEncodingByBom(byte[] bytes, int offset, int length)
+        {
+            return DetectEncodingByBom(bytes, offset, length);
+        }
+
+        /// <summary>
         /// 指定したストリームを、破棄時に発生する例外を無視するストリームでラップします。
         /// </summary>

framework/trunk/CoreTest/Sources/IO/IOUtilityTest.cs

@@ -31 +31 @@
     using System.Text;
     using FCSoft.SilverFrost.Framework.Security;
+    using FCSoft.SilverFrost.Framework.Text;
     using FCSoft.SilverFrost.Framework.UnitTest;
     using NUnit.Framework;
@@ -679 +680 @@
 
         /// <summary>
+        /// <see cref="IOUtility.DetectUnicodeEncodingByBom"/> をテストします。
+        /// </summary>
+        /// <param name="data">
+        /// バイト配列を表す 16 進数文字列。
+        /// </param>
+        /// <param name="offset">
+        /// <paramref name="data"/> をバイト配列したときの開始オフセット。
+        /// </param>
+        /// <param name="length">
+        /// <paramref name="data"/> をバイト配列したときの <paramref name="offset"/> からの有効な長さ。
+        /// </param>
+        /// <returns>
+        /// <see cref="IOUtility.DetectUnicodeEncodingByBom"/> の戻り値の。
+        /// <see cref="Encoding.WebName"/>。
+        /// </returns>
+        [Test]
+        [TestCase("", 0, 0, ExpectedResult = null)]
+        [TestCase("00", 0, 1, ExpectedResult = null)]
+        [TestCase("00000000", 2, 0, ExpectedResult = null)]
+        [TestCase("00000000", 0, 4, ExpectedResult = null)]
+        [TestCase("00000000", 1, 2, ExpectedResult = null)]
+        //// BOM だけ
+        [TestCase("EFBBBF", 0, 3, ExpectedResult = "utf-8")]
+        [TestCase("FEFF", 0, 2, ExpectedResult = "utf-16BE")]
+        [TestCase("FFFE", 0, 2, ExpectedResult = "utf-16")]
+        [TestCase("0000FEFF", 0, 4, ExpectedResult = "utf-32BE")]
+        [TestCase("FFFE0000", 0, 4, ExpectedResult = "utf-32")]
+        //// BOM の前後に別の値
+        [TestCase("99EFBBBF99", 1, 3, ExpectedResult = "utf-8")]
+        [TestCase("99FEFF99", 1, 2, ExpectedResult = "utf-16BE")]
+        [TestCase("99FFFE99", 1, 2, ExpectedResult = "utf-16")]
+        [TestCase("990000FEFF99", 1, 4, ExpectedResult = "utf-32BE")]
+        [TestCase("99FFFE000099", 1, 4, ExpectedResult = "utf-32")]
+        public string TestDetectUnicodeEncodingByBom(string data, int offset, int length)
+        {
+            byte[] bytes = TextUtility.ConvertHexToBinary(data);
+            Encoding encoding = IOUtility.DetectUnicodeEncodingByBom(bytes, offset, length);
+            return encoding != null ? encoding.WebName : null;
+        }
+
+        /// <summary>
         /// <see cref="IOUtility.CreateCloseExceptionIgnorableStream"/> をテストします。
         /// </summary>