| 類別 | 字節數 (Default 編碼) | Unicode 碼位範圍 | 典型字符 |
|---|---|---|---|
| 半角 (SBC/DBC) | 1 字節 | U+0020 ~ U+007E | 空格(32)、數字字母、標點 |
| 全角 (SBC) | 2 字節 | U+FF01 ~ U+FF5E | 全角空格(12288)、全角字母數字標點 |
核心規律:除空格外,**半角 33~126 ↔ 全角 65281~65374,差值固定 65248 (0xFF00)**。空格特殊:半角 32 ↔ 全角 12288 (0x3000)。
using System.Text;
public static bool IsHalfWidth(string s) {
// 半角:字符數 == 字節數 (Default 編碼通常為 GBK/GB2312/CP936)
return s.Length == Encoding.Default.GetByteCount(s);
}
public static bool IsFullWidth(string s) {
// 全角:字節數 == 2 * 字符數
return Encoding.Default.GetByteCount(s) == 2 * s.Length;
}
注意:Encoding.Default 取決於系統當前 ANSI 代碼頁(中文 Windows 通常為 936/GBK)。跨平台/容器化部署時**顯式指定編碼** Encoding.GetEncoding(936) 或改用 Unicode 碼位判斷(見下文)。
public static class FullHalfConverter {
private const int HalfSpace = 0x0020; // 32
private const int FullSpace = 0x3000; // 12288
private const int Diff = 0xFF00; // 65248
/// 半角 → 全角
public static string ToFullWidth(string input) {
if (string.IsNullOrEmpty(input)) return input;
char[] chars = input.ToCharArray();
for (int i = 0; i < chars.Length; i++) {
int c = chars[i];
if (c == HalfSpace) chars[i] = (char)FullSpace;
else if (c >= 0x0021 && c <= 0x007E) // 33~126
chars[i] = (char)(c + Diff);
}
return new string(chars);
}
/// 全角 → 半角
public static string ToHalfWidth(string input) {
if (string.IsNullOrEmpty(input)) return input;
char[] chars = input.ToCharArray();
for (int i = 0; i < chars.Length; i++) {
int c = chars[i];
if (c == FullSpace) chars[i] = (char)HalfSpace;
else if (c >= 0xFF01 && c <= 0xFF5E) // 65281~65374
chars[i] = (char)(c - Diff);
}
return new string(chars);
}
}
[TestMethod]
public void FullHalfConversionTest() {
string half = "Hello World 123!@#";
string full = FullHalfConverter.ToFullWidth(half);
Assert.AreEqual("Hello World 123!@#".Select(c => c == ' ' ? '\u3000' : (c >= 33 && c <= 126 ? (char)(c + 0xFF00) : c)).ToArray(), full.ToCharArray());
string back = FullHalfConverter.ToHalfWidth(full);
Assert.AreEqual(half, back);
// 混合字符串
string mixed = "ABC中文123";
string mixedFull = FullHalfConverter.ToFullWidth(mixed);
Assert.AreEqual("ABC中文123", FullHalfConverter.ToHalfWidth(mixedFull)); // 中文不在轉換範圍,保持不變
}
public static void ToHalfWidthInPlace(Span span) {
for (int i = 0; i < span.Length; i++) {
char c = span[i];
if (c == FullSpace) span[i] = (char)HalfSpace;
else if (c >= 0xFF01 && c <= 0xFF5E) span[i] = (char)(c - Diff);
}
}
// 用法:ToHalfWidthInPlace(buffer.AsSpan());
全半角轉換核心是 **Unicode 碼位映射(差值 0xFF00)+ 空格特例**。生產代碼**拒絕依賴 Encoding.Default**,改用無編碼依賴的碼位運算,並配合 Span<char> 實現零分配高性能轉換。單元測試覆蓋邊界(空格、邊界字符、混合中文)是質量保障底線。