La función $R de Prototype se utiliza para generar una secuencia de valores consecutivos, ya sean numéricos, textuales o de otro tipo que semánticamente sean compatibles con rangos de valores. Para ilustrar un poco el funcionamiento y salvando la distancia $R es más o menos como la función "Rellenar serie de Excel".
La sintáxis básica es muy simple: $R(start, end) donde start y end serán los valores donde debe comenzar y terminar la serie de valores respectivamente, por ejemplo:
$R( 0 , 5 ) --> 012345
$R( 'a' , 'e' ) --> abcde
$R( '1a' , '1e' ) --> 1a1b1c1d1e
$R( 'a1' , 'a5' ) --> a1a2a3a4a5
Con $R podemos utilizar el método join, con éste incorporamos el separador deseado a la lista de valores generada, (join contempla los espacios en blanco al momento de definir el separador) por ejemplo:
$R( 0 , 5 ).join(',') --> 0,1,2,3,4,5
$R( 'a' , 'e' ).join(' ;... ') --> a ;... b ;... c ;... d ;... e
$R( '1a' , '1e' ).join(' / ') --> 1a / 1b / 1c / 1d / 1e
$R( 'a1' , 'a5' ).join(' separador ') --> a1 separador a2 separador a3 separador a4 separador a5
$R tiene un tercer parámetro en su sintáxis con el cual podemos indicar si el valor definido como final se incluye o no en la secuencia. Es un valor booleano: false --> incluye y true --> excluye. Por defecto es false.
$R( 0 , 5 ).join(',') --> 0,1,2,3,4,5
$R( 0 , 5 , false).join(',') --> 0,1,2,3,4,5
$R( 0 , 5, true ).join(',') --> 0,1,2,3,4
Podemos consultar a $R si dentro de la secuencia que generó existe un determinado valor, para ello utilizamos el método include. Este método devuelve true si encuentra el valor dentro de la secuencia y false si no lo encuentra:
$R( 0 , 5 ).include(5) --> true
$R( 0 , 5 , true ).include(5) --> false
$R( 0 , 5 ).include(15) --> false
Podemos utilizar el método each para recorrer los valores de la secuencia generada por $R
$R( 0, 5, true ).each(function(valor){
alert (valor);
});
