Replace (ReplaceW)
Overview
Bem-vindo a uma jornada pelo universo do PowerBuilder, onde aprenderemos a arte de manipular strings com elegância e eficiência. Neste post, mergulharemos nos detalhes da função Replace, uma ferramenta essencial que nos permite substituir partes de uma string por outra. Seja você um iniciante ansioso por absorver novos conhecimentos ou um veterano buscando aprimorar suas habilidades, este guia tem tudo o que você precisa saber para dominar essa funcionalidade. Preparado? Vamos nessa!
Substitui um pedaço do texto de uma string por outro.
Atenção! A função ReplaceW funciona exatamente igual a esta, mas está obsoleta e não deve ser utilizada.
Sintaxe:
Replace(string1, start, n , string2)
Retorno:
- String com texto substituído se funcionar;
- String vazia se não for possível substituir;
- Null se qualquer um dos argumentos for nulo.
Destalhes sobre a função!
Appeon: Função suportada sem restrições.
- Se o argumento start for maior que o tamanho da string, a função irá adicionar a string2 na string1;
- Se existirem menos caracteres informados no argumento start do que no n, a função substitui todos os caracteres a direita do valor start;
- Se n for zero, então a função irá inserir a string2 na string1.
Como utilizar:
Exemplo 01: Substitui o texto “Vacation” pelo the “the Winter”
string ls_texto, ls_substituirPor
ls_texto = "Closed for Vacation"
ls_substituirPor = "the winter"
Replace(ls_texto, 12, 8, ls_substituirPor)
Argumentos:
| Argumento | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| string1 | Sim | string | String contendo o texto original. Onde está o que você deseja substituir |
| start | Sim | long | Valor numérico indicando a posição do primeiro caractere que será substituído. |
| n | Sim | long | Long indicando quantos caracteres serão substituídos |
| string2 | Sim | string | String contendo o texto que será substituído na string1. |
Referência:
Dúvidas sobre o artigo? Sugestões? Precisa de ajuda com outra funcionalidade do PowerBuilder? Deixe um comentário.