ספרים
C
פרק 10. פורמטים של נתונים וסריאליזציה
עובדים עם TOML

C:
עובדים עם TOML

איך לעשות:

כדי לעבוד עם TOML ב-C, תצטרך תחילה ספרייה שיכולה לפענח קבצי TOML, מכיוון שהספרייה הסטנדרטית של C לא כוללת פונקציונליות זו. בחירה פופולרית היא tomlc99, פענח TOML קל משקל ל-C99. הנה מדריך מהיר לקרוא קובץ תצורה TOML פשוט:

ראשית, ודא שtomlc99 מותקן ומקושר כראוי בפרויקט שלך.

דוגמת קובץ TOML (config.toml):

[database]
server = "192.168.1.1"
ports = [ 8001, 8001, 8002 ]
connection_max = 5000
enabled = true

קוד C לפיענוח קובץ זה:

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

int main() {
    FILE *configFile;
    configFile = fopen("config.toml", "r");
    if (!configFile) {
        perror("Cannot open file");
        return EXIT_FAILURE;
    }

    toml_table_t *config = toml_parse_file(configFile, NULL, 0);
    if (!config) {
        fprintf(stderr, "Error parsing file\n");
        fclose(configFile);
        return EXIT_FAILURE;
    }

    toml_table_t *database = toml_table_in(config, "database");
    if (database) {
        const char *server = toml_raw_in(database, "server");
        printf("Database Server: %s\n", server);

        toml_array_t *ports = toml_array_in(database, "ports");
        for (int i = 0; i < toml_array_nelem(ports); i++) {
            int64_t port;
            toml_int_at(ports, i, &port);
            printf("Port %d: %ld\n", i, port);
        }
    }

    toml_free(config);
    fclose(configFile);
    return EXIT_SUCCESS;
}

פלט:

Database Server: "192.168.1.1"
Port 0: 8001
Port 1: 8001
Port 2: 8002

טבילה עמוקה

TOML נוצר על ידי טום פרסטון-ורנר, שותף מייסד של GitHub, כתגובה למגבלות שהוא הבחין בהן בפורמטים אחרים של קבצי תצורה. מטרתו היא להיות פשוטה וחד-משמעית, הן לאנשים והן למחשבים, לקרוא ולכתוב בלי הצורך בכללי פענוח מורכבים. באקוסיסטם של C, TOML אינו אזרח דרג א’ כמו שהוא עשוי להיות בשפות גבוהות יותר כמו Rust עם serde_toml או Python עם toml, שיש להן ספריות עם תמיכה ילידית. לעומת זאת, מפתחי C צריכים להסתמך על ספריות חיצוניות כמו tomlc99, אך זהו מצב טיפוסי בהתחשב בדגש של C על מינימליזם וביצועים.

למרות ש-TOML מקבל שבחים על בהירותו, כאשר בוחרים פורמט קובץ תצורה, חיוני לשקול את צרכי הפרויקט. בתרחישים הדורשים מבנים מורכבים יותר או אינטראקטיביות עם web APIs, JSON או אפילו YAML עשויים להציע התאמה טובה יותר למרות המורכבות המוגברת שלהם. TOML מבריק בתצורות שבהן הקריאות והפשטות הם העולים על הכל, לא בהכרח שם שיש צורך במבני נתונים המתקדמים ביותר.

עבודה עם JSONעבודה עם XML