Les opérateurs de tableaux / Array operators : to, limit, take, skip, offset

Les opérateurs de tableaux permettent de contrôler le résultat de sortie d'un tableau.

Les syntaxes

Noms	Opérateurs	Syntaxes	Opérandes	Résultat
Jusqu'à	take ou limit	Syntaxes par défaut array take number array limit number Syntaxes Fonctionnelles take (array, number) limit (array, number)	Nombre d'opérandes : 2	Résultat : array
À partir de	Skip ou offset	Syntaxes par défaut array skip number array offset number Syntaxes Fonctionnelles skip (array, number) offset (array, number)	Nombre d'opérandes : 2	Résultat : array
Plage de nombres	to	Syntaxe par défaut number to number	Nombre d'opérandes : 2	Résultat : array[number]

Jusqu'à

Les opérateurs take et limit permettent de définir une limite maximum de sets d'un tableau.

• Les opérateurs take et limit doivent être attaché uniquement à un tableau.

• Les opérateurs take et limit ne peuvent pas être associé à l'opérateur to.

• Les opérateurs take et limit peuvent être imbriqué dans plusieurs expressions Blogger dont le résultat doit être un tableau.

• Le tableau peut être :

  • Une valeur explicite.

  • Une donnée.

  • Le résultat d'une expression Blogger (une opération imbriquée).

• Le nombre peut être :

  • Une valeur explicite.

  • Une donnée.

  • Le résultat d'une expression Blogger (une opération imbriquée).

Exemple avec des valeurs explicites

<b:loop values='["toto","titi","tutu"] take 2' var='myArray'>

  <data:myArray/>

</b:loop>

Le tableau contient 3 entrées, dont les 2 premières seront lues.

Exemple avec des données numériques

<b:loop values='data:posts limit (data:posts.length - (data:posts.length % 2)) / 2' var='myArray'>

  <data:myArray.title/>

</b:loop>

Seulement la première moitié du tableau sera lue.

À partir de

Les opérateurs skip et offset permettent de démarrer la lecture d'un tableau à partir d'un item déterminé.

• L'opérateur skip et offset doivent être attaché uniquement à un tableau.

• L'opérateur skip et offset ne peuvent pas être associé à l'opérateur to.

• L'opérateur skip et offset peuvent être imbriqué dans plusieurs expressions Blogger dont le résultat doit être un tableau.

• Le tableau peut être :

  • Une valeur explicite.

  • Une donnée.

  • Le résultat d'une expression Blogger (une opération imbriquée).

• Le nombre peut être :

  • Une valeur explicite.

  • Une donnée.

  • Le résultat d'une expression Blogger (une opération imbriquée).

Exemple avec des valeurs explicites

<b:loop values='["toto","titi","tutu"] skip 2' var='myArray'>

  <data:myArray/>

</b:loop>

Le tableau contient 3 entrées, dont les 2 premières seront ignorées.

Exemple avec des données numériques

<b:loop values='data:posts offset (data:posts.length - (data:posts.length % 2)) / 2' var='myArray'>

  <data:myArray.title/>

</b:loop>

Seulement la seconde moitié du tableau sera lue.

Plage de nombres

L'opérateur to crée un tableau de nombres.

• L'opérateur ne peut être utilisé que dans une balise <b:loop>.

• La plage de nombres peut être chronologique ou antéchronologique.

• Les nombres négatifs sont autorisés.

• Les décimales ne sont pas autorisées.

• Les valeurs numériques peuvent être :

  • Une valeur explicite.

  • Une donnée.

  • Le résultat d'une expression Blogger (une opération imbriquée).

• L'opération ne peut être associée à d'autres opérations (l'expression + une autre expression).

Exemple avec des valeurs numériques explicites

<b:loop values='5 to 10' var='maPlage'/>

  <data:maPlage/>

</b:loop>

Le résultat de l'opération sera une plage de nombres entre 5 et 10.

Exemple avec des données numériques

<b:loop values='0 to data:posts.length - 1' var='maPlage'>

  <data:maPlage/>

</b:loop>

Le résultat de l'opération recompose l'indice du tableau posts.

Les autres opérateurs

• + (concatenate)
• + (addition)
- (substraction)
* (multiplication)
/ (division)
% (modulus)
• ?: (selector)
• and (&&)
or (||)
not (!)
• eq (==)
neq (!=)
lt (<)
lte (<=)
gt (>)
gte (>=)
• appendParams
fragment
params
path
• in
contains (array)
• contains (string)
• format
• limit / take
skip / offset
to
• resizeImage
sourceSet
• snippet
• any
all
none
count
map / select
filter / where
first

Retourner à l'introduction