MENU
  1. ホーム
  2. C 언어
  3. C 언어에서 문자열을 JSON 형식으로 파싱하는 방법

C 언어에서 문자열을 JSON 형식으로 파싱하는 방법

C 언어

C 언어에서 JSON 데이터를 다루는 기술은 네트워크 프로그래밍, 데이터 교환, 그리고 설정 파일 처리 등 다양한 분야에서 필수적입니다. 본 기사에서는 문자열 데이터를 JSON 형식으로 파싱하는 기초부터 주요 라이브러리 활용법, 예제 코드, 그리고 오류 해결 방안까지 차근차근 살펴보겠습니다. 이를 통해 JSON 데이터 파싱에 필요한 기본기를 다지고 실제 프로젝트에 적용할 수 있는 방법을 배울 수 있습니다.

목차

JSON과 문자열 파싱의 개념


JSON(JavaScript Object Notation)은 데이터를 키-값 쌍의 형태로 표현하는 경량 데이터 교환 형식입니다. 사람이 읽고 쓰기 쉽고, 기계가 분석하고 생성하기에도 용이하기 때문에 웹과 애플리케이션에서 널리 사용됩니다.

JSON의 구조


JSON 데이터는 객체와 배열로 구성됩니다. 객체는 중괄호 {}로 둘러싸여 있으며, 키-값 쌍으로 구성됩니다. 배열은 대괄호 []로 표현되고, 값의 목록으로 구성됩니다.

JSON 예제:

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

문자열 파싱의 정의


문자열 파싱이란 텍스트 데이터를 특정 형식으로 분석하고, 의미 있는 데이터로 변환하는 과정입니다. C 언어에서는 JSON과 같은 구조화된 데이터를 파싱하기 위해 라이브러리와 적절한 문자열 처리 기법이 필요합니다.

JSON과 문자열 파싱의 활용 사례

  • API 응답 처리: REST API에서 반환된 JSON 데이터를 처리해 유의미한 정보를 추출합니다.
  • 설정 파일 관리: 프로그램 설정을 JSON 형식으로 저장하고 로드합니다.
  • 데이터 교환: 클라이언트-서버 간 데이터 교환에 사용됩니다.

JSON과 문자열 파싱의 개념을 이해하는 것은 본격적으로 C 언어에서 이를 다루기 위한 중요한 첫걸음입니다.

C 언어로 JSON 데이터 다루기

C 언어는 저수준에서 강력한 성능을 제공하지만, JSON과 같은 구조화된 데이터를 다루기 위해서는 외부 라이브러리나 추가적인 코드 작성이 필요합니다. JSON 데이터를 처리하기 위해서는 다음과 같은 도구와 접근 방식을 활용할 수 있습니다.

JSON 파싱의 핵심 요소

  1. 문자열 처리: JSON 데이터는 문자열 형식으로 전송되므로 이를 처리하는 효율적인 방법이 필요합니다.
  2. JSON 라이브러리: C 언어는 기본적으로 JSON을 지원하지 않으므로 cJSON, Jansson 등과 같은 서드파티 라이브러리를 사용하는 것이 일반적입니다.

JSON 데이터 처리의 기본 단계

  1. JSON 문자열 읽기: 파일 또는 네트워크 응답에서 JSON 데이터를 읽어옵니다.
  2. 문자열을 JSON 객체로 변환: JSON 문자열을 파싱하여 키-값 쌍의 구조로 변환합니다.
  3. 데이터 처리: 필요한 데이터를 추출하거나 변환 작업을 수행합니다.
  4. 결과 출력 또는 저장: 처리된 데이터를 다시 JSON 형식으로 출력하거나 저장합니다.

활용 가능한 주요 라이브러리

  • cJSON: 경량의 JSON 라이브러리로, 직관적인 API를 제공합니다.
  • Jansson: 다양한 기능과 유연성을 제공하며, 대규모 프로젝트에 적합합니다.
  • JSON-C: JSON 데이터를 C 스타일로 다룰 수 있는 라이브러리입니다.

샘플 코드


다음은 cJSON을 사용해 JSON 문자열을 파싱하는 간단한 예제입니다:

#include <stdio.h>
#include <stdlib.h>
#include <cjson/cJSON.h>

int main() {
    const char *json_string = "{\"name\": \"Alice\", \"age\": 25}";
    cJSON *json = cJSON_Parse(json_string);

    if (json == NULL) {
        printf("Error parsing JSON\n");
        return 1;
    }

    const cJSON *name = cJSON_GetObjectItemCaseSensitive(json, "name");
    const cJSON *age = cJSON_GetObjectItemCaseSensitive(json, "age");

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

    cJSON_Delete(json);
    return 0;
}

이 코드는 JSON 문자열을 파싱하고, “name”과 “age” 키에 해당하는 값을 추출하여 출력합니다. JSON 데이터를 처리하기 위해 라이브러리의 주요 함수와 구조를 이해하는 것이 중요합니다.

JSON 파싱을 위한 라이브러리 선택

C 언어에서 JSON 데이터를 다루기 위해서는 적합한 JSON 파싱 라이브러리를 선택하는 것이 중요합니다. 주요 라이브러리의 특징과 장단점을 비교하여 적절한 선택을 할 수 있도록 안내합니다.

cJSON


cJSON은 경량의 JSON 라이브러리로, 간단한 JSON 파싱 작업에 적합합니다.

  • 장점:
  • 소형 라이브러리로 빌드가 간단합니다.
  • 직관적인 API를 제공하여 사용하기 쉽습니다.
  • JSON 객체를 생성, 수정, 삭제하는 기능 제공.
  • 단점:
  • 복잡한 JSON 데이터를 처리할 때는 유연성이 부족할 수 있습니다.

사용 예시:

cJSON *json = cJSON_Parse("{\"key\":\"value\"}");
const cJSON *key = cJSON_GetObjectItem(json, "key");

Jansson


Jansson은 고급 기능과 유연성을 갖춘 JSON 라이브러리로 대규모 프로젝트에서 유용합니다.

  • 장점:
  • 다양한 JSON 데이터 구조를 처리하는 데 적합합니다.
  • UTF-8 지원 및 에러 핸들링이 잘 설계되어 있습니다.
  • 객체와 배열의 반복(iteration)이 간편합니다.
  • 단점:
  • 설치와 초기 설정이 복잡할 수 있습니다.

사용 예시:

json_t *json = json_loads("{\"key\":\"value\"}", 0, NULL);
json_t *key = json_object_get(json, "key");

JSON-C


JSON-C는 C 스타일로 JSON 데이터를 다룰 수 있도록 설계된 라이브러리입니다.

  • 장점:
  • 기존 C 코드를 활용해 JSON 작업을 통합할 수 있습니다.
  • JSON 데이터의 직렬화 및 역직렬화가 용이합니다.
  • 단점:
  • 상대적으로 사용법이 복잡하며 문서화가 부족할 수 있습니다.

라이브러리 선택 가이드

  • 단순성과 성능이 중요한 경우: cJSON 추천
  • 복잡한 JSON 데이터 처리와 확장성이 필요한 경우: Jansson 추천
  • 기존 C 스타일 코드와 통합하려는 경우: JSON-C 추천

프로젝트의 특성과 JSON 데이터 구조에 따라 적절한 라이브러리를 선택하면 효율적인 JSON 파싱을 구현할 수 있습니다.

JSON 문자열의 기본 파싱 구조

JSON 데이터를 C 언어에서 다루기 위해서는 문자열을 JSON 객체로 변환하고 필요한 데이터를 추출하는 과정이 필요합니다. 이를 구현하기 위해 JSON 문자열 파싱의 기본 구조와 주요 단계를 설명합니다.

JSON 문자열 파싱의 단계

  1. JSON 문자열 입력
    JSON 데이터를 문자열로 입력받습니다. 입력은 파일, 네트워크 응답, 또는 하드코딩된 문자열일 수 있습니다.
  2. JSON 문자열 파싱
    JSON 문자열을 라이브러리를 사용하여 JSON 객체로 변환합니다.
  3. JSON 데이터 추출
    JSON 객체에서 필요한 데이터를 키를 통해 추출합니다.
  4. 메모리 해제
    사용이 끝난 JSON 객체의 메모리를 해제하여 리소스 누수를 방지합니다.

기본 구조의 예제 코드

#include <stdio.h>
#include <stdlib.h>
#include <cjson/cJSON.h>

int main() {
    // 1. JSON 문자열 정의
    const char *json_string = "{\"name\": \"Alice\", \"age\": 25, \"skills\": [\"C\", \"Python\"]}";

    // 2. JSON 문자열 파싱
    cJSON *json = cJSON_Parse(json_string);
    if (json == NULL) {
        printf("Error parsing JSON\n");
        return 1;
    }

    // 3. 데이터 추출
    const cJSON *name = cJSON_GetObjectItemCaseSensitive(json, "name");
    const cJSON *age = cJSON_GetObjectItemCaseSensitive(json, "age");
    const cJSON *skills = cJSON_GetObjectItemCaseSensitive(json, "skills");

    if (cJSON_IsString(name) && (name->valuestring != NULL)) {
        printf("Name: %s\n", name->valuestring);
    }
    if (cJSON_IsNumber(age)) {
        printf("Age: %d\n", age->valueint);
    }
    if (cJSON_IsArray(skills)) {
        printf("Skills: ");
        cJSON *skill;
        cJSON_ArrayForEach(skill, skills) {
            if (cJSON_IsString(skill)) {
                printf("%s ", skill->valuestring);
            }
        }
        printf("\n");
    }

    // 4. 메모리 해제
    cJSON_Delete(json);
    return 0;
}

코드 설명

  • cJSON_Parse: JSON 문자열을 JSON 객체로 변환합니다.
  • cJSON_GetObjectItemCaseSensitive: JSON 객체에서 특정 키에 해당하는 데이터를 가져옵니다.
  • cJSON_ArrayForEach: JSON 배열을 순회하며 각 요소를 처리합니다.
  • cJSON_Delete: JSON 객체를 삭제하고 메모리를 해제합니다.

출력 결과


위 코드는 다음과 같이 출력됩니다:

Name: Alice  
Age: 25  
Skills: C Python

이 기본 구조를 기반으로 JSON 데이터를 효율적으로 처리할 수 있습니다.

JSON 파싱 예제: 간단한 데이터 처리

이 섹션에서는 간단한 JSON 데이터를 처리하는 예제를 통해 C 언어에서 JSON 파싱 과정을 단계별로 설명합니다.

JSON 데이터


다음은 파싱할 JSON 데이터입니다:

{
  "product": "Laptop",
  "price": 999.99,
  "features": ["Lightweight", "Long battery life", "High performance"]
}

JSON 파싱 코드

#include <stdio.h>
#include <stdlib.h>
#include <cjson/cJSON.h>

int main() {
    // 1. JSON 문자열 정의
    const char *json_data = "{\"product\": \"Laptop\", \"price\": 999.99, \"features\": [\"Lightweight\", \"Long battery life\", \"High performance\"]}";

    // 2. JSON 파싱
    cJSON *json = cJSON_Parse(json_data);
    if (json == NULL) {
        printf("Error parsing JSON\n");
        return 1;
    }

    // 3. JSON 데이터 추출
    const cJSON *product = cJSON_GetObjectItemCaseSensitive(json, "product");
    const cJSON *price = cJSON_GetObjectItemCaseSensitive(json, "price");
    const cJSON *features = cJSON_GetObjectItemCaseSensitive(json, "features");

    if (cJSON_IsString(product) && (product->valuestring != NULL)) {
        printf("Product: %s\n", product->valuestring);
    }
    if (cJSON_IsNumber(price)) {
        printf("Price: %.2f\n", price->valuedouble);
    }
    if (cJSON_IsArray(features)) {
        printf("Features: ");
        cJSON *feature;
        cJSON_ArrayForEach(feature, features) {
            if (cJSON_IsString(feature)) {
                printf("%s, ", feature->valuestring);
            }
        }
        printf("\n");
    }

    // 4. 메모리 해제
    cJSON_Delete(json);
    return 0;
}

코드 설명

  1. JSON 문자열 정의: 파싱할 JSON 데이터를 문자열로 정의합니다.
  2. JSON 파싱: cJSON_Parse를 사용하여 JSON 문자열을 JSON 객체로 변환합니다.
  3. 데이터 추출:
  • cJSON_GetObjectItemCaseSensitive로 객체의 특정 키에 해당하는 값을 가져옵니다.
  • cJSON_ArrayForEach로 배열 데이터를 순회하며 각 항목을 처리합니다.
  1. 메모리 해제: 사용한 JSON 객체를 삭제하여 메모리 누수를 방지합니다.

실행 결과


위 코드를 실행하면 다음과 같은 결과가 출력됩니다:

Product: Laptop  
Price: 999.99  
Features: Lightweight, Long battery life, High performance,

응용


이 예제는 JSON 데이터를 파싱하고 필요한 데이터를 추출하는 기본적인 흐름을 보여줍니다. 이를 기반으로 더 복잡한 JSON 구조나 네트워크에서 받은 데이터를 처리할 수 있습니다.

JSON 파싱 과정은 JSON 데이터의 이해와 라이브러리의 활용법에 따라 쉽게 확장 가능합니다.

JSON 파싱 오류 해결하기

JSON 데이터를 파싱할 때는 입력 데이터의 구조, 라이브러리의 사용법, 메모리 관리 문제로 인해 오류가 발생할 수 있습니다. 이 섹션에서는 JSON 파싱 중 발생할 수 있는 일반적인 오류와 그 해결 방법을 설명합니다.

1. 잘못된 JSON 형식


JSON 데이터가 올바르지 않은 형식일 경우 파싱이 실패합니다.
문제 예시:

{ "name": "Alice", "age": 25, }  // 마지막 쉼표 오류

해결 방법:

  • JSON 데이터의 형식을 사전에 검증합니다.
  • 외부 JSON 검증 도구(예: JSONLint)를 사용하여 데이터를 확인합니다.

2. NULL 포인터 문제


JSON 파싱 라이브러리가 NULL을 반환할 수 있습니다.
문제 예시:

cJSON *json = cJSON_Parse(json_string);
if (json == NULL) {
    printf("Error: Invalid JSON\n");
}

해결 방법:

  • cJSON_Parse 호출 후 반환값을 항상 확인합니다.
  • NULL 포인터에 접근하지 않도록 코드에서 예외 처리를 추가합니다.

3. 키가 없는 경우


JSON 객체에서 요청한 키가 존재하지 않을 수 있습니다.
문제 예시:

cJSON *key = cJSON_GetObjectItem(json, "nonexistent");
if (key == NULL) {
    printf("Error: Key not found\n");
}

해결 방법:

  • cJSON_GetObjectItem의 반환값을 확인합니다.
  • 필요한 키가 모두 있는지 사전에 확인하거나, 기본값을 설정합니다.

4. JSON 배열 처리 오류


배열 데이터가 예상한 데이터 형식을 따르지 않을 경우 발생합니다.
문제 예시:

{ "numbers": [1, "two", 3] }  // 혼합 데이터 타입

해결 방법:

  • 배열의 각 요소를 반복적으로 검사하여 데이터 유형이 올바른지 확인합니다.
  • 예상하지 못한 데이터 유형에 대해 예외 처리를 추가합니다.

5. 메모리 누수


JSON 객체를 해제하지 않으면 메모리 누수가 발생합니다.
문제 예시:

cJSON *json = cJSON_Parse(json_string);
// cJSON_Delete(json); // 메모리 해제 누락

해결 방법:

  • cJSON_Delete를 호출하여 JSON 객체를 명시적으로 해제합니다.
  • 코드에서 리소스 누수가 발생하지 않도록 주기적으로 점검합니다.

6. 에러 메시지 디버깅


JSON 파싱 실패 원인을 파악하기 위해 에러 메시지를 출력합니다.
코드 예시:

const char *error = cJSON_GetErrorPtr();
if (error != NULL) {
    printf("JSON Error: %s\n", error);
}

요약


JSON 파싱 중 발생하는 오류를 사전에 방지하거나 발생 시 신속히 해결하려면, 올바른 데이터 검증, 철저한 예외 처리, 그리고 적절한 메모리 관리가 필수입니다. 이 과정을 통해 안정적인 JSON 데이터 처리가 가능합니다.

요약

C 언어에서 JSON 데이터를 처리하려면 문자열을 JSON 객체로 파싱하고 필요한 데이터를 추출하는 과정을 이해해야 합니다. 본 기사에서는 JSON과 문자열 파싱의 개념, C 언어에서의 JSON 데이터 다루기, 주요 라이브러리 선택 기준, 파싱 코드의 기본 구조, 예제 코드, 그리고 오류 해결 방법까지 단계별로 다뤘습니다.

JSON 파싱을 통해 데이터 교환 및 처리 작업을 효율적으로 수행할 수 있으며, 적절한 라이브러리와 코드를 활용하면 안정성과 확장성을 모두 확보할 수 있습니다. 이를 통해 실제 프로젝트에 JSON 데이터를 효과적으로 활용할 수 있습니다.

C 언어
C언어 JSON 문자열 파싱 프로그래밍
목차