List Add

Résumé

• Nom interne : ListAdd
• Catégorie : Collections
• Objectif : Ajouter une valeur à la fin d'une variable liste.
• 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 Add ajoute une valeur de type chaîne à la fin d'une variable liste existante. La liste grandit d'un élément à chaque appel.

list_variable_input et value_input supportent tous deux l'interpolation $variable — value_input peut être une chaîne littérale, une référence de variable ou une expression mixte comme "item_$index".

La variable liste doit avoir été préalablement initialisée avec Init List.

---

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	—
value_input	Chaîne / Variable	Oui	Littéral ou référence $variable	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 mise à jour avec le nouvel élément ajouté.

---

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([▶ ListAdd]) --> ResolveList[🔄 Résolution de list_variable_input\nrécupération de la liste]
    ResolveList --> CheckList{Liste valide ?}
    CheckList -->|Non| E1[❌ RESOLVE-VAR-005]
    CheckList -->|Oui| ResolveValue[🔄 Résolution de value_input\nremplacement des $refs]
    ResolveValue --> Add[list.add valeur]
    Add --> Store[💾 setVariableValue\nvar ← liste mise à jour]
    Store --> Success([✅ VoidResult])
    E1 --> Error([❌ Exception])

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

---

Exemple JSON complet

{
  "InitList": [{ "id": "1", "title": "Init", "list_variable_input": "$maListe" }],
  "ListAdd": [
    { "id": "2", "title": "Ajouter hello", "list_variable_input": "$maListe", "value_input": "hello" },
    { "id": "3", "title": "Ajouter $item", "list_variable_input": "$maListe", "value_input": "$item" }
  ]
}