Strings.Left(String, Int32) Método

Definição

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Origem:

Strings.vb

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

public:
 static System::String ^ Left(System::String ^ str, int Length);

public static string Left (string? str, int Length);

static member Left : string * int -> string

Public Function Left (str As String, Length As Integer) As String

Parâmetros

str

String

Obrigatórios. Expressão String da qual os caracteres mais à esquerda são retornados.

Length

Int32

Obrigatórios. Expressão Integer. Expressão numérica que indica quantos caracteres serão retornados. Se for 0, uma cadeia de caracteres de tamanho zero ("") será retornada. Se for maior ou igual ao número de caracteres em str, a cadeia de caracteres inteira será retornada.

Retornos

String

Uma cadeia de caracteres que contém um número especificado de caracteres do lado esquerdo de uma cadeia de caracteres.

Exceções

ArgumentException

Length< 0.

Exemplos

Este exemplo demonstra o uso da Left função para retornar uma subcadeia de caracteres de um determinado String. Em uma classe que tem uma Left propriedade , pode ser necessário qualificar totalmente a Left função.

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

Comentários

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

Observação

A LeftB função em versões anteriores do Visual Basic retorna uma cadeia de caracteres em bytes em vez de caracteres. Ela é usada principalmente para converter cadeias de caracteres em aplicativos DBCS (conjunto de caracteres de bytes duplos). Todas as cadeias de caracteres atuais do Visual Basic estão em Unicode e LeftB não têm mais suporte.

Confira também

• Right(String, Int32)
• Len
• Mid
• ArgumentException
• Resumo de manipulação da cadeia de caracteres