mirror of
https://github.com/QB64Official/qb64.git
synced 2024-09-01 16:20:18 +00:00
35 lines
1.1 KiB
Text
35 lines
1.1 KiB
Text
|
The {{KW|UBOUND}} function returns the largest valid index (upper bound) of an array dimension.
|
||
|
|
||
|
|
||
|
{{PageSyntax}}
|
||
|
:''result%'' = {{KW|UBOUND}}(arrayName[, dimension%])
|
||
|
|
||
|
|
||
|
{{PageDescription}}
|
||
|
* {{Parameter|arrayName}} specifies the name of the array.
|
||
|
|
||
|
* {{Parameter|dimension%}} specifies the dimension number, starting with <code>1</code> for the first dimension.
|
||
|
** If omitted, {{Parameter|dimension%}} is assumed to be <code>1</code>.
|
||
|
** If {{Parameter|dimension%}} is less than <code>1</code> or is greater than the number of dimensions, a [[ERROR Codes|subscript out of range]] error occurs.
|
||
|
|
||
|
* {{KW|UBOUND}}, along with {{KW|LBOUND}}, is used to determine the range of valid indexes of an array.
|
||
|
|
||
|
|
||
|
{{PageExamples}}
|
||
|
{{CodeStart}}{{Cl|DIM}} myArray(5) {{Cl|AS}} {{Cl|INTEGER}}
|
||
|
{{Cl|DIM}} myOtherArray(1 to 2, 3 to 4) {{Cl|AS}} {{Cl|INTEGER}}
|
||
|
|
||
|
{{Cl|PRINT}} {{Cl|UBOUND}}(myArray)
|
||
|
{{Cl|PRINT}} {{Cl|UBOUND}}(myOtherArray, 2)
|
||
|
{{CodeEnd}}
|
||
|
{{OutputStart}} 5
|
||
|
4
|
||
|
{{OutputEnd}}
|
||
|
|
||
|
|
||
|
{{PageSeeAlso}}
|
||
|
* {{KW|Arrays}}, {{KW|LBOUND}}
|
||
|
* {{KW|DIM}}, {{KW|COMMON}}, {{KW|STATIC}}, {{KW|SHARED}}
|
||
|
|
||
|
|
||
|
{{PageNavigation}}
|