Replicate
Repete um caractere ou string N vezes. Usado pra montar separadores, padding ou strings de mascara.
Assinatura: Replicate(cChar, nVezes) -> cString
Retorna: Character
Replicate repete o conteudo de uma string N vezes. Equivalente ao "-" * 80 de Python.
Sintaxe
cLinha := Replicate("-", 80) // 80 tracos
cZeros := Replicate("0", 6) // "000000"
cMasc := Replicate("9", TamSx3("A1_COD")[1]) // mascara dinamica
Casos classicos
- Separador em relatorio:
Replicate("=", 132) - Mascara dinamica de campo:
Replicate("9", nTam) - Inicializar string vazia com espacos:
Replicate(" ", 100) - Indentacao:
Replicate(" ", nNivel * 2)
Pegadinhas
- nVezes <= 0 retorna string vazia.
- cChar com mais de 1 char repete a string inteira —
Replicate("ab", 3) = "ababab". - Use PadR/PadL pra padding em vez de Replicate quando o objetivo for "completar ate tamanho".
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
cChar | Character | sim | Caractere ou string a repetir. |
nVezes | Numeric | sim | Quantas vezes repetir. |