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

A tabela a seguir lista as funções que Visual Basic fornece para pesquisar e manipular seqüências de caracteres.

método do Framework .NET.	Descrição
Asc, AscW	Retorna um Integer valor que representa o código do caractere correspondente a um caractere.
Chr, ChrW	Retorna o caractere associado a código de caractere especificado.
Filter	Retorna uma matriz baseada em zero que contém um subconjunto de um String array com base nos critérios de filtro especificado.
Format	Retorna uma seqüência de caracteres formatada de acordo com as instruções contidas em um formato String expressão.
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 em uma cadeia de caracteres uma expressão representando o valor de data/hora.
FormatNumber	Retorna uma expressão formatada como um número.
FormatPercent	Retorna uma expressão formatada como porcentagem (isto é, multiplicada por 100) com um caractere % à direita.
InStr	Retornará um inteiro especificando a posição inicial da primeira ocorrência de uma cadeia de caracteres dentro de outra.
InStrRev	Retorna a posição da primeira ocorrência de uma cadeia de caracteres dentro de outra, a partir do lado direito da cadeia.
Join	Retorna uma cadeia de caracteres criada com a junção de uma série de subcadeias de caracteres contidas em uma matriz.
LCase	Retorna uma sequência de caracteres ou caractere convertidos em minúsculas.
Left	Retorna uma cadeia de caracteres contendo um número específico de caracteres a partir do lado esquerdo da cadeia.
Len	Retorna um inteiro que contém o número de caracteres em uma seqüência de caracteres.
LSet	Retorna uma cadeia de caracteres alinhada à esquerda contendo a cadeia especificada ajustada ao comprimento estabelecido.
LTrim	Retorna uma seqüência de caracteres contendo uma cópia de uma seqüência de caracteres especificada sem espaços à esquerda.
Mid	Retorna uma cadeia de caracteres contendo um número específico de caracteres de uma cadeia.
Replace	Retorna uma cadeia de caracteres na qual uma subcadeia especificada foi substituída por outra subcadeia um determinado número de vezes.
Right	Retorna uma cadeia de caracteres contendo um número específico de caracteres a partir do lado direito da cadeia.
RSet	Retorna uma cadeia de caracteres alinhada à direita contendo a cadeia especificada ajustada ao comprimento estabelecido.
RTrim	Retorna uma seqüência de caracteres contendo uma cópia de uma seqüência de caracteres especificada sem espaços à direita.
Space	Retorna uma sequência de caracteres consistindo de um número de espaços especificado.
Split	Retorna uma matriz unidimensional de base zero contendo um número específico de subcadeias.
StrComp	Retorna -1, 0 ou 1, com base no resultado de uma comparação de cadeias de caracteres.
StrConv	Retorna uma sequência de caracteres convertida como especificado.
StrDup	Retorna uma cadeia de caracteres ou um objeto que consiste no caractere especificado repetido o número de vezes determinado.
StrReverse	Retorna uma cadeia de caracteres na qual a ordem dos caracteres de uma cadeia especificada é invertida.
Trim	Retorna uma seqüência de caracteres contendo uma cópia de uma seqüência de caracteres especificada sem espaços à direita ou à esquerda.
UCase	Retorna uma cadeia ou um caractere contendo a cadeia especificada convertida em maiúsculas.

Você pode usar o Option Compare determinado pela localidade do sistema de ordem de classificação de instrução para definir se as seqüências de caracteres são comparadas usando um texto em maiúsculas e minúsculas (Text) ou por representações binárias internas dos caracteres (Binary).O método de comparação de texto padrão é Binary.

Exemplo

Este exemplo usa a UCase função para retornar uma versão em maiúsculas de uma seqüência de caracteres.

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

Este exemplo usa a LTrim a função para tirar espaços à esquerda e o RTrim espaços de função para ajustar à direita de uma variável string.Ele usa o Trim função para tirar os dois 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 sequência 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 de caracteres em uma seqüência 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 string 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 Format função para formatar valores usando os dois String formatos e formatos definidos pelo usuário.Para o separador de data (/), separador de hora (:) e os indicadores AM/PM (t e tt), a saída formatada real exibida pelo seu sistema depende do código está usando as configurações de localidade.Quando horários e datas são exibidas no ambiente de desenvolvimento, o formato de tempo curto e o formato de data abreviada da localidade do código são usados.

Observação
Para localidades que usam um relógio de 24 horas, os indicadores AM/PM (t e tt) não exibir 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 de tempo de execução de Visual Basic

Resumo de manipulação de seqüência de caracteres (Visual Basic)

Palavras-chave comparadas em vários idiomas

Outros recursos

Palavras-chave (Visual Basic)