Strings.Left(String, Int32) Método

Definição

Espaço de Nomes:
Microsoft.VisualBasic
Assemblagem:
Microsoft.VisualBasic.dll

Devolve uma cadeia contendo um número especificado de caracteres do lado esquerdo de uma cadeia.

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

Required. String expressão da qual os caracteres mais à esquerda são retornados.

Length
Int32

Required. Integer expressão. Expressão numérica que indica o número de carateres a devolver. Se for 0, será devolvida uma cadeia de comprimento zero (""). Se for maior ou igual ao número de caracteres em str, toda a cadeia é devolvida.

Devoluções

String

Uma cadeia contendo um número especificado de caracteres do lado esquerdo de uma cadeia.

Exceções

ArgumentException

Length < 0.

Exemplos

Este exemplo demonstra o uso da Left função para devolver uma subcadeia de um dado String. Numa classe que possui 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)

Observações

Para determinar o número de caracteres em str, use a Len função. Se usada numa aplicação Windows Forms, ou em qualquer outra classe que tenha uma propriedade Left, deve qualificar totalmente a função com Microsoft.VisualBasic.Left.

Note

A função LeftB nas versões anteriores do Visual Basic devolve uma cadeia em bytes em vez de caracteres. Ele é usado principalmente para converter cadeias de caracteres em aplicativos DBCS (conjunto de caracteres de byte duplo). Todas as cadeias de Visual Basic atuais estão em Unicode, e LeftB já não é suportado.

Aplica-se a

Ver também