LBound (Función, Visual Basic)

Actualización: noviembre 2007

Devuelve el menor subíndice disponible para la dimensión indicada de una matriz.

Public Function LBound( _
   ByVal Array As System.Array, _
   Optional ByVal Rank As Integer = 1 _
) As Integer

Parámetros

  • Array
    Requerido. Matriz de cualquier tipo de datos. La matriz en la que desea buscar el menor subíndice posible de una dimensión.

  • Rank
    Opcional. Integer. Dimensión para la que se va a devolver el menor subíndice posible. Utilice 1 para la primera dimensión, 2 para la segunda y así sucesivamente. Si se omite Rank, se supone 1.

Valor devuelto

Integer. El valor más bajo del subíndice que puede contener la dimensión especificada. LBound siempre devuelve 0, en tanto que Array se haya inicializado y aunque no tenga elementos, por ejemplo si se trata de una cadena de longitud cero. Si Array es Nothing, LBound produce ArgumentNullException.

Excepciones

Tipo de excepción

Número de error

Condición

ArgumentNullException

Array es Nothing.

RankException

Rank < 1 o Rank es mayor que el rango de Array.

Consulte la columna "Número de error" si está actualizando aplicaciones de Visual Basic 6.0 que utilizan el control de errores no estructurado. (Se puede comparar el número de error con respecto a Number (Propiedad, objeto Err)). Sin embargo, siempre que sea posible, se debe considerar la sustitución de dicho control de errores por Información general sobre el control estructurado de excepciones de Visual Basic.

Comentarios

Puesto que los subíndices de matriz empiezan en 0, el menor índice disponible para cada dimensión es siempre 0.

Para una matriz con las siguientes dimensiones, LBound devuelve los valores de la siguiente tabla:

Dim a(100, 5, 4) As Byte

Llamada a LBound

Valor devuelto

LBound(a, 1)

LBound(a, 2)

LBound(a, 3)

Ejemplo

En el ejemplo siguiente se utiliza la función LBound para determinar el menor subíndice disponible para la dimensión indicada de una matriz.

Dim lowest, bigArray(10, 15, 20), littleArray(6) As Integer
lowest = LBound(bigArray, 1)
lowest = LBound(bigArray, 3)
lowest = LBound(littleArray)
' All three calls to LBound return 0.

Requisitos

Espacio de nombres:Microsoft.VisualBasic

**Módulo:**Information

**Ensamblado:**Visual Basic Runtime Library (en Microsoft.VisualBasic.dll)

Vea también

Referencia

UBound (Función, Visual Basic)

Instrucción Dim (Visual Basic)

Instrucción ReDim (Visual Basic)

ArgumentException

RankException