建議使用 Visual Studio 2017

註釋結構和類別

 

如需 Visual Studio 2017 的最新文件請參閱 Visual Studio 2017 文件

您可以使用作用類似非變異項目的註釋來標註結構和類別,在包含封入結構做為參數或結果值的任何函式呼叫或函式進入/結束點,會假定這些註釋為真。

  • _Field_range_(low, high)

    欄位是在範圍 (含) 從 lowhigh。 相當於使用適當的前置或後置條件套用至已標註物件的 _Satisfies_(_Curr_ >= low && _Curr_ <= high)

  • _Field_size_(size), _Field_size_opt_(size), _Field_size_bytes_(size), _Field_size_bytes_opt_(size)

    欄位,其可寫入的大小是由 size 以項目 (或位元組) 為單位指定。

  • _Field_size_part_(size, count), _Field_size_part_opt_(size, count), _Field_size_bytes_part_(size, count), _Field_size_bytes_part_opt_(size, count)

    欄位,其可寫入的大小是由 size 以項目 (或位元組) 為單位指定,而且可以讀取這些項目 (位元組) 的 count

  • _Field_size_full_(size), _Field_size_full_opt_(size), _Field_size_bytes_full_(size), _Field_size_bytes_full_opt_(size)

    具有可讀取及可寫入大小的欄位,其大小是以 size 所指定的項目 (或位元組) 為單位表示。

  • _Struct_size_bytes_(size)

    具有可讀取及可寫入大小的欄位,其大小是以 size 所指定的項目 (或位元組) 為單位表示。

    套用至結構或類別宣告。 指出該類型的有效物件可能大於所宣告的類型,其位元組數目是由 size 所指定。 例如:

    
    typedef _Struct_size_bytes_(nSize)  
    struct MyStruct {  
        size_t nSize;  
        …  
    };  
    
    
    

    緩衝區大小,以位元組為單位的參數 pM 型別的 MyStruct * 再被視為︰

    min(pM->nSize, sizeof(MyStruct))  
    
    

使用 SAL 註釋減少 C/c + + 程式碼缺失
了解 SAL
註釋函式參數和傳回值
註釋函式行為
註釋鎖定行為
指定套用註釋的時機和位置
內建函式
最佳作法和範例

顯示: