ElementSize
ElementSize 屬性是用來指定項目的大小 (以位元組為單位),而項目的大小是依另一個函式的參數值而定。 這個屬性 (Property) 可以在 Pre 和 Post 屬性 (Attribute) 上使用,而且只能套用至指標或陣列資料型別。
ElementSize 屬性必須與下列任何一個屬性搭配使用:
ValidElements
ValidElementsLength
ValidElementsConst
WritableElements
WritableElementsConst
WritableElementsLength
ElementSize 屬性的值即為型別 size_t 的函式參數。 若要指定等於常數的項目大小,請使用 ElementSizeConst 屬性。
注意事項 |
---|
如果已傳遞 size_t * 做為大小參數,則 ElementSize="*count" 就會用來指定屬性值。 |
範例
下列程式碼會示範如何利用其他參數 (size_t count),以便使用 ElementSize 屬性指定 pc 中每個項目的大小:
// C
#include <CodeAnalysis\SourceAnnotations.h>
void f ([SA_Pre(Deref=0, Null=SA_No, ElementSize="count", WritableElementsConst=3)] void *pc, size_t count);
// C++
#include <CodeAnalysis\SourceAnnotations.h>
using namespace vc_attributes;
void f ([Pre(Deref=0, Null=No, ElementSize="count", WritableElementsConst=3)] void *pc, size_t count);