REPLICATE()

Sintaxis

REPLICATE( <expresión carácter>, <expresión numérica> )

Propósito

Devuelve una cadena de caracteres repetida por la cantidad de veces especificada.

Argumentos

<expresión carácter>

Define el carácter o la cadena de caracteres que se repetirá por un determinado número de veces.

<expresión numérica>

Es un número entero positivo que define el número de veces que se repetirá o copiará la cadena de caracteres especificada. Si el resultado de la expresión numérica es cero, la función REPLICATE() devolverá una cadena de caracteres nula (“”).

Utilización

La función REPLICATE() se utiliza para construir largas cadenas de caracteres compuestas por uno o más caracteres repetidos.

Es muy útil, por ejemplo, para la formación de líneas y trazos que se imprimirán en informes.

La cadena de caracteres resultante después de la repetición no puede exceder 65.535 caracteres (64 Kbytes). Por lo tanto, la expresión numérica debe ser un número inferior a 65.535, dividido por la longitud (número de caracteres) de la cadena de caracteres especificada.

Sugerencias

La función REPLICATE() es semejante a la función SPACE(), que suministra una cadena de caracteres con un determinado número de espacios en blanco. La ventaja de la función REPLICATE() es que permite la repetición de otros caracteres, sin restringirse solamente al espacio en blanco.

Ejemplos

MsgAlert( REPLICATE(“-“, 5) )          // Resulta “-----“

MsgAlert( REPLICATE(“*”, 10) )       // Resulta “**********”

MsgAlert( REPLICATE(“torta”, 2) )   // Resulta “tortatorta”

En el siguiente ejemplo, la variable nLinha contendrá una cadena de 132 guiones, que podrá utilizarse como una línea de separación o demarcación en informes.

REPLICATE( “-“, 132 )