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

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

.NET Framework method	Description
Asc, AscW	Retorna um Integer valor que representa o caractere código correspondente a um caractere.
Chr, ChrW	Returns the character associated with the specified character code.
Filter	Retorna uma matriz baseada em zero que contém um subconjunto de um String array com base em 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	Returns an expression formatted as a currency value using the currency symbol defined in the system control panel.
FormatDateTime	Returns a string expression representing a date/time value.
FormatNumber	Returns an expression formatted as a number.
FormatPercent	Returns an expression formatted as a percentage (that is, multiplied by 100) with a trailing % character.
InStr	Returns an integer specifying the start position of the first occurrence of one string within another.
InStrRev	Returns the position of the first occurrence of one string within another, starting from the right side of the string.
Join	Returns a string created by joining a number of substrings contained in an array.
LCase	Returns a string or character converted to lowercase.
Left	Returns a string containing a specified number of characters from the left side of a string.
Len	Retorna um inteiro que contém o número de caracteres em uma seqüência de caracteres.
LSet	Returns a left-aligned string containing the specified string adjusted to the specified length.
LTrim	Retorna uma seqüência de caracteres contendo uma cópia de uma seqüência de caracteres especificada sem espaços à esquerda.
Mid	Returns a string containing a specified number of characters from a string.
Replace	Returns a string in which a specified substring has been replaced with another substring a specified number of times.
Right	Returns a string containing a specified number of characters from the right side of a string.
RSet	Returns a right-aligned string containing the specified string adjusted to the specified length.
RTrim	Retorna uma seqüência de caracteres contendo uma cópia de uma seqüência de caracteres especificada sem espaços à direita.
Space	Returns a string consisting of the specified number of spaces.
Split	Returns a zero-based, one-dimensional array containing a specified number of substrings.
StrComp	Returns -1, 0, or 1, based on the result of a string comparison.
StrConv	Returns a string converted as specified.
StrDup	Returns a string or object consisting of the specified character repeated the specified number of times.
StrReverse	Returns a string in which the character order of a specified string is reversed.
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	Returns a string or character containing the specified string converted to uppercase.

Você pode usar o Option Compare dedemonstrativo para definir se as seqüências de caracteres são comparadas usando uma diferenciação de texto caso- ordem de classificação determinadas pela localidade do seu sistema (Text) ou as interno binário representações dos caracteres (Binary). O de comparação de texto método padrão é Binary.

Exemplo

Este exemplo usa o 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 a função para tirar espaços à direita de uma variável de seqüência de caracteres. Ele usa o Trim a função de 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)

This example uses the Mid function to return a specified number of characters from a string.

' 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)

This example uses the InStr function to return the position of the first occurrence of one string within another.

' 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 de 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 de AM/PM (t e tt) 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 do Visual Basic

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

Palavras-chave comparadas em vários idiomas

Outros recursos

Palavras-chave (Visual Basic)