萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

C# 全角半角字符判斷與轉換完整實現:編碼原理與生產級代碼

全角半角編碼本質

類別字節數 (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)。

判斷邏輯:字節數 vs 字符數


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 碼位判斷(見下文)。

生產級轉換實現(基於 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)); // 中文不在轉換範圍,保持不變
}

性能優化:Span<char> 避免分配


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());

應用場景

  • 用戶輸入正規化:搜索關鍵詞、表單驗證、去重比對前統一轉半角。
  • legacy 系統對接:大型機/終端機常要求全角輸入。
  • 排序/分組:統一字符寬度避免「全角 A」與「半角 A」分桶。

結語

全半角轉換核心是 **Unicode 碼位映射(差值 0xFF00)+ 空格特例**。生產代碼**拒絕依賴 Encoding.Default**,改用無編碼依賴的碼位運算,並配合 Span<char> 實現零分配高性能轉換。單元測試覆蓋邊界(空格、邊界字符、混合中文)是質量保障底線。

copyright © 萬盛學電腦網 all rights reserved