Name
UBound Function
Class
Microsoft.VisualBasic.Information
Syntax
UBound(array
[,rank
])
-
array
(required; any) The name of the array
-
rank
(optional; Integer) A number specifying the dimension of the array
Return Value
Integer
Description
Indicates the upper limit of a specified coordinate of an array. The upper boundary is the largest subscript you can use with that coordinate.
Rules at a Glance
To determine the upper limit of the first coordinate of an array, set
rank
to 1, set it to 2 for the second coordinate, and so on.If
rank
is not specified, 1 is assumed.The function returns -1 if the array is uninitialized.
Programming Tips and Gotchas
Note that UBound returns the actual subscript of the upper bound of a particular array dimension.
The number of valid indices for the
i
th coordinate is equal toUBound(array,
i)
+
1
.If
array
is an uninitialized array, passing it to the UBound function generates an ArgumentNullException exception. To prevent this, you can declare the array as follows:Dim arrValues(-1) As String
Get VB.NET Language in a Nutshell, Second Edition now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.