Supprimer

Supprime une paire clé/valeur d'un objet.

Entrée

Champ	Définition	Type	Obligatoire
objet	L'objet contenant la paire clé/valeur que vous voulez supprimer.	Objet	TRUE
chemin	La clé à supprimer. Il peut s'agir d'un nom de clé de niveau supérieur, d'un chemin délimité par des points vers une sous-clé ou d'une liste de noms de clés.	Texte	TRUE

Sortie

Champ	Définition	Type
sortie	Le nouvel objet dont la paire clé/valeur a été supprimée.	Objet

Exemples

Supprimer une clé de niveau supérieur

Pour le cas simple où vous voulez supprimer une paire clé/valeur de niveau supérieur, fournissez le nom de la clé comme chemin.

Entrée

objet :
```
{
    "foo": 1,
    "bar": 2
}
```
chemin : foo

Sortie

sortie :

{
  "bar": 2
}

Spécifier un chemin délimité par des points

Un chemin peut aussi servir à spécifier une clé à l'intérieur d'un sous-objet, en utilisant un point pour indiquer le sous-objet.

Entrée

objet :

{
  "a": "one",
  "b": {
    "foo": 1,
    "bar": 2
  }
}

chemin : b.foo

Sortie

sortie :

{
  "a": "one",
  "b": {
    "bar": 2
  }
}

Utiliser un numéro d'index

Vous pouvez aussi utiliser un numéro d'index pour indiquer le chemin d'un élément de liste à l'intérieur d'un objet. Les références de liste commencent avec un numéro d'index de 0.

Pour supprimer la paire clé/valeur bar sur le 7e élément d'une liste se trouvant dans la clé foo, votre chemin serait foo.6.bar.

L'exemple suivant supprime une option d'un menu de boulangerie. Le chemin spécifie le deuxième élément de la liste (numéro d'index 1) pour la clé topping à l'intérieur de l'objet.

Entrée

objet :

{
  "type": "donut",
  "name": "Raised",
  "batters": {
    "batter": [
      {
        "id": "1001",
        "type": "Regular"
      }
    ]
  },
  "topping": [
    {
      "id": "5003",
      "type": "Chocolate"
    },
    {
      "id": "5004",
      "type": "Maple"
    }
  ]
}

chemin : topping.1

Sortie

sortie :

{
  "type": "donut",
  "name": "Raised",
  "batters": {
    "batter": [
      {
        "id": "1001",
        "type": "Regular"
      }
    ]
  },
  "topping": [
    {
      "id": "5003",
      "type": "Chocolate"
    }
  ]
}

Utiliser une liste de texte comme chemin

Le chemin délimité par des points est simple et puissant, mais il peut ne pas fonctionner si vos noms de clés sont des nombres ou comprennent le caractère point. Dans ce cas, vous pouvez contrôler explicitement le chemin en utilisant une liste de texte. Chaque élément de la liste est traité comme une seule clé, sans interpréter les nombres ou les points.

Entrée

objet :

{
  "a": "one",
  "b.foo": {
    "7": "bar",
    "8": "baz"
  }
}

chemin : utilisez le menu déroulant pour définir le chemin comme une liste de texte.
- Première entrée : b.foo
- Deuxième entrée : 7

Sortie

sortie :

{
  "a": "one",
  "b.foo": {
    "8": "baz"
  }
}