Função Left (Visual Basic)

Retorna uma sequência de caracteres que contém um número especificado de caracteres do lado esquerdo de uma sequência de caracteres.

Public Shared Function Left( _
   ByVal str As String, _
   ByVal Length As Integer _
) As String

Parâmetros

• str
  Obrigatório.String expressão do qual os caracteres mais à esquerda são retornados.

• Length
  Obrigatório.Integer expressão. Expressão numérica indicando quantos caracteres para retornar.Se for zero, uma sequência de caracteres de comprimento zero (" ") será retornada.Se maior ou igual ao número de caracteres em str, a sequência completa será retornada.

Exceções

Tipo de exceção	Número de erro	Condição
ArgumentException	5	Length < 0.

Ver a coluna " número de erro " se você estiver atualizando aplicativos Visual Basic 6.0 que usam manipulação de erros não estruturada.(Você pode comparar o número do erro com a Propriedade do Número (Erro de objeto).) Entretanto, quando for possivel, você pode considerar substituir tal controle de erro por Visão Geral sobre a Manipulação Estruturada de Exceções para o Visual Basic.

Comentários

Para determinar o número de caracteres em str, use a função Len.Se for usado em um aplicativo Formulários do Windows, ou qualquer outra classe que tenha uma propriedade Left, você deve qualificar totalmente a função com Microsoft.VisualBasic.Left.

Observação:
O LeftB função nas versões anteriores do Visual Basic retorna uma seqüência de caracteres em bytes, em vez de caracteres. Isso é usado primariamente para converter sequências de caracteres em aplicações com conjuntos de caracteres de byte duplo (DBCS).Todas sequências de caracteres do Visual Basic estão em Unicode, e LeftB não é mais suportado.

Exemplo

Este exemplo demonstra o uso da função Left para retornar uma subsequência de caracteres de uma determinada String.Em uma classe que tem uma propriedade Left, talvez você precise qualificar totalmente a função Left.

Dim TestString As String = "Hello World!"
' Returns "Hello".
Dim subString As String = Microsoft.VisualBasic.Left(TestString, 5)

Requisitos

Namespace:Microsoft.VisualBasic

**Módulo:**Strings

Assembly: Visual Basic Runtime Library (em Microsoft.VisualBasic.dll)

Consulte também

Conceitos

Sumário para programação de mudanças em elementos de suporte

Referência

Sumário de Manipulação de Strings

Função Right (Visual Basic)

Função Len (Visual Basic)

Função Mid (Visual Basic)

ArgumentException