Instrução Mid
Substitui um número especificado de caracteres em uma variável String
com caracteres de outra cadeia de caracteres.
Sintaxe
Mid( _
ByRef Target As String, _
ByVal Start As Integer, _
Optional ByVal Length As Integer _
) = StringExpression
Partes
Target
Obrigatórios. Nome da variável String
a ser modificada.
Start
Obrigatórios. Expressão Integer
. Posição do caractere em Target
onde começa a substituição do texto. Start
usa um único índice.
Length
Opcional. Expressão Integer
. Número de caracteres a ser substituído. Se omitido, tudo de String
será usado.
StringExpression
Obrigatórios. expressão String
que substitui parte de Target
.
Exceções
Tipo de exceção | Condição |
---|---|
ArgumentException | Start <= 0 ou Length < 0. |
Comentários
O número de caracteres substituídos é sempre menor ou igual ao número de caracteres em Target
.
O Visual Basic tem uma função Mid e uma instrução Mid
. Esses elementos operam em um número especificado de caracteres em uma cadeia de caracteres, mas a função Mid
retorna os caracteres enquanto a instrução Mid
substitui os caracteres. Para obter mais informações, consulte Mid.
Observação
A instrução MidB
de versões anteriores do Visual Basic substitui uma substring 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 do Visual Basic estão no Unicode e MidB
não tem mais suporte.
Exemplo
Este exemplo usa a instrução Mid
para substituir um número especificado de caracteres em uma variável de cadeia de caracteres por caracteres de outra cadeia de caracteres.
Dim testString As String
' Initializes string.
testString = "The dog jumps"
' Returns "The fox jumps".
Mid(testString, 5, 3) = "fox"
' Returns "The cow jumps".
Mid(testString, 5) = "cow"
' Returns "The cow jumpe".
Mid(testString, 5) = "cow jumped over"
' Returns "The duc jumpe".
Mid(testString, 5, 3) = "duck"
Requisitos
Namespace: Microsoft.VisualBasic
Módulo: Strings
Assembly: Biblioteca de Tempo de Execução do Visual Basic (em Microsoft.VisualBasic.dll)