# iniparse

**Repository Path**: wslcode/iniparse

## Basic Information

- **Project Name**: iniparse
- **Description**: C++/C语言序列化反序列化框架，支持结构体直接进行序列化，支持多层嵌套的复杂结构体,完全无任何依赖，基于C99开发，支持Windows/Linux/RTOS/等众多运行平台。支持主流的多编译器（GCC/MSVC/ARMCC/CLANG/IAR）
- **Primary Language**: C
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 10
- **Forks**: 8
- **Created**: 2021-06-02
- **Last Updated**: 2024-10-10

## Categories & Tags

**Categories**: utils

**Tags**: None

## README

# iniparse is whats?
* This is a C++/C structure serialize/deserialize framework, its use is very simple and efficient, does not add any mental burden.

---
# What are the typical features of iniparse
* Provide structure serialization and deserialization
* Provide alternative structure serialization to cjson/cjson deserialized to structure function
* Configurable memory management and algorithm implementation
* Provide structure runtime meta information for structure provides the basis
---
# contact
In use if you have any question, welcome to feedback to me


* 431159416@qq.com

---
# Configuration
Iniconfig.H is an empty file for the user, when users need to customize some implementation can modify this file


* INIJSON macro: ***default = = 1, cjson source code must be provided at this time (because the project depend it, otherwise please define INIJSON = 0)***
* INIPORTENABLE macro: default = = 0, for using iniparse built-in the implementation of the algorithm, when INIPORTENABLE!= 0 when the user must provide algorithm implementation

---
# Test

exp1:
    at iniparse.c::iniparse_test function is a very complicated comprehensive test cases.
	
exp2:
```exp2
	#include"iniparse.h"
	//define struct inimsg2
	#ifndef INIMSG2
		#define INIMSG2
		cfgdef(inimsg2,
	#else
		)
	#endif
	typedef struct {
		cstring info[16];//string type
		char x;
		char d[8];		//char array;
		ushort name;
		struct {
			int id;
			int key;
		}ids[2];
	}inimsg2;
	);
	
	//init msg
	inimsg2 msg = {
		.x = 2,
	},descmsg={0};
	msg.d[1] = 2;
	msg.ids[0].id = 1;
	
	//get inimsg2 runtine infos
	ini_list_type *dlist = inimake(inimsg2);
	//serialize msg
	char * buf = iniserialize_to_txt(dlist, &msg, ISF_REMOVE_ZERO);
	//ok ?
	if (buf != NULL)
	{
		//show
		printf("serialize:\r\n%s", buf);
		int len = strlen(buf);
		if (len > 0) {
			//deserialization
			len = inideserialize_from_txt(dlist, buf, &descmsg, sizeof(descmsg), NULL, ISF_LL_MARK_HIT);
			int c = memcmp(&msg, &descmsg, sizeof(descmsg));
			//show deserialization and msg is same
			printf("\r\ndeserialize result=%s , c = %d\r\n", c == 0 ? "success" : "failed", c);
		}
		inifree(buf);//free mem
	}
	inidel(dlist);//del runtine info
```