PackArray
Revision as of 21:25, 26 February 2008 by imported>Speedo (Added example)
Beta Function
This function has not been fully tested yet, and is not ready to be used in a released mod. It may not have the same function in later versions, may require the script to be recompiled, or simply may be removed. Use for testing purposes only until the author of the function says otherwise.
A command for Pluggy.
Syntax:
PackArray ArrayID:long Global:short
Removes all unused indexes from the array, and resizes the array to the count of filled indexes.
- Since the values in the array are moved to fill the gaps, any index from the array stored before the operation will become meaningless.
- If you want to modify an array from another mod, you will need to set the Global flag to 1. If Global is 0 or unset the function will fail. If the array is protected the function will fail.
Example:
If you have the following data in an array myArray :
| Index | Value |
|---|---|
| Index 0 | 3 |
| Index 1 | 10 |
| Index 2 | (empty) |
| Index 3 | 8 |
| Index 4 | (empty) |
| Index 5 | (empty) |
| Index 6 | 15 |
then
PackArray myArray
will modify the array to be the following:
| Index | Value |
|---|---|
| Index 0 | 3 |
| Index 1 | 10 |
| Index 2 | 8 |
| Index 3 | 15 |