Substitua uma parte de uma cadeia de texto por outra cadeia de caracteres.

Descrição

A função Replace identifica o texto a ser substituído pela posição inicial e o tamanho.

A função Substitute identifica o texto a ser substituído por uma cadeia de caracteres correspondente. Se mais de uma correspondência for encontrada, você poderá controlar qual delas será substituída.

Se você passar uma única cadeia de caracteres, o valor de retorno será a cadeia de caracteres modificada. Se você passar uma tabela de coluna única que contenha cadeias de caracteres, o valor de retorno será uma tabela de coluna única com cadeias de caracteres modificadas. Se você tiver uma tabela de várias colunas, é possível formatá-la como uma tabela de coluna única, como descrito em Trabalhando com tabelas.

Sintaxe

Replace( Cadeia de caracteres, PosiçãoInicial, NúmeroDeCaracteres, NovaCadeiaDeCaracteres )

  • String - obrigatório. A cadeia de caracteres com a qual operar.
  • PosiçãoInicial - Obrigatório. Posição do caractere na qual iniciar a substituição. O primeiro caractere da Cadeia de caracteres está na posição 1.
  • NumberOfCharacters - obrigatório. O número de caracteres para substituição na Cadeia de caracteres.
  • NovaCadeiaDeCaracteres - obrigatório. A Cadeia de caracteres de substituição. O número de caracteres neste argumento pode diferir do argumento NúmeroDeCaracteres.

Substitute( Cadeia de caracteres, CadeiaDeCaracteresAntiga, NovaCadeiaDeCaracteres [, NúmeroDaInstância ] )

  • String - obrigatório. A cadeia de caracteres com a qual operar.
  • CadeiaDeCaracteresAntiga - obrigatório. A cadeia de caracteres a ser substituída.
  • NovaCadeiaDeCaracteres - obrigatório. A Cadeia de caracteres de substituição. CadeiaDeCaracteresAntiga e NovaCadeiaDeCaracteres podem ter tamanhos diferentes.
  • NúmeroDaInstância - opcional. Por padrão, a primeira instância da CadeiaDeCaracteresAntiga é substituída. Se Cadeia de caracteres contiver mais de uma instância, você poderá especificar qual instância substituir.

Replace( TabelaDeColunaÚnica, PosiçãoInicial, NúmeroDeCaracteres, NovaCadeiaDeCaracteres )

  • SingleColumnTable – Obrigatório. Uma tabela de coluna única de cadeias de caractere para operação.
  • PosiçãoInicial - Obrigatório. Posição do caractere na qual iniciar a substituição. O primeiro caractere de cada cadeia de caracteres na tabela está na posição 1.
  • NumberOfCharacters - obrigatório. O número de caracteres para substituição em cada cadeia de caracteres.
  • NovaCadeiaDeCaracteres - obrigatório. A Cadeia de caracteres de substituição. O número de caracteres neste argumento pode diferir do argumento NúmeroDeCaracteres.

Substitute( TabelaDeColunaÚnica, CadeiaDeCaracteresAntiga, NovaCadeiaDeCaracteres [, NúmeroDaInstância ] )

  • SingleColumnTable – Obrigatório. Uma tabela de coluna única de cadeias de caractere para operação.
  • CadeiaDeCaracteresAntiga - obrigatório. A cadeia de caracteres a ser substituída.
  • NovaCadeiaDeCaracteres - obrigatório. A Cadeia de caracteres de substituição. CadeiaDeCaracteresAntiga e NovaCadeiaDeCaracteres podem ter tamanhos diferentes.
  • NúmeroDaInstância - opcional. Por padrão, a primeira instância da CadeiaDeCaracteresAntiga é substituída. Se a tabela contiver mais de uma instância, você poderá especificar qual instância substituir.