JSON'dan C++'ya

İlgili Öneriler

JSON'dan C++'ya Hakkında: JSON Verilerini Derlenebilir C++ Struct'larına Dönüştürme

Kullanım senaryoları

• REST API entegrasyonu: Arka uçtan dönen JSON yanıtlarını C++ struct'larına dönüştürün, güçlü türlü HTTP istek deserializasyonu için nlohmann::json/cpr ile kullanın
• Mikro hizmet arayüz tanımı: gRPC/HTTP hizmetlerinin istek gövdesi örnek JSON'unu C++ türlerine dönüştürün, sunucu tarafı model tanımlarını birleştirin
• Gömülü sistemler ve IoT: Cihazların raporladığı JSON sensör verilerini C++ struct'larına dönüştürün, MQTT/HTTP mesajlarını ayrıştırmak için ArduinoJson veya ESP-IDF JSON Parser ile kullanın
• Oyun geliştirme: Seviye yapılandırması, karakter özellikleri JSON'unu C++ struct'larına dönüştürün, Unreal Engine veya Cocos2d-x gibi motorların .json veri dosyalarını okumasını kolaylaştırın
• Finansal yüksek frekanslı ticaret: Borsa JSON arayüz yanıtlarını (OKX/Binance/Xueqiu piyasa verileri gibi) C++ struct'larına dönüştürün, nanosaniye düzeyinde ayrıştırma için rapidjson ile kullanın
• C++ Qt istemcileri: Sunucu JSON yapılandırmasını C++ struct'larına dönüştürün, GUI veri yükleme için QJsonObject/QJsonDocument ile kullanın
• Boost.JSON/Boost.Beast: HTTP hizmetlerinin JSON yanıtlarını C++ struct'larına dönüştürün, deserializasyon için Boost.JSON ile kullanın, Web arka uçları yazın
• Gömülü RTOS: FreeRTOS/Zephyr sistem yapılandırması JSON'unu C++ struct'larına dönüştürün, firmware parametrelerini okumak için cJSON ile kullanın
• Algoritma/nicel ticaret: Backtest sistemlerinin JSON yapılandırmasını C++ struct'larına dönüştürün, A/B deney yapılandırma yönetimi ve sürüm geri izlemeyi kolaylaştırın
• Veritabanı migrasyonu: MongoDB/PostgreSQL'den dışa aktarılan JSON belgelerini C++ modellerine dönüştürün, cpp-httplib/libpqxx varlık alanları için referans olarak kullanın
• Ses/video/multimedya: FFmpeg/GStreamer yapılandırması JSON'unu C++ struct'larına dönüştürün, medya hattı parametrelerinin okunmasını kolaylaştırın
• Simülasyon ve modelleme: Simülasyon sistemlerinin JSON girdi yapılandırmasını C++ struct'larına dönüştürün, farklı alt modellerin girdi veri biçimlerini birleştirin
• Test verisi oluşturma: Arka uçtan dönen gerçek JSON fixture'larını C++ türlerine dönüştürün, Google Test/Catch2 birim testlerinde yapısal iddialar yapın
• Yapısal günlük ayrıştırması: ELK/Loki tarafından yakalanan JSON günlüklerini C++ türlerine dönüştürün, filtreleme ve uyarı kuralları oluşturmayı kolaylaştırın
• Yapılandırma merkezi migrasyonu: Apollo/Nacos/Consul JSON yapılandırmasını C++ türlerine dönüştürün, sunucu tarafı yapılandırma sıcak yüklemesi için kullanın
• Diller arası işbirliği: Arka uç C++ ile ön uç TypeScript/Java entegrasyonu, aynı JSON'u sırasıyla C++ struct ve TS interface/Java POJO'ya dönüştürerek iki tarafın tutarlılığını koruyun
• Öğretim ve eğitim: C++ kurslarında örnek JSON'u struct'lara dönüştürün, nlohmann::json deserializasyon sürecini ve şablon metaprogramlama kavramlarını gösterin
• Alan adı dönüşümü: snake_case JSON API yanıtlarını C++ struct'larına dönüştürdükten sonra, alan eşleşmesi için manuel olarak NLOHMANN_DEFINE_TYPE_INTRUSIVE ekleyin

Nasıl Kullanılır

1. Sol düzenleyiciye JSON içeriğini yapıştırın (JSON nesnesi önerilir) veya .json/.txt dosyası seçmek için yükle düğmesine tıklayın
2. Araç, Web Worker aracılığıyla quicktype-core kullanarak 400ms içinde otomatik olarak dönüşüm yapar, sağ tarafta std::string/std::vector<T>/iç içe sınıflara sahip C++ header kodu görüntülenir
3. JSON biçimi hatalıysa kırmızı bir mesaj görüntülenir, yaygın sorunları (sondaki virgüller, tek tırnaklar vb.) otomatik olarak düzeltmek için 'JSON'u Düzelt' düğmesine tıklayın ve tekrar deneyin
4. Üretilen struct/sınıf adlarının, alan türlerinin beklentilerinize uygun olup olmadığını kontrol edin; ayarlama gerekiyorsa kaynak JSON'un anahtar adlarını değiştirin ve yeniden dönüştürün
5. Kodu IDE'nizin .h/.hpp dosyasına yapıştırmak için 'Kopyala'ya tıklayın, gerçek API yanıtlarını deserializasyon için nlohmann::json veya rapidjson ile kullanın; veya model.h/model.hpp olarak kaydetmek için 'İndir'e tıklayın

Özellikler

• Yerel tarayıcı dönüşümü: JSON ayrıştırma ve C++ kod üretimi tamamen tarayıcıda Web Worker + quicktype-core aracılığıyla yapılır, ham veriler hiçbir sunucuya yüklenmez
• nlohmann::json tarzı çıktı: std::string/std::vector<T>/double/int64_t/bool gibi STL tür struct'ları otomatik olarak üretir, nlohmann::json deserializasyon alışkanlıklarına uygundur, doğrudan <nlohmann/json.hpp> ekleyerek ayrıştırma yapabilirsiniz
• rapidjson uyumluluğu: Üretilen saf C++ struct'ları hiçbir üçüncü taraf kütüphaneye bağımlı değildir, yüksek performanslı ayrıştırma senaryolarında rapidjson Document/GenericValue ile kullanılabilir
• Otomatik tür çıkarımı: JSON dizeleri std::string ile, tamsayılar int64_t/long long ile, kayan noktalı sayılar double ile, boolean değerler bool ile, diziler std::vector<T> ile, iç içe nesneler bağımsız class/struct ile eşleşir
• İç içe nesnelerin otomatik ayrılması: İç içe JSON otomatik olarak bağımsız class/struct üretir (PascalCase adlandırma), aynı türün tekrarlayan tanımlarını önler
• std::vector ve std::optional otomatik işleme: JSON dizileri std::vector<T>'ye dönüştürülür, null olabilecek alanlar std::optional<T> ile güvence altına alınır, modern C++17/C++20 uygulamalarına uygundur
• 400ms debounce ile otomatik dönüşüm: JSON yapıştırdıktan sonra dönüşüm otomatik olarak tetiklenir, sağ tarafta C++ header kodu gerçek zamanlı olarak önizlenir, bekleme ve gereksiz tıklamaları azaltır
• JSON hatalarını tek tıklamayla düzeltme: Sondaki virgüller, tek tırnaklar, eksik tırnaklar gibi yaygın biçim hatalarını otomatik olarak düzeltir, düzeltme başarılı olduktan sonra kod üretmeye devam eder
• Kod vurgulama + tek tıklamayla kopyalama: Sağdaki CodeMirror alanı C++ sözdizimi vurgulaması yapar, tüm header dosyasını tek tıklamayla kopyalayabilir veya doğrudan projeye koymak için .h/.hpp dosyası olarak indirebilirsiniz
• localStorage giriş geçmişi + duyarlı bölünmüş sütunlar: Son girişleri otomatik olarak kaydeder, sayfayı yeniledikten veya yanlışlıkla kapattıktan sonra hızla kurtarabilirsiniz; sol tarafa JSON yapıştırın, sağ tarafta C++ kodunu görüntüleyin, panel genişliğini sürükleyerek ayarlamayı destekler, büyük ekranlara ve mobil cihazlara uyarlanmıştır
• Bağımlılıksız header-only ürün: Üretilen .h/.hpp header-only biçimindedir, tek dosya ile herhangi bir standart C++ projesine eklenebilir, ek yapılandırma yapmadan nlohmann::json/rapidjson/Boost.JSON ile kullanılabilir
• Yerleşik snake_case'den camelCase'e dönüşüm: JSON'daki snake_case alanlarını otomatik olarak C++ için önerilen camelCase alan adlarına dönüştürebilir, NLOHMANN_DEFINE_TYPE_INTRUSIVE ile snake_case serileştirme eşleşmesini korur

Kod Örnekleri

// model.hpp (bu araç tarafından üretilmiştir)
// #pragma once
// #include <cstdint>
// #include <optional>
// #include <string>
// #include <vector>
// struct Address {
//   std::string city;
//   std::string zip;
// };
// struct User {
//   int64_t id;
//   std::string name;
//   std::optional<Address> address;
//   std::vector<std::string> tags;
// };

#include <nlohmann/json.hpp>
#include "model.hpp"

using nlohmann::json;

int main() {
    std::string raw = R"({
        "id": 1,
        "name": "Alice",
        "address": { "city": "Beijing", "zip": "100000" },
        "tags": ["cpp", "nlohmann"]
    })";

    // 1) JSON dizesini ayrıştır
    json j = json::parse(raw);

    // 2) Bu araç tarafından üretilen struct'a güçlü türlü deserializasyon
    User u = j.get<User>();

    // 3) Alanlara eriş
    std::cout << u.name << " lives in "
              << (u.address ? u.address->city : "unknown")
              << std::endl;

    for (const auto& tag : u.tags) {
        std::cout << "tag: " << tag << std::endl;
    }
    return 0;
}

/*
 * Derleme (CMake projesi):
 *   find_package(nlohmann_json REQUIRED)
 *   target_link_libraries(my_app PRIVATE nlohmann_json::nlohmann_json)
 * Derleme (vcpkg):
 *   vcpkg install nlohmann-json
 * Tek dosya entegrasyonu:
 *   https://github.com/nlohmann/json/releases adresinden json.hpp dosyasını doğrudan indirin
 */

#include "rapidjson/document.h"
#include "rapidjson/stringbuffer.h"
#include <iostream>
#include "model.hpp"

int main() {
    const char* raw = R"({
        "id": 1,
        "name": "Alice",
        "address": { "city": "Beijing", "zip": "100000" },
        "tags": ["cpp", "rapidjson"]
    })";

    // 1) rapidjson DOM ayrıştırması
    rapidjson::Document doc;
    doc.Parse(raw);

    // 2) Bu araç tarafından üretilen struct'ı oluştur ve manuel olarak doldur
    User u;
    u.id = doc["id"].GetInt64();
    u.name = doc["name"].GetString();

    if (doc.HasMember("address") && doc["address"].IsObject()) {
        Address addr;
        addr.city = doc["address"]["city"].GetString();
        addr.zip  = doc["address"]["zip"].GetString();
        u.address = addr;
    }

    for (auto& tag : doc["tags"].GetArray()) {
        u.tags.push_back(tag.GetString());
    }

    // 3) Doldurulmuş struct'ı kullan
    std::cout << u.name << ", tags=" << u.tags.size() << std::endl;
    return 0;
}

/*
 * rapidjson yüksek performans ipuçları:
 *   ① rapidjson::MemoryPoolAllocator ve StringBuffer ile birlikte kullanmak daha da hızlandırabilir;
 *   ② Yüksek frekanslı senaryolarda doğrudan akışlı işleme için SAX tarzı Reader/Writer kullanılabilir;
 *   ③ RAPIDJSON_SSE42/RAPIDJSON_SIMD makrolarını etkinleştirmek CPU SIMD komutlarını kullanarak hızlandırmayı sağlar.
 */

#include <nlohmann/json.hpp>
#include <string>
#include <cstdint>

// Aracın snake_case alanlar ürettiğini varsayalım: user_name, created_at
// Gerçek projede camelCase olarak yeniden adlandırırken aşağıdaki makroları ekleyin
struct UserProfile {
    int64_t id;
    std::string userName;       // JSON'da "user_name"
    std::string emailAddress;   // JSON'da "email_address"
    std::string createdAt;      // JSON'da "created_at"
};

// Sınıf içinde eşleşmeyi bildirmek için NLOHMANN_DEFINE_TYPE_INTRUSIVE kullanın
// Not: public alana yerleştirilmelidir
// 
// NLOHMANN_DEFINE_TYPE_INTRUSIVE(UserProfile, id, userName, emailAddress, createdAt)

// Veya istilacı olmayan makroyu kullanın (sınıfın kendisini değiştirmeyi önler):
NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE(UserProfile, id, userName, emailAddress, createdAt)

// Kullanımı:
int main() {
    nlohmann::json j = {
        {"id", 1},
        {"user_name", "Alice"},
        {"email_address", "a****@***********"},
        {"created_at", "2026-07-14T10:00:00.000Z"}
    };

    UserProfile p = j.get<UserProfile>();
    // Serileştirme sırasında da orijinal alan adlarıyla çıktı verir
    std::cout << j.dump(2) << std::endl;
    return 0;
}

/*
 * İpuçları:
 *   ① İstilacı makro (NLOHMANN_DEFINE_TYPE_INTRUSIVE) public alana yerleştirilmelidir;
 *   ② İstilacı olmayan makro (NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE) sınıf dışında tanımlanır;
 *   ③ Alan sırası makro parametreleriyle kesinlikle aynı olmalıdır;
 *   ④ Tarih alanları ISO 8601 biçimini işlemek için nlohmann::json özel adl_serializer ile işlenebilir.
 */

Best Practices

Sık Sorulan Sorular

Sorun Giderme

Sözlük

struct / class

C++'da bileşik veri türlerini tanımlamak için kullanılan anahtar kelimeler. Bu araç struct üretir, örn. struct User { int64_t id; std::string name; }. C++'da struct ve class neredeyse eşdeğerdir (varsayılan erişim hakları farklıdır: struct üyeleri varsayılan olarak public, class üyeleri varsayılan olarak private), araç varsayılan olarak struct üretir. Deserializasyon senaryolarında struct kullanmak daha öz ve anlaşılırdır; özel üyeleri + erişimci yöntemleri kapsüllemek istiyorsanız manuel olarak class'a değiştirebilirsiniz.

std::string

C++ standart kütüphanesinin dize türü (sahiplik semantiği), <string> içinde tanımlıdır. Bu araç JSON dize alanlarını otomatik olarak std::string ile eşleştirir, örn. std::string name. std::string'in C dili char*/char[]'inden farklı olduğunu unutmayın: std::string belleği otomatik olarak yönetir, operatör aşırı yüklemesini destekler (+, ==, <), ancak yalnızca küçük ila orta uzunluktaki dizeleri işlerken en iyi performansı gösterir; çok uzun dizeler (1KB+ tüm günlük satırı gibi) için std::string_view veya özel bir buffer kullanılması önerilir.

std::vector<T>

C++ standart kütüphanesinin dinamik dizi kapsayıcısı (<vector>), Java'nın ArrayList'ine, Python'ın listesine, JavaScript'in Array'ine eşdeğerdir. Bu araç JSON dizi alanlarını otomatik olarak std::vector<T> ile eşleştirir, örn. std::vector<std::string> tags. Avantajları: sürekli bellek, rastgele erişim O(1), sona ekleme O(1) amortize; dezavantajları: ortaya ekleme O(n). Sabit boyutlu diziler gerektiğinde std::array<T, N> (yığında tahsis edilen) kullanılabilir.

std::optional<T>

C++17'den itibaren standart kütüphanenin isteğe bağlı değer sarma türü (<optional>), değerin var olmayabileceğini belirtir. Tipik kullanım: std::optional<std::string> nickname; if (nickname) { use(*nickname); }. Bu araç JSON'da null olabilecek alanları std::optional<T> ile eşleştirir, örn. std::optional<std::string> nickname. Projeniz C++11/14 kullanmak zorundaysa, API neredeyse aynı olan boost::optional<T> ile değiştirebilirsiniz.

int64_t / double

int64_t, <cstdint> içindeki sabit genişlikli 64-bit tamsayı türü takma adıdır, long long'a eşdeğerdir, platformlar arası 8 bayt garanti eder. double, C++'ın çift duyarlıklı kayan noktalı türüdür (IEEE 754 çift duyarlıklı/binary64, yaklaşık 15-17 anlamlı basamak). Bu araç JSON tamsayılarını tek tip olarak int64_t ile, kayan noktalı sayıları double ile eşleştirir, platformlar arası long boyut tutarsızlığından (Windows long 32 bit, Linux long 64 bittir) kaynaklanan hassasiyet sorunlarını önler. Hassas kayan noktalı sayılar (finansal hesaplamalar) gerektiğinde long double veya decimal kütüphanesi kullanılabilir.

nlohmann::json

C++ ekosistemindeki en popüler JSON kütüphanelerinden biridir, nlohmann/json olarak da bilinir, Alman Niels Lohmann tarafından yayınlanmıştır. Temel fikri, JSON veri yapılarını C++ standart kütüphane türleriyle (std::map, std::vector, std::string gibi) eşleştirmektir, deserializasyon sırasında j.get<T>() ile tek satırda yapılabilir. Bu araç tarafından üretilen kod, otomatik deserializasyon uygulamak için NLOHMANN_DEFINE_TYPE_INTRUSIVE, NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE gibi makroları kullanarak nlohmann/json ile çalışabilir. Tek header bağımlılığı, zengin belgeler, STL stiliyle uyumlu API, çoğu C++ projesi için tercih edilen seçimdir.

rapidjson

Tencent'in açık kaynaklı yüksek performanslı JSON kütüphanesi (C++), yaklaşık 5k satır kod, performansı nlohmann::json'dan yaklaşık 3-5 kat daha yüksektir. SAX (akış) ve DOM (belge nesne modeli) olmak üzere iki ayrıştırma stilini destekler, SIMD komutları (SSE42 gibi) için özel hızlandırma uygulamaları vardır. Tipik senaryolar: finansal işlem piyasa verisi iletimi, oyun motoru nesne serileştirmesi, gömülü yüksek performanslı günlükleme. Bu araç tarafından üretilen struct'lar, rapidjson Document/GenericValue deserializasyonu için hedef model olarak hizmet edebilir, ancak rapidjson şablon yansıtması olmadığından alanları GetObject/GetString ile manuel olarak çıkarmak gerekir.

Web Worker / quicktype-core

Web Worker, tarayıcının sağladığı arka plan iş parçacığı API'sidir, ana iş parçacığıyla paralel olarak çalışır, ana iş parçacığının DOM'una erişemez, yalnızca postMessage aracılığıyla iletişim kurabilir. quicktype-core, açık kaynaklı JSON → çok dilli kod üretici kütüphanesidir (GitHub: quicktype/quicktype), C++/Java/TypeScript/Rust/Go/Python/Swift gibi ondan fazla dili destekler. Bu araç, tarayıcıda yerel olarak quicktype-core tabanında C++ için header-only struct kodu üretir, ham veriler hiçbir sunucuya yüklenmez, tüm ayrıştırma, üretme ve indirme tarayıcıda yapılır. quicktype-core'u yükleyen Worker, UI ana iş parçacığını engellemeyi önler.

snake_case / camelCase / PascalCase

Üç ana alan adlandırma stili: snake_case (user_name, C/Python/DB için tercih edilir), camelCase (userName, Java/JS için tercih edilir), PascalCase (UserName, C#/Rust struct alanları için tercih edilir). Bu araç varsayılan olarak JSON orijinal alan adlarını korur (genellikle snake_case), ürettikten sonra manuel olarak ayarlayabilir ve eşleşmeyi bildirmek için NLOHMANN makroları ekleyebilirsiniz. C++ ortak alan adlandırma standardının camelCase veya snake_case önerdiğini, PascalCase'in esas olarak sınıf adları için kullanıldığını (Google C++ Stili), üyeler için önerilmediğini unutmayın; snake_case MySQL sütun adlarıyla doğal olarak uyumludur.

NLOHMANN_DEFINE_TYPE_INTRUSIVE

nlohmann/json kütüphanesi tarafından sağlanan, sınıf içinde JSON serileştirme alan eşleşmelerini bildirmek için kullanılan makro. Söz dizimi NLOHMANN_DEFINE_TYPE_INTRUSIVE(ClassName, member1, member2, ...) şeklindedir, public alana yerleştirilmelidir (makronun özel alanlara erişmesi için). Sınıf dışına yerleştirilen, sınıfın kendisini değiştirmeyi gerektirmeyen istilacı olmayan sürüm NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE'dir. Bu araç tarafından üretilen struct'lar bu tür makroları otomatik olarak eklemez, gerektiğinde JSON anahtarları ile C++ üyeleri arasındaki karşılığı bildirmek için manuel olarak ekleyin. JSON alan adları C++ üyeleriyle aynıysa, bu makroyu atlayabilir ve doğrudan j.get<T>() kullanabilirsiniz.

JSON Türlerinden C++ Türlerine Hızlı Eşleşme Tablosu

Araç, JSON değerinin türüne göre karşılık gelen C++ türünü otomatik olarak çıkarır:

Yaygın C++ JSON Ayrıştırıcı Seçim Karşılaştırma Tablosu

C++ ekosistemindeki ana akım JSON ayrıştırma kütüphanelerinin karşılaştırması, proje gereksinimlerine göre seçin:

C++ Standart Kütüphane Türlerinin JSON ile Uyumluluk Hızlı Tablosu

Geliştiricilerin hızlıca başvurması için JSON alanlarına karşılık gelen C++ standart kütüphanesindeki temel türlere genel bakış:

Privacy & Security

Bu JSON'dan C++'ya aracının tüm işlemleri tamamen tarayıcınızda yerel olarak gerçekleştirilir: JSON ayrıştırma, C++ struct üretme ve dosya indirme işlemlerinin tümü tarayıcı JavaScript (Web Worker + quicktype-core) aracılığıyla istemci tarafında yapılır, hiçbir JSON verisi, yüklenen dosya veya üretilen kod ağ üzerinden herhangi bir sunucuya gönderilmez. Dosya yükleme, tarayıcının yerel FileReader API'sini kullanarak doğrudan belleğe okur, herhangi bir aracı hizmetten geçmez. Çerez izleme kullanmaz, hiçbir kullanıcı girişi veya kullanım verisi toplamaz. Sayfayı kapattıktan veya yeniledikten sonra tüm giriş ve çıkış içerikleri otomatik olarak bellekten temizlenir. API anahtarları, token'lar, hassas iş verileri içeren JSON'ları işlemek için uygundur.

Authoritative References

• nlohmannnlohmann/json GitHub Deposu (nlohmann/json)
• cppreferencecppreference - std::optional
• cppreferencecppreference - std::vector
• TencentRapidJSON GitHub Deposu (Tencent)
• BoostBoost.JSON Resmi Belgeleri
• ISO C++ISO C++ Resmi Standardı - isocpp.org