Syntaxe :
DEF DYNAMICINSERTITEMS ( gDynamic, insert&, combien&, remplissagePtr& )
Révision :
Novembre 2006 (FB4 Release 4)
Description :
Cette fonction décale l'élément insert& et tous les éléments qui le suivent dans le tableau gDynamic, de combien& positions pour laisser la place à combien& nouveaux éléments commençant à la position insert&. Le nombre total d'éléments dans le tableau augmente de combien& (ou plus—voir plus bas), et les éléments insérés (commençant à insert&) contiendront les données pointées en mémoire par remplissagePtr&, ou par des zéros si remplissagePtr& est nul.
Note :
Qu'il soit actuellement rempli ou non, le tableau dynamique doit avoir déjà contenu des données avant de pouvoir être passé à cette fonction.
gDynamic est un tableau dynamique quelconque qui doit avoir été dimensionné au préalable à l'aide d'une commande DYNAMIC ou DIM DYNAMIC.
insert& est la position dans le tableau où le premier élément sera inséré. Sa valeur doit être supérieure ou égale à 0. Normalement insert& est moins grand que le nombre actuel d'éléments contenus dans le tableau. Si ce paramètre est plus grand, alors de nouveaux éléments seront insérés pour fournir la place à combien&éléments commençant à l'élément insert&. Par exemple, si vous avez 10 éléments (de 0 à 9), et que vous insérez 2 éléments commençant à la position 13, votre tableau contiendra les 10 éléments originaux, suivis de 3 éléments vides (de 10 à 12), et des 2 éléments insérés (de 13 à 14) pour un total de 15 éléments.
combien& spécifie le nombre d'éléments à insérer. C'est aussi la quantité avec laquelle le plus grand indice du tableau sera augmenté.
remplissagePtr& est une adresse en mémoire pointant sur les nouvelles données à insérer dans le tableau gDynamic. Ces données doivent être au même format, et à la même taille, que les éléments du tableau gDynamic. Dans Mac OS 9, si vous passez un handle déréférencé pour le paramètre remplissagePtr&, vous devez d'abord verrouiller le handle. DEF DYNAMICINSERTITEMS ne vérifie pas que les données à copier sont adéquates.
gDynamic est un tableau dynamique quelconque qui doit avoir été dimensionné au préalable à l'aide d'une commande DYNAMIC ou DIM DYNAMIC.
insert& est la position dans le tableau où le premier élément sera inséré. Sa valeur doit être supérieure ou égale à 0. Normalement insert& est moins grand que le nombre actuel d'éléments contenus dans le tableau. Si ce paramètre est plus grand, alors de nouveaux éléments seront insérés pour fournir la place à combien&éléments commençant à l'élément insert&. Par exemple, si vous avez 10 éléments (de 0 à 9), et que vous insérez 2 éléments commençant à la position 13, votre tableau contiendra les 10 éléments originaux, suivis de 3 éléments vides (de 10 à 12), et des 2 éléments insérés (de 13 à 14) pour un total de 15 éléments.
combien& spécifie le nombre d'éléments à insérer. C'est aussi la quantité avec laquelle le plus grand indice du tableau sera augmenté.
remplissagePtr& est une adresse en mémoire pointant sur les nouvelles données à insérer dans le tableau gDynamic. Ces données doivent être au même format, et à la même taille, que les éléments du tableau gDynamic. Dans Mac OS 9, si vous passez un handle déréférencé pour le paramètre remplissagePtr&, vous devez d'abord verrouiller le handle. DEF DYNAMICINSERTITEMS ne vérifie pas que les données à copier sont adéquates.