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

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.

Tipo de excepción

Número de error

Condición

ArgumentException

5

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.

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.

y050k1wb.alert_note(es-es,VS.90).gifNota:

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.

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)


Espacio de nombres:Microsoft.VisualBasic

Módulo:Strings

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

Adiciones de comunidad

Mostrar: