> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://documentation.celestory.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 🟥 Répétition

# 🟥 Répétition

${frame}[Vidéo : anatomie du bloc Répétition](https://celestory-docs-videos.netlify.app/fr/anatomie-bloc/repeat.html)

![Répétition](https://celestory-docs-illustrations.netlify.app/fr/Repetition_FR.svg)

Le bloc Répétition permet de répéter une action plusieurs fois de suite (l'équivalent d'une boucle "for" en programmation).

Il évite de dupliquer les mêmes blocs à la main dans le graphe : par exemple pour créer plusieurs éléments à l'écran, distribuer des objets, ou faire plusieurs appels réseau d'affilée.

## 📥 Entrées

-   iterations (Nombre) : Nombre entier définissant le nombre total d'exécutions de la boucle. Par exemple, une valeur de 3 répétera l'action trois fois.

## 📤 Sorties

-   index (Nombre) : Indique le numéro de l'itération en cours (1, 2, 3, etc.). Utile pour des opérations incrémentales ou des listes.
-   out (Stream) : Flux principal de la boucle. Tout ce qui y est connecté s'exécute à chaque itération.
-   fin (Stream) : Flux déclenché une fois toutes les itérations terminées. Permet de poursuivre le flux après la boucle.

## 💡 Exemple d'utilisation

Scénario : Générer une grille de cases pour un jeu de plateau

1. Un jeu a besoin d'une grille de 4x4 cases pour un niveau.
1. Le bloc Répétition est réglé avec count à 16 (4x4).
1. La sortie loop est reliée à un bloc qui crée une case, en la plaçant à une position calculée à partir de index (ex : x = index % 4, y = index // 4).
1. À chaque itération, une nouvelle case est créée et placée automatiquement.
1. Une fois les 16 itérations terminées, la sortie fin déclenche un bloc de validation pour passer à l'étape suivante du jeu.

## ⚙️ Détails Techniques

-   Gestion des variables : Les sorties comme index sont mises à jour de façon asynchrone. En cas de délai (appel API, calcul lourd), vérifiez que les données restent cohérentes.
-   Cas particulier : Si count vaut 0, le flux loop n'est jamais déclenché et fin l'est immédiatement.

---

*Version documentée : v2*