List Clear

Résumé

• Nom interne : ListClear
• Catégorie : Collections
• Objectif : Supprimer tous les éléments d'une variable liste et la remettre à [].
• Type de tâche : Normale

---

Compatibilité

• Version AndroMate minimale : 1.1.0

• Version AndroMate maximale : 1.1.0

• Android minimum : Android 13 (API 33)

• Android testé maximum : Android 16 (API 36)

• Fabricants supportés :

  • ✅ Tous les fabricants

• Permissions requises :

  • Aucune

---

Description détaillée

La tâche List Clear vide entièrement une variable liste en remplaçant son contenu par []. Elle est sémantiquement équivalente à appeler Init List sur une variable déjà existante, mais exprime un vidage plutôt qu'une initialisation.

Utilisez-la pour réutiliser la même variable liste à travers plusieurs itérations d'une boucle sans avoir à la re-déclarer dans Start.

---

Paramètres d'entrée

Paramètre	Type	Requis	Valeurs possibles	Compatibilité Android	Compatibilité AndroMate	Défaut
list_variable_input	Référence de variable	Oui	Variable déclarée commençant par $, contenant une liste valide	Android 13 (API 33) → Android 16 (API 36)	1.1.0 → 1.1.0	—

---

Paramètres de sortie

Aucun. La variable référencée par list_variable_input est remise à [].

---

Exceptions

Code	Nom de l'exception	Description
COLLECTION-TASK-002	List Variable Name Invalid	list_variable_input est vide ou ne commence pas par $.
RESOLVE-VAR-005	Resolve ArrayList Error	La variable ne contient pas une chaîne JSON array valide.

---

Diagramme d'exécution

flowchart TD
    Start([▶ ListClear]) --> ResolveList[🔄 Résolution de list_variable_input]
    ResolveList --> CheckList{Liste valide ?}
    CheckList -->|Non| E1[❌ RESOLVE-VAR-005]
    CheckList -->|Oui| Store["💾 setVariableValue\nvar ← []"]
    Store --> Success([✅ VoidResult])
    E1 --> Error([❌ Exception])

    style Start fill:#e3f2fd
    style Success fill:#c8e6c9
    style Error fill:#ffcdd2
    style ResolveList fill:#fff9c4
    style Store fill:#c8e6c9
    style E1 fill:#ffcdd2

---

Exemple JSON complet

{
  "ListClear": [
    {
      "id": "8",
      "title": "Vider la liste",
      "list_variable_input": "$maListe"
    }
  ]
}