MENU
  1. Accueil
  2. Langage C
  3. Gestion du format JSON en C avec la bibliothèque cJSON

Gestion du format JSON en C avec la bibliothèque cJSON

Langage C

Dans les projets modernes, le format JSON (JavaScript Object Notation) est devenu un standard pour échanger et stocker des données en raison de sa lisibilité et de sa simplicité. Cependant, le langage C, en raison de sa conception historique, n’intègre pas de fonctionnalités natives pour gérer le JSON. Cela peut poser un défi pour les développeurs travaillant dans des environnements où le JSON est omniprésent.

Pour surmonter cette limitation, la bibliothèque cJSON offre une solution légère, rapide et intuitive. Conçue spécifiquement pour le langage C, elle permet de lire, analyser, manipuler et générer des fichiers JSON avec une syntaxe claire et un minimum de surcharge. Grâce à cJSON, les développeurs peuvent intégrer facilement le support JSON dans leurs applications, que ce soit pour traiter des API modernes, gérer des configurations ou échanger des données entre systèmes.

Dans cet article, nous allons explorer les concepts fondamentaux de cJSON, ses fonctionnalités clés, et fournir des exemples pratiques pour son utilisation. Notre objectif est de vous guider pas à pas dans la gestion du JSON en C, en simplifiant des tâches souvent perçues comme complexes, tout en exploitant pleinement les capacités de cette bibliothèque.

Sommaire

Présentation de la bibliothèque cJSON


La bibliothèque cJSON est une solution open source conçue pour gérer le format JSON dans les applications écrites en langage C. Elle est légère, facile à utiliser et suffisamment puissante pour répondre aux besoins des projets modernes.

Fonctionnalités principales de cJSON


La bibliothèque cJSON fournit des fonctionnalités clés pour manipuler des fichiers JSON :

  • Analyse de JSON : Permet de lire et d’interpréter des fichiers JSON pour extraire les données.
  • Création de JSON : Offre des outils pour générer des structures JSON directement depuis des données en C.
  • Manipulation des objets : Inclut des fonctions pour modifier, ajouter ou supprimer des objets et des tableaux dans une structure JSON.
  • Compatibilité multiplateforme : Fonctionne sur la plupart des systèmes, grâce à sa conception minimaliste.

Installation de cJSON


Pour utiliser cJSON dans votre projet, suivez ces étapes :

  1. Téléchargez les fichiers source de la bibliothèque depuis le dépôt GitHub officiel.
  2. Compilez les fichiers cJSON.c et cJSON.h dans votre projet à l’aide de votre compilateur C préféré.
  3. Incluez l’en-tête cJSON.h dans votre code source avec la directive suivante :
   #include "cJSON.h"

Structure de base de cJSON


La bibliothèque repose sur une représentation en arbre des objets JSON. Chaque nœud est une structure cJSON qui peut contenir :

  • Un objet (cJSON_Object)
  • Un tableau (cJSON_Array)
  • Une chaîne de caractères (cJSON_String)
  • Un entier ou un réel (cJSON_Number)

Voici un exemple de déclaration de base :

cJSON *json_object = cJSON_CreateObject();
cJSON_AddStringToObject(json_object, "name", "John Doe");
cJSON_AddNumberToObject(json_object, "age", 30);

Avec cette présentation, vous êtes désormais prêt à explorer les fonctionnalités pratiques de cJSON pour lire, écrire et manipuler des fichiers JSON.

Lire et analyser un fichier JSON avec cJSON


La bibliothèque cJSON facilite l’analyse des fichiers JSON en offrant une interface intuitive pour charger et parcourir des données. Dans cette section, nous verrons comment lire un fichier JSON et extraire ses informations.

Étape 1 : Charger le fichier JSON


Pour analyser un fichier JSON, la première étape consiste à charger son contenu dans une chaîne de caractères. Voici un exemple d’ouverture d’un fichier JSON :

#include <stdio.h>
#include <stdlib.h>

char* read_file(const char* filename) {
    FILE* file = fopen(filename, "r");
    if (!file) {
        perror("Impossible d'ouvrir le fichier");
        return NULL;
    }
    fseek(file, 0, SEEK_END);
    long length = ftell(file);
    fseek(file, 0, SEEK_SET);

    char* content = (char*)malloc(length + 1);
    if (!content) {
        perror("Erreur d'allocation mémoire");
        fclose(file);
        return NULL;
    }

    fread(content, 1, length, file);
    content[length] = '\0';
    fclose(file);
    return content;
}

Étape 2 : Analyser le contenu avec cJSON


Une fois le fichier chargé, utilisez la fonction cJSON_Parse pour convertir la chaîne JSON en une structure exploitable.

#include "cJSON.h"

void parse_json(const char* json_data) {
    cJSON* json = cJSON_Parse(json_data);
    if (!json) {
        printf("Erreur d'analyse : %s\n", cJSON_GetErrorPtr());
        return;
    }

    // Exemple : Lecture des valeurs d'un objet JSON
    cJSON* name = cJSON_GetObjectItemCaseSensitive(json, "name");
    cJSON* age = cJSON_GetObjectItemCaseSensitive(json, "age");

    if (cJSON_IsString(name) && (name->valuestring != NULL)) {
        printf("Nom : %s\n", name->valuestring);
    }
    if (cJSON_IsNumber(age)) {
        printf("Âge : %d\n", age->valueint);
    }

    // Libération de la mémoire utilisée
    cJSON_Delete(json);
}

Étape 3 : Exemple pratique


Supposons que vous avez un fichier JSON nommé data.json avec le contenu suivant :

{
    "name": "Alice",
    "age": 25,
    "skills": ["C", "Python", "JSON"]
}

Voici comment lire et afficher son contenu :

int main() {
    char* json_data = read_file("data.json");
    if (json_data) {
        parse_json(json_data);
        free(json_data);
    }
    return 0;
}

Résultat attendu


En exécutant ce programme, la sortie sera :

Nom : Alice  
Âge : 25

Conclusion


Cette méthode montre comment charger un fichier JSON, l’analyser et extraire ses données avec cJSON. Avec ces bases, vous pouvez désormais manipuler facilement les objets JSON dans vos projets C.

Créer un fichier JSON en utilisant cJSON


La bibliothèque cJSON permet non seulement d’analyser des fichiers JSON, mais aussi de créer des fichiers JSON à partir de structures C. Cela peut être utile pour générer des fichiers de configuration, des réponses d’API ou tout autre type de données en format JSON.

Étape 1 : Créer un objet JSON


La création d’un fichier JSON commence par la définition d’une structure cJSON. Utilisez les fonctions cJSON_CreateObject ou cJSON_CreateArray pour initialiser des objets ou des tableaux JSON.

Exemple :

#include "cJSON.h"

cJSON* create_sample_json() {
    // Créer un objet JSON racine
    cJSON* root = cJSON_CreateObject();

    // Ajouter des paires clé-valeur
    cJSON_AddStringToObject(root, "name", "Alice");
    cJSON_AddNumberToObject(root, "age", 25);

    // Ajouter un tableau JSON
    cJSON* skills = cJSON_CreateArray();
    cJSON_AddItemToArray(skills, cJSON_CreateString("C"));
    cJSON_AddItemToArray(skills, cJSON_CreateString("Python"));
    cJSON_AddItemToArray(skills, cJSON_CreateString("JSON"));

    cJSON_AddItemToObject(root, "skills", skills);

    return root;
}

Étape 2 : Convertir en chaîne JSON


Une fois que l’objet JSON est construit, convertissez-le en une chaîne JSON à l’aide de la fonction cJSON_Print.

void save_json_to_file(cJSON* json, const char* filename) {
    // Convertir en chaîne JSON
    char* json_string = cJSON_Print(json);

    // Écrire dans un fichier
    FILE* file = fopen(filename, "w");
    if (file) {
        fputs(json_string, file);
        fclose(file);
        printf("Fichier JSON créé avec succès : %s\n", filename);
    } else {
        perror("Impossible d'écrire dans le fichier");
    }

    // Libérer la mémoire
    cJSON_free(json_string);
}

Étape 3 : Exemple complet


Combiner les étapes pour créer et sauvegarder un fichier JSON.

int main() {
    // Créer l'objet JSON
    cJSON* json = create_sample_json();

    // Sauvegarder dans un fichier
    save_json_to_file(json, "output.json");

    // Libérer la mémoire utilisée
    cJSON_Delete(json);

    return 0;
}

Exemple de fichier JSON généré


Le fichier output.json généré contiendra :

{
    "name": "Alice",
    "age": 25,
    "skills": ["C", "Python", "JSON"]
}

Étape 4 : Personnalisation et extensions


La bibliothèque cJSON permet d’ajouter des structures JSON plus complexes, comme des objets imbriqués ou des données supplémentaires.

Exemple d’objet imbriqué :

cJSON* address = cJSON_CreateObject();
cJSON_AddStringToObject(address, "city", "Paris");
cJSON_AddStringToObject(address, "country", "France");
cJSON_AddItemToObject(root, "address", address);

Conclusion


La bibliothèque cJSON simplifie la création de fichiers JSON en C en offrant une API intuitive et puissante. Grâce aux exemples ci-dessus, vous pouvez générer des fichiers JSON adaptés à vos besoins et les intégrer dans vos applications C.

Manipulations avancées avec cJSON


La bibliothèque cJSON propose des fonctionnalités avancées pour manipuler des structures JSON complexes. Ces outils permettent de travailler avec des tableaux, des objets imbriqués et d’effectuer des modifications dynamiques sur des données JSON existantes.

Gestion des tableaux JSON


Les tableaux JSON sont couramment utilisés pour regrouper plusieurs éléments similaires. La bibliothèque cJSON permet de créer, parcourir et modifier des tableaux avec une interface simple.

Création d’un tableau JSON

cJSON* create_json_array() {
    cJSON* array = cJSON_CreateArray();
    cJSON_AddItemToArray(array, cJSON_CreateString("C"));
    cJSON_AddItemToArray(array, cJSON_CreateString("Python"));
    cJSON_AddItemToArray(array, cJSON_CreateString("JavaScript"));
    return array;
}

Parcourir un tableau JSON

Pour parcourir un tableau JSON, utilisez la fonction cJSON_GetArrayItem.

void traverse_json_array(cJSON* array) {
    int array_size = cJSON_GetArraySize(array);
    for (int i = 0; i < array_size; i++) {
        cJSON* item = cJSON_GetArrayItem(array, i);
        if (cJSON_IsString(item)) {
            printf("Élément %d : %s\n", i, item->valuestring);
        }
    }
}

Manipulation des objets JSON imbriqués


Les objets imbriqués permettent de représenter des structures complexes, comme un utilisateur ayant une adresse ou plusieurs propriétés.

Création d’un objet JSON imbriqué

cJSON* create_nested_json_object() {
    cJSON* root = cJSON_CreateObject();

    cJSON_AddStringToObject(root, "name", "John");
    cJSON_AddNumberToObject(root, "age", 30);

    cJSON* address = cJSON_CreateObject();
    cJSON_AddStringToObject(address, "city", "Paris");
    cJSON_AddStringToObject(address, "country", "France");
    cJSON_AddItemToObject(root, "address", address);

    return root;
}

Extraction de données d’un objet imbriqué

Pour accéder aux données d’un objet imbriqué, utilisez cJSON_GetObjectItemCaseSensitive.

void extract_nested_json_data(cJSON* json) {
    cJSON* address = cJSON_GetObjectItemCaseSensitive(json, "address");
    if (cJSON_IsObject(address)) {
        cJSON* city = cJSON_GetObjectItemCaseSensitive(address, "city");
        if (cJSON_IsString(city)) {
            printf("Ville : %s\n", city->valuestring);
        }
    }
}

Modification dynamique des objets JSON


Les structures JSON peuvent être modifiées en ajoutant, supprimant ou mettant à jour des nœuds.

Ajouter un élément à un objet JSON

void add_element_to_json(cJSON* json) {
    cJSON_AddStringToObject(json, "email", "john.doe@example.com");
}

Supprimer un élément d’un objet JSON

void remove_element_from_json(cJSON* json, const char* key) {
    cJSON_DeleteItemFromObject(json, key);
}

Mettre à jour une valeur

void update_json_value(cJSON* json, const char* key, const char* new_value) {
    cJSON_ReplaceItemInObject(json, key, cJSON_CreateString(new_value));
}

Exemple pratique complet

int main() {
    cJSON* json = create_nested_json_object();

    printf("Objet JSON initial :\n%s\n", cJSON_Print(json));

    add_element_to_json(json);
    printf("\nAprès ajout :\n%s\n", cJSON_Print(json));

    update_json_value(json, "name", "Jane");
    printf("\nAprès mise à jour :\n%s\n", cJSON_Print(json));

    remove_element_from_json(json, "email");
    printf("\nAprès suppression :\n%s\n", cJSON_Print(json));

    cJSON_Delete(json);
    return 0;
}

Résultat attendu

  • Objet initial : Affiche les données JSON initiales.
  • Après ajout : Ajoute une adresse e-mail.
  • Après mise à jour : Change le nom de « John » à « Jane ».
  • Après suppression : Supprime l’adresse e-mail.

Conclusion


Grâce aux fonctionnalités avancées de cJSON, vous pouvez gérer des structures JSON complexes et effectuer des modifications dynamiques de manière intuitive. Cela facilite l’intégration de JSON dans vos projets C, même lorsqu’il s’agit de données volumineuses ou imbriquées.

Conclusion


Dans cet article, nous avons exploré la gestion du format JSON en C à l’aide de la bibliothèque cJSON. Nous avons vu comment :

  1. Lire et analyser des fichiers JSON pour extraire des données essentielles.
  2. Créer et sauvegarder des fichiers JSON à partir de structures en langage C.
  3. Manipuler des objets et tableaux JSON, y compris des structures imbriquées et des modifications dynamiques.

La bibliothèque cJSON offre une interface simple mais puissante pour intégrer le support JSON dans des applications C, rendant possible la gestion de données modernes dans un langage historique. Sa légèreté et sa compatibilité multiplateforme en font un outil idéal pour les projets nécessitant des performances élevées tout en interagissant avec des systèmes modernes.

En exploitant les techniques présentées, vous êtes désormais équipé pour intégrer efficacement le format JSON dans vos projets en langage C et ainsi répondre aux exigences des applications contemporaines.

Langage C
JSON C Parsing cJSON Library
Sommaire