System.Variant.ArrayLock
C++
Pointer __fastcall ArrayLock();
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | public | sysvari.h | System | Variant |
Description
Verrouille le tableau variant spécifié et renvoie un pointeur sur les données stockées dans ce tableau.
Tant qu'il est verrouillé, un tableau variant ne peut pas être redimensionné et tous les appels à ArrayRedim échouent. Un tableau verrouillé peut être déverrouillé en utilisant ArrayUnlock. Une exception EVariantError est déclenchée si le variant spécifié par A n'est pas un tableau.
Le pointeur renvoyé par ArrayLock pointe sur un tableau d'éléments dans lequel la dimension qui augmente en premier est celle la plus à gauche. En d'autres termes, les dimensions du pointeur de tableau renvoyé sont inversées par rapport aux dimensions du tableau variant.
Après vérification de la validité des bornes et des dimensions d'un tableau variant, il est possible d'utiliser ArrayLock pour accéder directement aux données du tableau, ce qui améliore sensiblement les performances.