Histórico da Página

Sintaxe

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 )