Repolode
nlohmann

nlohmann/json

C++ 코드에서 STL과 비슷한 문법으로 JSON을 파싱하고 생성·조작·직렬화할 수 있는 헤더 전용 C++11 라이브러리입니다.

스타
50,790
포크
7,511
열린 이슈
19
마지막 커밋
4시간 전

어떤 프로젝트인가요?

JSON for Modern C++는 JSON 값을 기본 데이터 타입처럼 다룰 수 있게 해 주는 C++ 라이브러리입니다. JSON 값은 단일 클래스인 basic_json(nlohmann::json으로 별칭 지정)으로 표현되며, 리터럴, STL 컨테이너 또는 사용자 정의 타입으로 생성하고 연산자와 익숙한 컨테이너 메서드로 접근할 수 있습니다.

라이브러리 전체가 단일 헤더 파일로 배포되므로 별도의 빌드 단계나 의존성 없이 프로젝트에 추가할 수 있습니다. JSON Pointer(RFC 6901), JSON Patch(RFC 6902), JSON Merge Patch(RFC 7396)를 지원하며 diff 생성 기능도 포함합니다. 또한 BSON, CBOR, MessagePack, UBJSON, BJData, BON8 등의 여러 바이너리 형식과 상호 변환할 수 있습니다.

to_json 및 from_json 함수를 사용하거나 함수를 생성하는 헬퍼 매크로를 통해 사용자 정의 타입을 JSON에 매핑할 수 있습니다. 프로젝트는 문서와 API 레퍼런스를 제공하며, CMake 및 일반적인 패키지 관리자와의 통합 방법도 안내합니다.

핵심 기능

  • 01의존성이 없는 단일 헤더 방식으로 통합할 수 있으며 C++11로 작성되었습니다.
  • 02JSON 값을 직관적이고 STL과 비슷한 문법으로 접근하고 대입할 수 있습니다.
  • 03문자열, 스트림, 반복자 범위에서 파싱할 수 있고 들여쓰기를 적용해 직렬화할 수 있습니다.
  • 04diff 생성을 포함해 JSON Pointer, JSON Patch, JSON Merge Patch를 지원합니다.
  • 05CBOR, MessagePack, BSON, UBJSON 등의 바이너리 형식과 상호 변환할 수 있습니다.
  • 06매크로와 변환 함수를 사용해 사용자 정의 C++ 타입을 JSON에 매핑할 수 있습니다.

활용 사례

  • C++ 애플리케이션에서 설정 파일이나 API 페이로드를 읽습니다.
  • C++ 데이터 구조를 바탕으로 JSON 응답이나 메시지를 생성합니다.
  • 문서 버전 간 JSON 패치를 계산하고 적용합니다.
  • 저장하거나 전송할 C++ 구조체를 JSON 또는 바이너리 형식으로 직렬화합니다.

빠른 시작

  1. 1

    저장소의 헤더 파일 json.hpp 하나를 프로젝트에 추가하거나 패키지 관리자를 통해 설치하세요

  2. 2

    C++ 코드에 #include <nlohmann/json.hpp>를 포함하고 json 타입을 사용하기 시작하세요

사용 전 알아둘 점

  • README에 더 빠른 JSON 라이브러리가 있다고 명시되어 있으므로, 이 라이브러리는 속도보다 사용 편의성을 우선합니다.

토픽

자주 묻는 질문

json은(는) 무엇인가요?
C++ 코드에서 STL과 비슷한 문법으로 JSON을 파싱하고 생성·조작·직렬화할 수 있는 헤더 전용 C++11 라이브러리입니다. JSON for Modern C++는 JSON 값을 기본 데이터 타입처럼 다룰 수 있게 해 주는 C++ 라이브러리입니다. JSON 값은 단일 클래스인 basic_json(nlohmann::json으로 별칭 지정)으로 표현되며, 리터럴, STL 컨테이너 또는 사용자 정의 타입으로 생성하고 연산자와 익숙한 컨테이너 메서드로 접근할 수 있습니다.
json은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
json은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
json은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. json의 마지막 커밋은 2026년 10월 21일입니다.
json은(는) 어디에 사용할 수 있나요?
C++ 애플리케이션에서 설정 파일이나 API 페이로드를 읽습니다. C++ 데이터 구조를 바탕으로 JSON 응답이나 메시지를 생성합니다. 문서 버전 간 JSON 패치를 계산하고 적용합니다. 저장하거나 전송할 C++ 구조체를 JSON 또는 바이너리 형식으로 직렬화합니다.
json는 어떻게 설치하나요?
저장소의 헤더 파일 json.hpp 하나를 프로젝트에 추가하거나 패키지 관리자를 통해 설치하세요 C++ 코드에 #include <nlohmann/json.hpp>를 포함하고 json 타입을 사용하기 시작하세요
json은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/nlohmann/json

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트