UBound: Difference between revisions

From NSB App Studio
Jump to navigation Jump to search
(Created page with "UBOUND(''array''[, ''dimension'']) '''Description''' UBOUND returns a long value specifying the largest available subscript in the specified dimension of a given array. The ...")
 
 
(8 intermediate revisions by 5 users not shown)
Line 1: Line 1:
UBOUND(''array''[, ''dimension''])
''This function is for BASIC compatibility. It is not available in pure JavaScript projects.''  


'''Description'''
UBound(''array''[, ''dimension''])


UBOUND returns a long value specifying the largest available subscript in the specified dimension of a given array. The required parameter, ''array'', is any array variable. The optional parameter, ''dimension'', specifies which dimension's upper bound is returned, beginning with the default, 1.
== Description ==


'''Example'''
UBound returns a long value specifying the largest available subscript in the specified dimension of a given array. The required parameter, ''array'', is any array variable. The optional parameter, ''dimension'', specifies which dimension's upper bound is returned, beginning with the default, 1.  If the array is empty, -1 is returned. (For Android 2.1, use array.length instead.)
 
== Example (Basic) ==


<pre>
<pre>
REM UBOUND Example
Rem UBound Example
'UBOUND returnsupperboundofarraydimension
'UBound returns upper bound of array dimension
DIM Other, Children(3), Parents(3, 1)
 
Other = ARRAY("Damien", "Pip", "Wendy")
Dim Other, Children(3), Parents(3, 1)
PRINT "'Other' Upper Bound:", UBOUND(Other)
Other = Array("Damien", "Pip", "Wendy")
PRINT "'Children' Upper Bound:", _
Print "'Other' Upper Bound:", Ubound(Other)
       UBOUND(CHILDREN, 1)
Print "'Children' Upper Bound:", _
PRINT "'Parents' Upper Bounds:", _
       UBound(Children, 1)
       UBOUND(Parents), UBOUND(Parents, 2)
Print "'Parents' Upper Bounds:", _
       UBound(Parents), UBound(Parents, 2)
</pre>
</pre>


'''Output'''
== Output ==


<pre>
<pre>
Line 27: Line 30:
</pre>
</pre>


'''Related Items'''
== Related Items ==
 
[[array|Array]], [[dim|Dim]], [[lbound|LBound]], [[redim|ReDim]]
 
[[Category:Language Reference]]
 
[[Category:Variable Handling]]


[[array|ARRAY]], [[dim|DIM]], [[lbound|LBOUND]], [[redim|REDIM]]
[[Category:BASIC Functions]]

Latest revision as of 15:38, 25 March 2019

This function is for BASIC compatibility. It is not available in pure JavaScript projects.

UBound(array[, dimension])

Description

UBound returns a long value specifying the largest available subscript in the specified dimension of a given array. The required parameter, array, is any array variable. The optional parameter, dimension, specifies which dimension's upper bound is returned, beginning with the default, 1. If the array is empty, -1 is returned. (For Android 2.1, use array.length instead.)

Example (Basic)

Rem UBound Example
'UBound returns upper bound of array dimension

Dim Other, Children(3), Parents(3, 1)
Other = Array("Damien", "Pip", "Wendy")
Print "'Other' Upper Bound:", Ubound(Other)
Print "'Children' Upper Bound:", _
       UBound(Children, 1)
Print "'Parents' Upper Bounds:", _
       UBound(Parents), UBound(Parents, 2)

Output

'Other' Upper Bound:2
'Children' Upper Bound:    3
'Parents' Upper Bounds:    3      1

Related Items

Array, Dim, LBound, ReDim