LBound Function

Syntax

LBound(arrayname[, dimension])

arrayname

Use: Required

Data Type: Any

The name of the array.

dimension

Use: Optional

Data Type: Variant (Long)

A number specifying the dimension of the array.

Return Value

A Long integer.

Description

Determines the lower limit of a specified dimension of an array. The lower boundary is the smallest subscript you can access within the specified array.

Rules at a Glance

  • If dimension isn't specified, 1 is assumed. To determine the lower limit of the first dimension of an array, set dimension to 1, 2 for the second, and so on.

  • The lower bound of an array dimension can be set using To, Dim, Private, Public, Redim, and Static, and can be set to any integer value.

Programming Tips and Gotchas

  • The Option Base statement sets the default lower bound of an array to either 1 or 0.

  • An array created with the Array function always has a lower bound of zero.

  • The LBound function can't determine the lower limit of a control array. Instead, in both Visual Basic and Visual Basic for Applications, you can use the control array's LBound property to determine its lower limit.

See Also

Array Function, Option Base Statement, UBound Function

Get VB & VBA in a Nutshell: The Language 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.