Função Left

Devolver um número especificado de caracteres a partir do lado esquerdo de uma sequência.

Sintaxe

Left(string, length)

Argumentos:

• String: Expressão de string da qual os caracteres mais à esquerda são retornados.
• Length: Expressão numérica que indica quantos caracteres devem ser retornados. Se for 0, uma string de tamanho zero (" ") será retornada. Se for maior ou igual ao número de caracteres da string, a string inteira será retornada.

Comentários

Para determinar o número de caracteres na string, use a função Len.

O exemplo a seguir usa a função Left para retornar os três primeiros caracteres de MyString:

Exemplo 1:

Dim MyString, LeftString
MyString = "BSL"
LeftString = Left(MyString, 3) 
' Output: "BSL".

Exemplo 2:

Dim MyString, LeftString
MyString = "HelloWorld"
LeftString = Left(MyString, 5) 
' Output: "Hello"

Exemplo 3:

Dim MyString, LeftString
MyString = "HelloWorld"
LeftString = Left(MyString, 0)  
' Output:  ("")

Exemplo 4:

Dim MyString, LeftString
MyString = "Hello"
LeftString = Left(MyString, 10)  
' Output: "Hello"

Exemplo 5:

Dim MyString, LeftString
MyString = Null
LeftString = Left(MyString, 3)  
'Output: Null