PLOOC下載 - PLOOC源代碼下載

PLOOC

C#源碼

v4.6.4 Minor Improvement

下載

PLOOC（通過ANSI-C的受保護的低空面向對象的編程）v4.6.4

介紹

用ANSI-C（稱為PLOOC ['plu：k]）受保護的低空面向對象的編程，是一組精心塗層的C型宏觀模板：

為私人班成員提供保護。

注意：可以通過定義宏__OOC_DEBUG__來促進調試來禁用此保護。

支持受保護的成員。
支持多重繼承。
支持接口實現。
支持某些編譯器中的嚴格類型檢查/驗證，例如啟用具有多文件編譯的IAR。
符合ANSI-C99 。
- 也支持ANSI-C90，但私人會員保護被禁用。
支持超負荷。
- 需要C11或_Generic 。
提供低頂的開銷。

注意：開銷幾乎為零。該模板充分利用ANSI-C的強制編譯規則，以最少的成本提供面向對象的功能。

    - Suitable for both bare-metal and RTOS environments.
    - Suitable for both 8-bit and 32-bit MCUs.

是什麼使PLOOC與其他OOC不同？

面向對象的C（OOC）的概念並不是什麼新鮮事物。有許多具有面向對象的編程功能擴展ANSI-C的庫，SDK和模板。儘管PLOOC在代碼尺寸和性能方面都強調了其低開銷，但許多基於宏觀的OOC解決方案也提供了較低的開銷。 PLOOC不強迫您使用堆或池內存管理，也不提供垃圾收集（GC）功能，而將這些選項留給用戶。這使其適用於8位系統。雖然有些人可能將其視為缺點，但這是故意的設計選擇。我不會為此爭論。

那麼，是什麼真正使Plooc與眾不同呢？它只是另一個重新發明的輪子嗎？

答案是否定的。

PLOOC引入了一個獨特的功能，大多數其他解決方案都缺乏：它確保了班級的私人成員是真正的私人和受保護的。這意味著阻止類源代碼外的用戶訪問這些私人成員。取而代之的是，他們只看到一個堅實的內存塊，被掩蓋為字節數組。由於C中的類別由結構模仿，因此PLOOC使用掩蓋結構實現類。正如預期的那樣，只有類源代碼才能訪問私有成員，並且只有派生類的類源代碼才能訪問基類的受保護成員。但是，所有人都可以訪問公共成員。

這是如何運作的？您可能已經從“蒙版結構”一詞中猜到了它。本質上，這是標題文件中的類型技巧。

此技巧效果很好，直到遇到嚴格的類型檢查編譯器為止。最著名的（或臭名昭著的）例子是IAR，尤其是當啟用多文件彙編模式時。沒有類型的技巧可以在IAR的多文件彙編模式的嚴格檢查中倖存下來。

 //! The original structure in the class source code
struct byte_queue_t {
    uint8_t   *pchBuffer;
    uint16_t  hwBufferSize;
    uint16_t  hwHead;
    uint16_t  hwTail;
    uint16_t  hwCount;
};

//! The masked structure: the class byte_queue_t in the header file
typedef struct byte_queue_t {
    uint8_t chMask [sizeof(struct {
        uint8_t   *pchBuffer;
        uint16_t  hwBufferSize;
        uint16_t  hwHead;
        uint16_t  hwTail;
        uint16_t  hwCount;
    })];
} byte_queue_t;

為了完成這項工作，您必須確保類源代碼不包括其自己的接口標頭文件。如果您認真對待內容，您甚至可以進一步走：

 //! The masked structure: the class byte_queue_t in the header file
typedef struct byte_queue_t {
    uint8_t chMask [sizeof(struct {
        uint32_t        : 32;
        uint16_t        : 16;
        uint16_t        : 16;
        uint16_t        : 16;
        uint16_t        : 16;
    })];
} byte_queue_t;

注意：提供了上述代碼段來說明基本方案，但不實用，因為創建掩碼數組時缺少原始結構的對齊方式。要解決此問題，您需要使用__alignof__()操作員提取對齊信息，並使用__attribute__((aligned()))相應地設置蒙版數組的對齊屬性。

PLOOC提供了具有不同方案的“私人保護”功能，而不是依靠類型作用。這使其可以支持啟用具有C99功能的幾乎所有C編譯器。作為作者，我必須承認，花了大量時間來弄清楚如何處理嚴格的類型檢查，而初始方案既醜陋又違反直覺。多虧了西蒙·齊安（Simon Qian）的鼓舞人心的貢獻，又花了三個月的時間才能將plooc完善成優雅而簡單的東西。亨利·朗的支持也至關重要。

希望您喜歡這種獨特的方法來應對C.

如果您有任何疑問或建議，請隨時告訴我們。

更新日誌

[08/25/2024]修復類模板，版本4.6.4
- 更新的讀數
- 添加__plooc_malloc_align()和__plooc_free
- 添加private_method() ， protected_method()和public_method()
- 刪除對GNU擴展的依賴性
- 其他小變化。
[11/02/2022]修復類模板，版本4.6.3
[12/05/2022]提高與最新C ++語言的兼容性，版本4.6.2
[02/01/2022]為堆添加輔助宏，版本4.6.1
- 添加__new_class()和__free_class()以使用malloc，並與構造函數和驅動器一起免費使用，即xxxx_init（）和xxxx_depose（） 。
- 更新示例項目
- 將CI添加到GitHub。
[30/12/2021]改進了CMSIS-PAC，版本4.6.0
- 添加了示例項目到CMSIS包裝
- 添加了用於創建新基類和派生類的代碼模板。
- 其他次要更新
[29/12/2021]添加CMSIS-PACK，版本4.5.9
- C99用於LLVM和GCC時被抑制警告。
- 修復了示例中未對準的訪問問題
- 添加了CMSIS包裝
[28/11/2020]次要更新，版本4.5.7
- 修復了plooc.h中的錯字
- 在宏中應用的統一資本化，即如果宏是大寫，則參數在大寫中，如果宏為小寫，則參數為小寫。
- 添加的警告表明黑匣子模板與其他模板不兼容，與其他模板混合時應單獨或在特殊規則下使用。
[05/08/2020]添加__plooc_class_implement__和__plooc_class_inherit__版本4.5.6
- 使用的__xxxxx__是強調的，因為__xxxxx通常表示“內部”
- 原始的__plooc_class_implement和__plooc_class_inherit被棄用，並將保留一段時間，然後完全刪除。
[18/05/2020]介紹了宏觀的簡短和長方形，版本4.5.5
- dcl_xxxxx/dectare_xxxxx
- def_xxxx/define_xxxxx; end_def_xxxx/end_define_xxxx
[16/05/2020]次要更新，版本4.5.4a
- 當您想將C源代碼與C ++源代碼混合時，引入了__OOC_CPP__替換__OOC_DEBUG__。請將其放入項目全局配置中。
[11/05/2020]次要更新，版本4.5.4
- 使在C ++項目中使用基於PLOOC的C源代碼成為可能
  - 請確保項目中定義了__ooc_debug__
[15/04/2020]更新__plooc_eval，版本4.5.3
- 從1個增加了參數數量的範圍~~8至0~~ 16。
[19/02/2020]啟用RAM足跡優化的次要更新，版本4.52
- 引入宏PLOOC_CFG_REMOVE_MEMORY_LAYOUT_BOUNDARY___ES_WITH_CAUTION，可刪除Ploooc_visible的結構佈局邊界。當滿足某些條件並定義__ooc_debug__時，它可以保存RAM。請謹慎使用它，因為當未定義__ooc_debug__時，它會導致不同的內存佈局。
[21/01/2020] C90的MISC更新，版本4.51
[09/06/2019]增加了對C89/90，版本4.50的支持
- 增加了對超負荷的全部支持（需要C11）
[09/05/2019]增加了對C89/90，版本4.40的支持
- 執行C89/90時，應始終定義__OOC_DEBUG__。
- 對私人和受保護成員的保護被關閉。
[08/15/2019]更新了PLOOC_CLASS_STRICT.H，使用更多軟性語法，版本4.31
- 現在，用戶可以為public_member，private_member和preatected_member使用任意訂單。
- 分離器“”可以忽略。
- 簡化了PLOOC_CLASS_STRICT.H模板。一些常見的宏移動到plooc_class.h，稍後將由其他模板共享。
[08/14/2019]引入了對超載的有限支持，版本4.30的支持
- 二手可以使用Macro __plooc_eval（）選擇具有相應數量參數數的正確API。
[07/26/2019]語法更新，版本4.21
- 修改PLOOC_CLASS_BLACK_BOX.H將統一語法用作其他模板。
- 將extern_class和end_extern_class添加到所有模板
[07/24/2019]添加了新的OOC類模板，版本4.20
- 添加了plooc_class_black_box.h。此模板用於創建True-Black-box模塊。它僅支持“私人”和“公共”，但沒有“受保護”。
[07/12/2019]次要更新，版本4.13
- 添加了“ __ooc_release__”。結構僅需要在開發階段進行保護。對於私人屬性，提供了用於控制訪問的設置和getter。可以刪除掩碼，並允許在發布階段觀察的私人成員，在此階段，可以將固定器和get子從API功能更改為宏。通過這樣做，代碼大小可能較小。
[05/30/2019]次要更新，版本4.12
- 刪除了“此”，“目標”和“基礎”，以防止命名污染。
- 從頂級類定義中刪除了Plooc_align，以防止編譯器對這種比對裝飾的解釋不一致。
[05/02/2019]效率提高，版本4.11
- 使用__Alignof__來提高掩蔽結構時的代碼效率
- 在簡單和嚴格的版本中使用的Ploooc_invisible和Ploooc_vissible
- 簡化了結構
- 提高了IAR和ARMCLANG（LLVM）之間的能力
[05/01/2019]兼容性提高，版本4.04
- 添加了plooc_packed and plooc_align以添加對齊支持
- 使用UINT_FAST8_T替換UINT8_T來使用目標機器隱含對齊。
[04/20/2019]將PLOOC上傳到GitHub，版本4.03
- 添加了默認類對齊控制
- 更新的示例和讀數
[04/17/2019]將PLOOC上傳到GitHub，版本4.01
- 添加了支持私有方法，受保護方法和公共方法的方法定義
- 添加了readme和示例byte_queue

執照

PLOOC庫是由Gorgonmeducer（王卓然）撰寫的，[email protected]和Simon Qian （錢曉晨）https://github.com/versaloon在Henry Long [email protected]的支持下。

PLOOC庫是根據開源許可證Apache 2.0發布的，該庫允許商業和非商業用途均無限制。唯一的要求是，信用量是在源代碼和產品的文檔中給出的。

完整的許可文本如下：

 /*****************************************************************************
 *   Copyright(C)2009-2019 by GorgonMeducer<[email protected]>    *
 *                       and  SimonQian<[email protected]>             *
 *         with support from  HenryLong<[email protected]>                  *
 *                                                                           *
 *  Licensed under the Apache License, Version 2.0 (the "License");          *
 *  you may not use this file except in compliance with the License.         *
 *  You may obtain a copy of the License at                                  *
 *                                                                           *
 *     http://www.apache.org/licenses/LICENSE-2.0                            *
 *                                                                           *
 *  Unless required by applicable law or agreed to in writing, software      *
 *  distributed under the License is distributed on an "AS IS" BASIS,        *
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. *
 *  See the License for the specific language governing permissions and      *
 *  limitations under the License.                                           *
 *                                                                           *
 ****************************************************************************/

貢獻

模板

模塊	禁忌者
plooc.h	Gorgonmeducer
plooc_class.h	Gorgonmeducer，Simon Qian
plooc_class_strict.h	Gorgonmeducer
plooc_class_back_box.h	Gorgonmeducer
plooc_class_simple.h	西蒙·錢
plooc_class_simple_c90.h	Gorgonmeducer

例子

模塊	禁忌者
如何定義課程	Gorgonmeducer
如何訪問受保護的成員	Gorgonmeducer
如何實施多態性	Gorgonmeducer

聲稱使用PLOOC的申請 /項目

[vsf] [https://github.com/vsfteam/vsf]
[GMSI] [https://github.com/gorgonmeducer/generic_mcu_software_infrastructure]
[mqttclient] [https://github.com/jiejietop/mqttclient]

如何使用

plooc的示例

介紹

為了展示PLOOC如何易於易於使用，提供了示例以演示新的OOPC方法的不同方面。目前，可用示例是：

BYTE_QUEUE
Enhanced_byte_queue

更多示例將在以後添加...

示例1：如何定義課程
此示例顯示
- 如何定義課程
  - 如何添加私人會員
  - 如何添加受保護的成員
- 如何訪問班級成員
- 如何定義用戶友好界面
示例2：如何訪問受保護的成員
- 如何從基類繼承
  - 如何訪問從基礎繼承的受保護成員
- 如何繼承界面
- 如何覆蓋基本方法
示例3：如何實施超負荷
- 如何使用PLOOC實施過載
- 需要C11支持

 LOG_OUT("rn-[Demo of overload]------------------------------rn");
LOG_OUT((uint32_t) 0x12345678);
LOG_OUT("rn");
LOG_OUT(0x12345678);
LOG_OUT("rn");
LOG_OUT("PI is ");
LOG_OUT(3.1415926f);
LOG_OUT("rn");

LOG_OUT("rnShow BYTE Array:rn");
LOG_OUT((uint8_t *)main, 100);

LOG_OUT("rnShow Half-WORD Array:rn");
LOG_OUT((uint16_t *)main, 100/sizeof(uint16_t));

LOG_OUT("rnShow WORD Array:rn");
LOG_OUT((uint32_t *)main, 100/sizeof(uint32_t));

示例3