3.6.1 arrays.inc

Ce fichier contient des macros pour la manipulation de tableaux.

Rand_Array_Item(Array, Stream). Prend aléatoirement un élément d'un tableau à 1 dimension.
Paramètres :

• Array = Le tableau où prendre l'élément.
• Stream = Un canal de nombre aléatoire.

Resize_Array(Array, NewSize). Retaille un tableau à 1 dimension, conservant son contenu.
Paramètres :

• Array = Le tableau à redimensionner.
• NewSize = La nouvelle taille désirée pour le tableau.

Reverse_Array(Array). Inverse l'ordre des éléments d'un tableau à 1 dimension.
Paramètres :

• Array = Le tableau à inverser.

Sort_Compare(Array, IdxA, IdxB). Cette macro est utilisée par les macros Sort_Array() et Sort_Partial_Array(). La macro donnée fonctionne pour les tableaux de numériques à 1 dimension, mais vous pouvez la redéfinir dans votre fichier scène pour des situations plus complexes, des tableaux de vecteurs ou des tableaux à plusieurs dimensions par exemple. Assurez-vous seulement que votre macro retourne vrai si l'élément à IdxA < l'élément à IdxB, et sinon que cela renvoie faux.
Paramètres :

• Array = Le tableau contenant les données à trier.
• IdxA, IdxB = Les positions des éléments du tableau à comparer.

Sort_Swap_Data(Array, IdxA, IdxB). Cette macro est utilisée par les macros Sort_Array() et Sort_Partial_Array(). La macro donnée fonctionne pour les tableaux de numériques à 1 dimension, mais vous pouvez la redéfinir dans votre fichier scène pour des situations plus complexes, des tableaux de vecteurs ou des tableaux à plusieurs dimensions par exemple. La seule obligation est que votre macro échange la donnée en IdxA avec celle de IdxB.
Paramètres :

• Array = Le tableau contenant les données à trier.
• IdxA, IdxB = Les positions des données du tableau à échanger.

Sort_Array(Array). Cette macro trie un tableau de numériques à 1 dimension, bien que vous pouvez redéfinir les macros Sort_Compare() et Sort_Swap_Data() pour gérer des tableaux à plusieurs dimensions et d'autres types de données.
Paramètres :

• Array = Le tableau à trier.

Sort_Partial_Array(Array, FirstInd, LastInd). Cette macro est comme Sort_Array(), mais elle trie une partie spécifique du tableau au lieu de la totalité.
Paramètres :

• Array = Le tableau à trier.
• FirstInd, LastInd = Les indices de début et de fin de la fourchette à trier.

3.6 Les fichiers inclus

3.6.2 chars.inc