Usina BRAdvPL Guia
Entrar
← Todos os tópicos
FUNçãOEm revisão

Stuff

Stuff( <cString>, <nPosInicial>, <nExcluir>, <cAdicao> )

Substitui parte de uma string a partir de uma posição.

StringsSubstituiçãoTexto
01 · VISÃO GERAL

Visão geral

Stuff() permite remover uma quantidade de caracteres de uma string e inserir outro conteúdo no mesmo ponto. É útil para máscaras, substituições pontuais e montagem controlada de textos.

02 · SINTAXE

Sintaxe

Stuff( <cString>, <nPosInicial>, <nExcluir>, <cAdicao> )

Parâmetros

cString
CaractereObrigatório

Texto original.

nPosInicial
NuméricoObrigatório

Posição inicial da substituição.

nExcluir
NuméricoObrigatório

Quantidade de caracteres removidos a partir da posição inicial.

cAdicao
CaractereObrigatório

Texto inserido no lugar do trecho removido.

03 · EXEMPLO PRÁTICO

Substituindo trecho

User Function ExStuff()
    Local cCodigo := "ABC000XYZ"

    cCodigo := Stuff(cCodigo, 4, 3, "123")
    MsgInfo(cCodigo)
Return
Resultado esperado

O trecho 000 é substituído por 123.

BOAS PRÁTICAS
  • Pode inserir texto sem remover nada quando nExcluir for zero.
  • Use SubStr() quando apenas precisar ler parte do texto.
ARMADILHAS COMUNS
  • Valide a posição inicial antes de aplicar a substituição.
  • Em campos com tamanho fixo, confirme se o resultado final cabe no destino.

Conteúdos relacionados

REFERÊNCIAS
  1. Programação em ADVPL Completo. Documentação oficial histórica de treinamento, seção 4.5.4, p. 45-50. Conteúdo resumido, revisado e exemplos adaptados.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha