Left (Función, Visual Basic)
Actualización: noviembre 2007
Devuelve una cadena que contiene un número especificado de caracteres a partir del lado izquierdo de una cadena.
Public Shared Function Left( _
ByVal str As String, _
ByVal Length As Integer _
) As String
Parámetros
str
Requerido. Expresión String de la que se devuelven los caracteres que están más a la izquierda.Length
Requerido. Expresión Integer. Expresión numérica que indica cuántos caracteres se van a devolver. Si es cero, se devuelve una cadena de longitud cero (""). Si es mayor o igual que el número de caracteres en str, se devuelve la cadena completa.
Excepciones
Tipo de excepción |
Número de error |
Condición |
|---|---|---|
Length < 0. |
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
Para determinar el número de caracteres de str, utilice la función Len. Si se utiliza en una aplicación de Windows Forms o en cualquier otra clase que tiene una propiedad Left, debe calificar totalmente la función con Microsoft.VisualBasic.Left.
.gif "Nota") Nota: |
|---|
La función LeftB de versiones anteriores de Visual Basic devuelve una cadena en bytes, en lugar de caracteres. Se usa principalmente para convertir cadenas en aplicaciones de juegos de caracteres de doble byte (DBCS). Todas las cadenas actuales de Visual Basic están en Unicode y ya no se admite LeftB. |
Ejemplo
En este ejemplo se muestra el uso de la función Left para devolver una subcadena de una String dada. En una clase que tenga una propiedad Left, podría ser necesario calificar la función Left plenamente.
Dim TestString As String = "Hello World!"
' Returns "Hello".
Dim subString As String = Microsoft.VisualBasic.Left(TestString, 5)
Requisitos
Espacio de nombres:Microsoft.VisualBasic
**Módulo:**Strings
**Ensamblado:**Visual Basic Runtime Library (en Microsoft.VisualBasic.dll)
Vea también
Conceptos
Resumen de cambios de los elementos de programación ofrecidos