List Get

Résumé

• Nom interne : ListGet
• Catégorie : Collections
• Objectif : Lire l'élément à l'index donné d'une variable liste et le stocker dans une variable de sortie.
• 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 Get lit l'élément de type chaîne situé à la position index_input (base zéro) et le stocke dans la variable value_output. La liste elle-même n'est pas modifiée.

---

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	—
index_input	Entier / Variable	Oui	Index base zéro ; doit être 0 ≤ index < taille	Android 13 (API 33) → Android 16 (API 36)	1.1.0 → 1.1.0	0

---

Paramètres de sortie

Champ	Type	Condition	Défaut
value_output	Chaîne	En cas de succès — l'élément à index_input	<ANDROMATE_NULL_VALUE>

---

Exceptions

Code	Nom de l'exception	Description
COLLECTION-TASK-001	List Variable Not a List	Index hors limites — négatif ou ≥ taille de la liste.
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([▶ ListGet]) --> ResolveList[🔄 Résolution de list_variable_input]
    ResolveList --> CheckList{Liste valide ?}
    CheckList -->|Non| E1[❌ RESOLVE-VAR-005]
    CheckList -->|Oui| ResolveIndex[🔄 Résolution de index_input]
    ResolveIndex --> CheckBounds{0 ≤ index < taille ?}
    CheckBounds -->|Non| E2[❌ COLLECTION-TASK-001]
    CheckBounds -->|Oui| Get[element = list.get index]
    Get --> SetOutput[💾 result.setOutputStr element\nstocké via value_output]
    SetOutput --> Success([✅ StrTaskResult])
    E1 --> Error([❌ Exception])
    E2 --> Error

    style Start fill:#e3f2fd
    style Success fill:#c8e6c9
    style Error fill:#ffcdd2
    style ResolveList fill:#fff9c4
    style ResolveIndex fill:#fff9c4
    style SetOutput fill:#c8e6c9
    style E1 fill:#ffcdd2
    style E2 fill:#ffcdd2

---

Exemple JSON complet

{
  "ListGet": [
    {
      "id": "6",
      "title": "Lire le premier élément",
      "list_variable_input": "$maListe",
      "index_input": "0",
      "value_output": "$premierElement"
    }
  ]
}