# ProudNet 實用程式 ## 使用收藏 STL、ATL等也已經提供收藏類(std.map, std.vector, CFastArray, CAtlArray, CAtlMap等)。但是ProudNet在STL和ATL都難以使用的情況下，或在要求高速性能的情況下提供有效的類 | 類別 | 函數 | 註釋 | | ----- | ---------------- | ------------------------------------------------------------------- | | 數組類 | Proud.CFastArray | 內部使用 [**Fast heap**](#fast-heap) 。 | | 鏈接列表類 | Proud.CFastList | 內部使用Fast Heap。與CFastArray不同，該類可以與創建者、消失者和輻射分配操作員一起使用。 | | 地圖類 | Proud.CFastMap | (Key, Value) 使用成對的哈希算法。與CAtlMap的使用方法非常相似，STL.map的重複序列和一些方法可以相同地使用。 | | 設定類 | Proud.CFastSet | 與CFastMap不同，Key是僅有的類，其餘與CFastMap相同。 |
## 快速內存管理器 ProudNet內置高性能內存管理器，開發者可以利用高性能內存管理器加速應用程序的加工性能。 ProudNet支持的存儲管理器大致如下。 ### - Lookaside allocator Lookaside allocator應用了通常的memory pool技術。如果您必須經常分配/ 釋放相同大小的內存，推薦使用 Lookaside allocator 。主要機制如下。 > * 分配新的存儲塊時，分配新的系統內存。 > * 當解鎖存儲塊時,解鎖的塊將返回至lookaside allocator。 > * 重新分配存儲塊時,返還給lookaside allocator的存儲塊將被再利用。這個過程以非常快的速度運行。比OS環境下的內存分配速度要快得多。但也存在缺點。 > * Lookaside allocator總是隻能分配大小相同的內存。 > * 分配給 Lookaside allocator 的內存塊必須在 Lookaside allocator 被破壞之前全部釋放。使用Lookaside allocator的方法如下。 > * 首先使用 Proud.CLookasideAllocator.New 方法創建對象。\ > 創建全局對象也可以。 > * 將存儲塊分配給 Proud.CLookasideAllocator.Alloc 方法。 > * 解除設置爲 Proud.CLookasideAllocator.Free。 Realloc不存在。 > * 解除所有存儲塊後，破壞 Proud.CLookasideAllocator 對象。 ### - Fast Heap ProudNet的Fast heap雖然比Lookaside allocator稍微慢一些，但是比OS環境下的存儲器分配/解除速度更快，可以分配/解除各種大小的存儲器塊。 ProudNet 的 Fastheap 的實現類是 Proud.CFastHeap。 Proud.CFastHeap 還可以在所有存儲塊被破壞後移除 Proud.CFastHeap 對象。 \ Fast heap的使用方法如下。 > * 首先以Proud.CFastHeap.New方法生成Fast heap對象。創建全局對象也可以。 > * 用 Proud.CFastHeap.Alloc 方法分配內存塊。 > * 解除爲Proud.CFastHeap.Free。可用CFastHeap.Realloc重新分配內存塊。 > * 解除所有存儲塊後，破壞 Proud.CFastHeap 對象。 ## 指定為 C++ 類別的預設分配器在C++類中容易接受Fast heap或Lookaside allocator的加速的方法是覆蓋C++的operator new, delete方法。這樣，在創建和破壞C++類作爲new、delete操作符時，將使用Fast heap或Lookaside allocator代替系統的內存heap。 \ 在以下示例中，當將類實例化到 operator new 或 delete 時，高性能內存管理器將允許您分配/ 釋放內存。它們各有優缺點，請適當選擇使用。

➡️ 例子

```cpp class Example { static CLookasideAllocatorPtr gAlloc; // 或者用CFast Heap也OK。 public: void* operator new(size_t size) { return gAlloc->Alloc(size); } void operator delete(void* ptr, size_t size) { gAlloc->Free(ptr); } }; CLookasideAllocatorPtr Example::gAlloc(CLookasideAllocator::New()); // 或者用CFast Heap也OK。 ```

## 智能指示器 ProudNet擁有智能指針Proud.RefCount類。智能指針是指,只要存在參照生成客體的變數,就能起到保障該客體的存在本身的作用。而且，只有當參照該客體的變數不再存在時，該客體纔會被破壞。它還可以解決由於開發人員創建的錯誤（dangling）而引用已被銷毀的物件的問題或未銷毀物件的問題（leak）。智能指針變量每次複製時客體參考計數增加1，下圖中Object Instance一直存在到參考計數爲0。

➡️ 示例代碼

```cpp class A {...}; void Foo() { // 創建 A 對象 Proud::RefCount a(new A); // 變量b與變量a共享。 A的參考計數爲2。 Proud::RefCount b = a; // 變量 a 已解除。然而，A沒有被破壞，因爲參考計數仍然是1。 a = Proud::RefCount (); // 變量b已解除。不再有變量引用A，因此A被破壞。 (即已調用 delete) b = Proud::RefCount (); } ```

有時候想在多處參照客體的智能指示器的狀態下強制破壞客體。例如，如果智能指示器參考擁有打開文件手柄的對象，則有時需要立即破壞擁有文件手柄的對象。但如果智能指示器到處參照客體,就無法知道客體被破壞的時間,因此可能會遇到難關。在這種情況下，可以使用Dispose Pattern明確執行多處參考對象的破壞。 ### - Dispose Pattern Dispose Pattern是一種程序模式,即使不知道一個以上智能指示器所參照的對象被破壞的時間,也能獲得明確破壞客體的效果。如果要將Dispose Pattern運用到智能類客體上,作爲客體的成員變數,具有"自我狀態",這意味着客體是否已經被破壞,無法使用。\ 如果自己的狀態是"已經破壞的狀態",那麼在參考客體時就會發生錯誤,否則就要讓其正常執行。下面是運用Dispose Pattern的例子。 {% hint style="info" %} Dispose Pattern 是 \ 在Java或C#等智能指示器和Garbage Collector的程序設計語言中也有涉及。 {% endhint %}

➡️ 示例代碼

```cpp class A { // 如果是true,意味着該客體處於破壞(dispose)狀態。 bool m_disposed; public: A() { // 剛生成的對象處於未dispose狀態。 m_disposed = false; } ~A() { Dispose(); } void Dispose() { if(m_disposed == false) { // 進行對象破壞相關的實際執行。 // 例如，關閉手中的文件手柄。 ... m_disposed = true; } } }; typedef Proud::RefCount APtr; void Foo() { APtr a(new A); // 創建對象 APtr b = a; // 兩個智能指針變量共享一個對象 a->Dispose(); // 強行破壞客體。 // 現在a、b客體都處於破壞狀態。 // 因此，不能訪問a、b所參考的對象。 ... } ```

## 線程實用程式 ProudNet提供了一些線程實用類。

類別	註釋
Proud.Thread	線程可以很容易地生成和破壞。
Proud.CriticalSection	可以創建critical section。
Proud.CriticalSectionLock	可以lock和unlock。