C++Builder TBits 類深度解析：動態布爾陣列的高效實現與最佳實踐

C++Builder TBits 類深度解析：動態布爾陣列的高效實現與最佳實踐

TBits（定義於 Classes 單元）是 VCL 提供的動態位陣列容器，以位級壓縮存儲布爾值，單位內存可容納 32 倍於 bool[] 的數據量，並支援自動擴容、位操作語義，是標誌位集合、大規模狀態追蹤、位圖掩碼等場景的首選工具。

類層次與核心特性

TObject
  └── TBits

• 位級存儲：內部以 unsigned long 陣列為底層，每元素 32 位。
• 動態擴容：Size 屬性可讀寫，擴容新位預設為 false，縮容高位截斷。
• 下標訪問：Bits[index] 以屬性形式提供 bool 讀寫，越界拋 EBitsError。
• 快速尋找：OpenBit() 回傳首個 false 位索引，資源池分配極快。

核心 API 速查表

典型使用場景與代碼範例

場景 1：輕量級資源池（連線/執行緒/物件 ID 管理）

TBits *pool = new TBits();
pool->Size = MAX_CONNECTIONS;  // 預分配

int Acquire() {
    int idx = pool->OpenBit();   // O(1) 找到空閒位
    if (idx < pool->Size) {
        pool->Bits[idx] = true;  // 標記占用
        return idx;
    }
    return -1;                   // 池滿
}

void Release(int idx) {
    if (idx >= 0 && idx < pool->Size)
        pool->Bits[idx] = false;
}

場景 2：大規模布爾矩陣壓縮（圖像遮罩、地圖可通行性）

const int W = 8192, H = 8192;
TBits *mask = new TBits();
mask->Size = W * H;  // 67M bits ≈ 8 MB，同樣 bool[][] 需 64 MB

inline bool GetPixel(int x, int y) {
    return mask->Bits[y * W + x];
}

inline void SetPixel(int x, int y, bool v) {
    mask->Bits[y * W + x] = v;
}

場景 3：位運算批次處理（自定義擴展）

TBits 未直接暴露 AND/OR/XOR 整陣列操作，但可通過 Size 遍歷或繼承擴展：

class TBitsEx : public TBits {
public:
    void AndWith(const TBitsEx& other) {
        int n = Min(Size, other.Size);
        for (int i = 0; i < n; ++i)
            Bits[i] = Bits[i] && other.Bits[i];
    }
};

性能與內存基準（Win64，Release 模式）

避坑清單

1. 勿直接調用析構：永遠用 delete bitsObj;，~TBits() 僅供內部調用。
2. 索引越界即崩潰：Bits[i] 讀寫會拋 EBitsError，生產碼建議先 if (i >= 0 && i < bits->Size) 保護。
3. 非執行緒安全：多執行緒環境需外部加鎖或改用 TThreadSafeBits（自行實現）。
4. 序列化：TBits 無內建流式存取，需自行遍歷 Bits[i] 寫入 TStream。

TBits 以極簡 API 換取極致空間效率，是 VCL 容器族中「小而美」的典範。下次需要「百萬級布爾旗標」時，請優先考慮它——你的內存會感謝你。