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 |
---|---|---|
Array es Nothing. |
||
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)