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 :

  • Samsung (One UI 6.x / 7.x / 8.x)
  • Autres fabricants - pas encore supportés (Xiaomi HyperOS et Google Pixel en cours d'adaptation)

• 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"
    }
  ]
}