Syntaxe :
DEF DYNAMICREMOVEITEMS ( gDynamic, premier&, combien&, stockagePtr& )
Révision :
Novembre 2006 (FB4 Release 4)
Description :
Cette fonction supprime combien& éléments du tableau gDynamic, en commençant par premier& élément. Les éléments suivants du tableau seront décalés pour remplacer les éléments supprimés, ce qui aura pour résultat de donner un tableau avec combien& éléments en moins. Les éléments décalés auront ainsi leur indice réduit de combien&. Si StockagePtr& est nul, les données à supprimer seront définitivement perdues sans recours possible. Si un pointeur est passé en paramètre pour stockagePtr&, alors les données à supprimer seront d'abord copiées à cette adresse en mémoire.
Note :
Qu'il soit actuellement rempli ou non, le tableau dynamique devra avoir déjà contenu des éléments avant de pouvoir être passé à cette fonction.
gDynamic est un tableau dynamique quelconque qui aura été dimensionné au préalable à l'aide d'une commande DYNAMIC ou DIM DYNAMIC.
premier& est la position dans le tableau du premier élément à supprimer. Ce paramètre doit être supérieur ou égal à 0. DEF DYNAMICREMOVEITEMS ne supprimera pas plus d'éléments qu'il y en a dans le tableau. Par exemple, si votre tableau contient 10 éléments (de 0 à 9), et que vous essayez de supprimer 5 éléments en commençant par l'élément 8, alors seulement 2 éléments (de 8 à 9) seront supprimés et le tableau contiendra au final 8 éléments (de 0 à 7).
combien& spécifie le nombre d'éléments contigus à supprimer. S'il n'y a pas assez d'éléments à la suite de premier&, alors seuls les éléments disponibles seront supprimés.
stockagePtr& est une adresse en mémoire vers laquelle les éléments du tableau gDynamic qui doivent être supprimés seront copiés. stockagePtr& doit pointer sur un bloc mémoire alloué (ou bien une variable) d'une taille suffisante pour contenir toutes les données à supprimer. DEF DYNAMICREMOVEITEMS ne vérifie pas que l'espace réservé est approprié. S'il y a moins de combien& éléments disponibles pour la suppression, seuls les éléments supprimés seront copiés dans stockagePtr&. Pour supprimer les données sans les sauvegarder, passez 0 pour le paramètre stockagePtr&.
gDynamic est un tableau dynamique quelconque qui aura été dimensionné au préalable à l'aide d'une commande DYNAMIC ou DIM DYNAMIC.
premier& est la position dans le tableau du premier élément à supprimer. Ce paramètre doit être supérieur ou égal à 0. DEF DYNAMICREMOVEITEMS ne supprimera pas plus d'éléments qu'il y en a dans le tableau. Par exemple, si votre tableau contient 10 éléments (de 0 à 9), et que vous essayez de supprimer 5 éléments en commençant par l'élément 8, alors seulement 2 éléments (de 8 à 9) seront supprimés et le tableau contiendra au final 8 éléments (de 0 à 7).
combien& spécifie le nombre d'éléments contigus à supprimer. S'il n'y a pas assez d'éléments à la suite de premier&, alors seuls les éléments disponibles seront supprimés.
stockagePtr& est une adresse en mémoire vers laquelle les éléments du tableau gDynamic qui doivent être supprimés seront copiés. stockagePtr& doit pointer sur un bloc mémoire alloué (ou bien une variable) d'une taille suffisante pour contenir toutes les données à supprimer. DEF DYNAMICREMOVEITEMS ne vérifie pas que l'espace réservé est approprié. S'il y a moins de combien& éléments disponibles pour la suppression, seuls les éléments supprimés seront copiés dans stockagePtr&. Pour supprimer les données sans les sauvegarder, passez 0 pour le paramètre stockagePtr&.