Returns the size of a variable (string, numeric, array, ...) or resizes a dynamic array.
// Resize an array (dynamic array)
MyArr is array dynamic of 5 by 3 int
...
// Resize the array
Dimension(MyArr, 8, 6)
Syntax
Retrieving the size of a variable Hide the details
<Result> = Dimension(<Variable name>)
<Result>: Integer
Requested size. | |
| Pascal string | Number of useful characters in the string.
Example: For a Pascal string on 10, the result will be 10. |
| ASCIIZ string | Number of useful characters in the string.
Example: For an ASCIIZ string on 10, the result will be 9 because there is a binary 0 at the end. |
| Composite variable and structure | Sum of the size (in bytes) of each component.
Caution: This case does not apply to the Classes. |
| Array | Total number of elements in the array. This function is equivalent to ..Count.
Example: For an array of 3 strings, the result will be 3.
Example: For an array of 5 by 3 integers, the result will be 15 (5 * 3)Note: To find out the size of array dimensions, use ArrayInfo. |
| Other | Size in bytes of the memory area corresponding to the variable. For the character strings, use Size. |
<Variable name>: Character string (without quotes)
Name of the variable (any type of variable).
Resizing a dynamic array of N dimensions Hide the details
Dimension(<Array name> , <Number of elements in dimension 1> [, <Number of elements in dimension 2> [... [, <Number of elements in dimension N>]]])
<Array name>: Character string (without quotes)
Name of the variable that corresponds to the dynamic array.
Note: The fixed arrays cannot be resized.
<Number of elements in dimension 1>: Integer
Number of elements in the first dimension of the array.
Caution: The number of array dimensions cannot be modified, nor the type of the elements. A two-dimensional array remains a two-dimensional array.
<Number of elements in dimension 2>: Optional integer
Number of elements in the second dimension of the array.
Caution: The number of array dimensions cannot be modified, nor the type of the elements. A two-dimensional array remains a two-dimensional array.
<Number of elements in dimension N>: Optional integer
Number of elements in the Nth dimension of the array.
Caution: The number of array dimensions cannot be modified, nor the type of the elements. A two-dimensional array remains a two-dimensional array.