Dans MariaDB, JSON_ARRAY()
est une fonction intégrée qui renvoie un tableau JSON contenant les valeurs spécifiées, fournies en tant qu'arguments.
Syntaxe
La syntaxe ressemble à ceci :
JSON_ARRAY([value[, value2] ...])
Où chacun des value
, value2
, ...
devient un élément de tableau du tableau résultant.
Les arguments sont facultatifs, il est donc possible de créer un tableau vide en ne passant aucun argument.
Exemple
Voici un exemple pour illustrer la fonction.
SELECT JSON_ARRAY('Cat', 'Dog', 'Bird');
Résultat :
+----------------------------------+ | JSON_ARRAY('Cat', 'Dog', 'Bird') | +----------------------------------+ | ["Cat", "Dog", "Bird"] | +----------------------------------+
En voici une autre avec des chiffres et null
:
SELECT JSON_ARRAY(0, 1, 2, 3, null);
Résultat :
+------------------------------+ | JSON_ARRAY(0, 1, 2, 3, null) | +------------------------------+ | [0, 1, 2, 3, null] | +------------------------------+
Caractères d'échappement
Le JSON_ARRAY()
la fonction échappe automatiquement les guillemets doubles avec une barre oblique inverse.
Exemple :
SELECT JSON_ARRAY('The "right" time');
Résultat :
+--------------------------------+ | JSON_ARRAY('The "right" time') | +--------------------------------+ | ["The \"right\" time"] | +--------------------------------+
Chaînes vides
Passer une chaîne vide entraîne l'ajout d'une chaîne vide au tableau :
SELECT JSON_ARRAY('','','');
Résultat :
+----------------------+ | JSON_ARRAY('','','') | +----------------------+ | ["", "", ""] | +----------------------+
Tableaux vides
Comme mentionné, il est possible de créer un tableau vide en ne passant aucun argument.
SELECT JSON_ARRAY();
Résultat :
+--------------+ | JSON_ARRAY() | +--------------+ | [] | +--------------+