Histórico da Página
Sintaxe
Incluir Página |
---|
REPLICATE( <expressão caracter>, <expressão numérica> )
Propósito
Retorna uma cadeia de caracteres repetida pela quantidade de vezes especificada.
Argumentos
<expressão caracter>
Define o caracter ou a cadeia de caracteres que será replicada por um determinado número de vezes.
<expressão numérica>
É um número inteiro positivo que define o número de vezes que a cadeia de caracteres especificada será repetida ou replicada. Se o resultado da expressão numérica for zero, a função REPLICATE() retornará uma cadeia de caracteres nula (“”).
Utilização
A função REPLICATE() é utilizada para construir longas cadeias de caracteres compostas por um ou mais caracteres repetidos.
É muito útil, por exemplo, para a formação de linhas e traços que serão impressos em relatórios.
A cadeia de caracteres resultante após a repetição não pode exceder 65.535 caracteres (64 Kbytes). Portanto, a expressão numérica deve ser um número menor que 65.535, dividido pelo comprimento (número de caracteres) da cadeia de caracteres especificada.
Dicas
A função REPLICATE() é semelhante à função SPACE(), que fornece uma cadeia de caracteres com um determinado número de espaços em branco. A vantagem da função REPLICATE() é que ela permite a repetição de outros caracteres, não se restringindo somente ao espaço em branco.
Exemplos
MsgAlert( REPLICATE(“-“, 5) ) // Resulta “-----“
MsgAlert( REPLICATE(“*”, 10) ) // Resulta “**********”
MsgAlert( REPLICATE(“torta”, 2) ) // Resulta “tortatorta”
No exemplo abaixo, a variável nLinha conterá uma cadeia de 132 traços, que poderá ser utilizada como uma linha de separação ou demarcação em relatórios.
REPLICATE( “-“, 132 )
|