Grouper par

Cette fonction prend une liste et génère un objet qui est regroupé par valeurs dans la liste d'origine au chemin spécifié.

La fonction renvoie un objet qui regroupe une liste d'éléments, par exemple des objets, des chaînes ou des nombres, en fonction de la valeur du chemin spécifié. Chaque valeur unique correspondant au chemin spécifié dans la liste d'entrée a une clé correspondante dans l'objet. Pour chaque clé dans l'objet renvoyé, cette fonction renvoie à partir de la liste une liste d'éléments d'entrée qui ont une valeur correspondante au chemin spécifié de la clé.

Entrée

Champ	Définition	Type	Obligatoire
liste	La liste d'objets à regrouper selon le chemin spécifié.	Liste d'objets	TRUE
chemin	La valeur ou l'élément utilisé pour regrouper la liste.	Texte	FALSE

Sortie

Champ	Définition	Type
sortie	L'objet de sortie, les clés étant les valeurs uniques dans le chemin de chaque élément de la liste d'origine.	Objet

Exemples

Un exemple simple utilise les entrées suivantes :

list = [{"a":1},{"a":2},{"a":3},{"a":3},{"a":3}]

path = a

Cette fonction prend la liste d'entrées, la regroupe en fonction du chemin spécifié et génère ce qui suit :

{
    "1": [ {"a": 1} ],
    "2": [ {"a": 2} ],
    "3": 
        [ 
            {"a": 3},
            {"a": 3},
            {"a": 3}
        ]
}

Un exemple légèrement plus avancé utilise les entrées suivantes :

list = 
[
  {
    "a": 1,
    "b": {
      "c": 2,
      "d": 3
    }
  },
  {
    "a": 4,
    "b": {
      "c": 5,
      "d": 6
    }
  },
  {
    "a": 7,
    "b": {
      "c": 8,
      "d": 6
    }
  }
]

path = b.d

Pour l'entrée précédente, la fonction renvoie un objet qui est regroupé autour des valeurs dans le chemin d'accès b.d :

{
  "3": [
    {
      "a": 1,
      "b": {
        "c": 2,
        "d": 3
      }
    }
  ],
  "6": [
    {
      "a": 4,
      "b": {
        "c": 5,
        "d": 6
      }
    },
    {
      "a": 7,
      "b": {
        "c": 8,
        "d": 6
      }
    }
  ]
}