Funções da cadeia de caracteres (Visual Basic)

A tabela a seguir lista as funções que o Visual Basic oferece para pesquisar e manipular cadeias de caracteres.

Método .NET Framework	Descrição
Asc, AscW	Retorna um valor Integer que representa o código de caractere correspondente a um caractere.
Chr, ChrW	Retorna o caractere associado ao código de caractere especificado.
Filter	Retorna uma matriz baseada em zero que contém um subconjunto de uma matriz String com base em critérios de filtragem especificados.
Format	Retorna uma cadeia de caracteres formatada de acordo com as instruções contidas em uma expressão de formato String.
FormatCurrency	Retorna uma expressão formatada como um valor de moeda usando o símbolo de moeda definido no painel de controle do sistema.
FormatDateTime	Retorna uma expressão de cadeia de caracteres que representa um valor de data/hora.
FormatNumber	Retorna uma expressão formatada como um número.
FormatPercent	Retorna uma expressão formatada como uma porcentagem (isto é, multiplicado por 100) com um % à direita de caracteres.
InStr	Retorna um inteiro especificando a posição de início da primeira ocorrência de uma cadeia de caracteres dentro da outra.
InStrRev	Retorna a posição da primeira ocorrência de uma cadeia de caracteres em outra, começando do lado direito da cadeia de caracteres.
Join	Retorna uma cadeia de caracteres criada juntando um certo número de subcadeias de caracteres contidas em uma matriz.
LCase	Retorna uma cadeia de caracteres ou um caractere convertido em minúsculas.
Left	Retorna uma cadeia de caracteres contendo um número especificado de caracteres do lado esquerdo de uma cadeia de caracteres.
Len	Retorna um inteiro que contém o número de caracteres em uma cadeia de caracteres.
LSet	Retorna uma cadeia de caracteres alinhada à esquerda que contêm a cadeia de caracteres especificada ajustada ao comprimento especificado.
LTrim	Retorna uma cadeia de caracteres que contém uma cópia de uma cadeia de caracteres especificada sem espaços iniciais.
Mid	Retorna uma cadeia de caracteres contendo um número especificado de caracteres de uma cadeia de caracteres.
Replace	Retorna uma cadeia de caracteres na qual uma subcadeia de caracteres especificada foi substituída por outra subcadeia de caracteres um determinado número de vezes.
Right	Retorna uma cadeia de caracteres contendo um número especificado de caracteres do lado direito de uma cadeia de caracteres.
RSet	Retorna uma cadeia de caracteres alinhada à direita que contêm a cadeia de caracteres especificada ajustada ao comprimento especificado.
RTrim	Retorna uma cadeia de caracteres que contém uma cópia de uma cadeia de caracteres especificada sem espaços finais.
Space	Retorna uma cadeia de caracteres consistindo em um número de espaços especificado.
Split	Retorna uma matriz unidimensional baseada em zero contendo um número especificado de subcadeias.
StrComp	Retorna -1, 0, ou 1, com base no resultado de uma comparação de cadeia de caracteres.
StrConv	Retorna uma cadeia de caracteres convertida como especificado.
StrDup	Retorna uma cadeia de caracteres ou o objeto que consiste no caractere especificado repetido o número de vezes especificado.
StrReverse	Retorna uma cadeia de caracteres em que a ordem de caracteres de uma cadeia de caracteres especificada é invertida.
Trim	Retorna uma cadeia de caracteres que contém uma cópia de uma cadeia de caracteres especificada sem espaços inicial ou final.
UCase	Retorna uma cadeia de caracteres ou um caractere com a cadeia de caracteres especificada convertida para maiúsculas.

É possível usar a declaração Option Compare para definir se as cadeias de caracteres são comparadas usando um ordem de classificação sem diferenciação de maiúsculas e minúsculas de texto determinada pela localização do sistema (Text) ou pelas representações binárias internas dos caracteres (Binary). O método de comparação de texto padrão é Binary.

Exemplo

Este exemplo usa a função UCase para retornar uma versão de uma cadeia de caracteres em letras minúsculas.

' String to convert. 
Dim LowerCase As String = "Hello World 1234" 
' Returns "HELLO WORLD 1234". 
Dim UpperCase As String = UCase(LowerCase)

Este exemplo usa a função LTrim para retirar espaços à esquerda e a função RTrim para retirar espaços à direita de um variável de cadeia de caracteres. Usa a função de Trim para retirar ambos os tipos de espaços.

' Initializes string. 
Dim TestString As String = "  <-Trim->  " 
Dim TrimString As String 
' Returns "<-Trim->  ".
TrimString = LTrim(TestString)
' Returns "  <-Trim->".
TrimString = RTrim(TestString)
' Returns "<-Trim->".
TrimString = LTrim(RTrim(TestString))
' Using the Trim function alone achieves the same result. 
' Returns "<-Trim->".
TrimString = Trim(TestString)

Este exemplo usa a função Mid para retornar um número especificado de caracteres de uma cadeia de caracteres.

' Creates text string. 
Dim TestString As String = "Mid Function Demo" 
' Returns "Mid". 
Dim FirstWord As String = Mid(TestString, 1, 3)
' Returns "Demo". 
Dim LastWord As String = Mid(TestString, 14, 4)
' Returns "Function Demo". 
Dim MidWords As String = Mid(TestString, 5)

Este exemplo usa Len para retornar o número especificado de caracteres em uma cadeia de caracteres.

' Initializes variable. 
Dim TestString As String = "Hello World" 
' Returns 11. 
Dim TestLen As Integer = Len(TestString)

Este exemplo usa a função InStr para retornar a posição da primeira ocorrência de uma cadeia de caracteres dentro da outra.

' String to search in. 
Dim SearchString As String = "XXpXXpXXPXXP" 
' Search for "P". 
Dim SearchChar As String = "P" 

Dim TestPos As Integer 
' A textual comparison starting at position 4. Returns 6.
TestPos = InStr(4, SearchString, SearchChar, CompareMethod.Text)

' A binary comparison starting at position 1. Returns 9.
TestPos = InStr(1, SearchString, SearchChar, CompareMethod.Binary)

' If Option Compare is not set, or set to Binary, return 9. 
' If Option Compare is set to Text, returns 3.
TestPos = InStr(SearchString, SearchChar)

' Returns 0.
TestPos = InStr(1, SearchString, "W")

Este exemplo mostra vários usos da função Format para formatar valores usando os formatos String e os formatos definidos pelo usuário. Para o separador de data (/), separador de hora (:) e indicadores AM/PM (t e tt), a saída formatada real exibida pelo seu sistema depende das configurações de localidade que o código está usando. Quando horas e datas são exibidas no ambiente de desenvolvimento, o formato abreviado de tempo e o formato abreviado de data do local do código são usados.

Dica

Para localidades que usam um relógio de 24 horas, os indicadores AM/PM (t e tt) não exibem nada.

Dim TestDateTime As Date = #1/27/2001 5:04:23 PM#
Dim TestStr As String 
' Returns current system time in the system-defined long time format.
TestStr = Format(Now(), "Long Time")
' Returns current system date in the system-defined long date format.
TestStr = Format(Now(), "Long Date")
' Also returns current system date in the system-defined long date  
' format, using the single letter code for the format.
TestStr = Format(Now(), "D")

' Returns the value of TestDateTime in user-defined date/time formats. 
' Returns "5:4:23".
TestStr = Format(TestDateTime, "h:m:s")
' Returns "05:04:23 PM".
TestStr = Format(TestDateTime, "hh:mm:ss tt")
' Returns "Saturday, Jan 27 2001".
TestStr = Format(TestDateTime, "dddd, MMM d yyyy")
' Returns "17:04:23".
TestStr = Format(TestDateTime, "HH:mm:ss")
' Returns "23".
TestStr = Format(23)

' User-defined numeric formats. 
' Returns "5,459.40".
TestStr = Format(5459.4, "##,##0.00")
' Returns "334.90".
TestStr = Format(334.9, "###0.00")
' Returns "500.00%".
TestStr = Format(5, "0.00%")

Consulte também

Referência

Membros da biblioteca em tempo de execução do Visual Basic

Resumo de manipulação da cadeia de caracteres (Visual Basic)

Outros recursos

Palavras-chave (Visual Basic)