Applies ToAccess for Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

Returns a Long containing the largest available subscript for the indicated dimension of an array.

Syntax

UBound ( arrayname [, dimension ] )

The UBound function syntax has these arguments:

Argument

Description

arrayname

Required. Name of the array variable; follows standard variable naming conventions.

dimension

Optional. Variant (Long). Whole number indicating which dimension's upper bound is returned. Use 1 for the first dimension, 2 for the second, and so on. If dimension is omitted, 1 is assumed.

Remarks

The UBound function is used with the LBound function to determine the size of an array. Use the LBound function to find the lower limit of an array dimension.

UBound returns the following values for an array with these dimensions:

Dim A(1 To 100, 0 To 3, -3 To 4)

Statement

Return Value

UBound(A, 1)

100

UBound(A, 2)

3

UBound(A, 3)

4

Example

Note: Examples that follow demonstrate the use of this function in a Visual Basic for Applications (VBA) module. For more information about working with VBA, select Developer Reference in the drop-down list next to Search and enter one or more terms in the search box.

This example uses the UBound function to determine the largest available subscript for the indicated dimension of an array.

Dim Upper' Declare array variables.Dim MyArray(1 To 10, 5 To 15, 10 To 20)Dim AnyArray(10)Upper = UBound(MyArray, 1)    ' Returns 10.Upper = UBound(MyArray, 3)    ' Returns 20.Upper = UBound(AnyArray)    ' Returns 10.

Need more help?

Want more options?

Explore subscription benefits, browse training courses, learn how to secure your device, and more.

Communities help you ask and answer questions, give feedback, and hear from experts with rich knowledge.