Compartilhar via


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)

Confira também