ElementSize
Mise à jour : novembre 2007
La propriété ElementSize est utilisée pour spécifier une taille d'élément, en octets, qui dépend de la valeur d'un autre paramètre de la fonction. Cette propriété est autorisée sur les attributs Pre et Post, et ne peut être appliquée qu'aux types de données pointeur ou tableau.
La propriété ElementSize doit être utilisée en association avec n'importe laquelle des propriétés suivantes :
ValidElements
ValidElementsLength
ValidElementsConst
WritableElements
WritableElementsConst
WritableElementsLength
La valeur de la propriété ElementSize est un paramètre de la fonction de type size_t. Pour spécifier une taille d'élément qui est constante, utilisez la propriété ElementSizeConst.
.gif "Remarque") Remarque : |
|---|
Si size_t*count est passé comme paramètre de taille, alors ElementSize="*count" est utilisé pour spécifier la valeur de propriété. |
Exemple
Le code suivant montre l'utilisation d'un autre paramètre (size_t count) pour spécifier la taille de chaque élément dans pc à l'aide de la propriété ElementSize :
// 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);