> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/french/function-blocks/blocks-reference/data-logic/flow-control/get-batch-size.md).

# Get Batch Size

Ce bloc de fonction renvoie le nombre d'éléments dans un lot ou une liste fournie. Il est utile pour le contrôle de flux, la journalisation et les décisions de branchement lors de la manipulation de données groupées.

## 📥 Entrées <a href="#inputs" id="inputs"></a>

* `Batch` Cette entrée accepte un lot/liste d'éléments à mesurer.
  * Socket: Input

## 📤 Sorties <a href="#outputs" id="outputs"></a>

* `Size` Valeur numérique représentant le nombre d'éléments dans le lot fourni.
  * Socket: Output

## 🕹️ Contrôles <a href="#controls" id="controls"></a>

* `No Controls` Ce bloc de fonction n'expose aucun widget interactif.

## ⚙️ Mécanisme d'exécution <a href="#running-mechanism" id="running-mechanism"></a>

Lorsque ce bloc reçoit un lot sur sa socket d'entrée, il évalue la collection et envoie le nombre actuel d'éléments sur la sortie `Size`. Placez ce bloc en aval de tout processus qui crée ou combine des lots pour obtenir un compte numérique immédiat destiné à la prise de décision ou à la journalisation.

Utilisez des blocs d'aide (voir Astuces) pour valider ou ajuster le lot avant de l'alimenter, afin que la mesure de taille soit fiable même lorsque les données en amont sont manquantes ou dynamiques.

## 🎯 Fonctionnalités <a href="#features" id="features"></a>

* Bloc simple et mono-objectif fournissant immédiatement la taille numérique pour toute entrée de type lot/liste.
* Sert d'outil léger de contrôle de flux pour déclencher une logique conditionnelle basée sur la longueur du lot.
* Compatible avec les blocs génériques producteurs de lots dans les catégories flow-control et data processing.

## 📝 Utilisation <a href="#usage" id="usage"></a>

* Placez ce bloc après tout bloc qui produit une liste/lot pour obtenir le nombre d'éléments transmis.
* Raccordez la sortie `Size` à des blocs de comparaison ou logiques (par exemple `Greater`, `Equals`, `Logic Input`) pour brancher le scénario selon le nombre d'éléments.
* Combinez avec des blocs de journalisation ou d'export pour enregistrer combien d'éléments ont été traités à chaque exécution.

## 💡 Astuces <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* Utilisez avec `Batch Processing` lorsque vous créez des lots pour un traitement mémoire-efficace ; connectez sa sortie de lot au `Batch` ici pour surveiller les tailles de lot.
* Après avoir scindé un lot avec `Debatch`, reconnectez les morceaux et utilisez ce bloc pour vérifier la taille des listes réassemblées.
* Combinez avec `Get Element` pour vérifier la longueur d'un lot avant d'accéder à un index ; cela évite les accès hors plage.
* Lors de la fusion de plusieurs lots, utilisez d'abord `Batch Concatenation`, puis ce bloc pour confirmer la taille résultante.
* Si la source en amont peut ne rien fournir, associez ce bloc à `Is None` ou `Replace None` pour garantir un comportement stable et éviter des erreurs inattendues.

## 🛠️ Dépannage <a href="#troubleshooting" id="troubleshooting"></a>

* Si le bloc indique des tailles inattendues, vérifiez que l'entrée est bien de type liste/lot (utilisez le débogage ou `Debug Input` pour inspecter le contenu).
* Si l'entrée peut être absente, ajoutez une validation avec `Is None` ou `Replace None` afin que la mesure de taille reste prévisible.