1. INI文件簡介

INI文件時(shí)Initialization File的縮寫，即初始化文件。INI文件是Windows系統(tǒng)常見的配置文件存儲(chǔ)格式，當(dāng)前也可作為Linux的配置文件。INI文件由節(jié)、鍵、值組成?！肮?jié)”的表達(dá)方式為[Section1 Name]，以中括號“[]”包圍起來，它用來表示一個(gè)段落的開始，因INI文件可能是整個(gè)項(xiàng)目共用的，所以需要使用“節(jié)”來區(qū)分不同用途的參數(shù)區(qū)?！版I”與“值”的組合表達(dá)方式為KeyName=value，以等號“=”分隔。INI文件注釋以分號“;”表示，在分號后面的文字直到該行結(jié)尾全部作為注解。例程如下所示，注意value值只有int型和string型。

; comment textINI文件的數(shù)據(jù)格式的例子（配置文件的內(nèi)容） [Section1 Name] KeyName1=value1 KeyName2=value2 ... [Section2 Name] KeyName21=value21 KeyName22=value22

2. 快速上手

2.1 開發(fā)環(huán)境準(zhǔn)備

如果您初次閱讀此文檔，請閱讀《入門指南/開發(fā)環(huán)境準(zhǔn)備/Easy-Eai編譯環(huán)境準(zhǔn)備與更新》，并按照其相關(guān)的操作，進(jìn)行編譯環(huán)境的部署。

在PC端Ubuntu系統(tǒng)中執(zhí)行run腳本，進(jìn)入EASY-EAI編譯環(huán)境，具體如下所示。

cd ~/develop_environment ./run.sh 2204

2.2 源碼下載以及例程編譯

在EASY-EAI編譯環(huán)境下創(chuàng)建存放源碼倉庫的管理目錄：

cd /opt mkdir EASY-EAI-Toolkit cd EASY-EAI-Toolkit

通過git工具，在管理目錄內(nèi)克隆遠(yuǎn)程倉庫

git clone https://github.com/EASY-EAI/EASY-EAI-Toolkit-1126B.git

注：

* 此處可能會(huì)因網(wǎng)絡(luò)原因造成卡頓，請耐心等待。

* 如果實(shí)在要在gitHub網(wǎng)頁上下載，也要把整個(gè)倉庫下載下來，不能單獨(dú)下載本實(shí)例對應(yīng)的目錄。

進(jìn)入到對應(yīng)的例程目錄執(zhí)行編譯操作，具體命令如下所示：

cd EASY-EAI-Toolkit-1126B/Demos/common-ini/ ./build.sh

注：

* 由于依賴庫部署在板卡上，因此交叉編譯過程中必須保持/mnt掛載。

2.3 例程運(yùn)行

通過串口調(diào)試或ssh調(diào)試，進(jìn)入板卡后臺(tái)，定位到例程部署的位置，如下所示：

cd /userdata/Demo/common-ini

運(yùn)行例程命令如下所示：

./test-iniWrapper

2.4 運(yùn)行效果

執(zhí)行效果如下所示。

API的詳細(xì)說明，以及API的調(diào)用（本例程源碼），詳細(xì)信息見下方說明。

3. INI文件API說明

3.1 引用方式

EASY EAI api庫位于本倉庫的easyeai-api目錄中。為方便客戶在本地工程中直接調(diào)用我們的EASY EAI api庫，此處列出工程中需要鏈接的庫以及頭文件等，方便用戶直接添加。

API源代碼路徑為EASY-EAI-Toolkit-1126B/easyeai-api/common/ini/。用戶可通過源代碼了解接口實(shí)現(xiàn)，甚至可對源碼進(jìn)行修改。

3.2 INI讀取整型數(shù)據(jù)

函數(shù)原型如下所示。

int32_t ini_read_int(const char *file, const char *pcSection, const char *pcKey, int *pVal);

具體介紹如下所示。

3.3 INI寫入整型數(shù)據(jù)

函數(shù)原型如下所示。

int32_t ini_write_int(const char *file, const char *pcSection, const char *pcKey, int Val);

具體介紹如下所示。

3.4 INI讀取字符串?dāng)?shù)據(jù)

函數(shù)原型如下所示。

int32_t ini_read_string(const char *file, const char *pcSection, const char *pcKey, char *pcStr, int len);

具體介紹如下所示。

3.5 INI寫入字符串?dāng)?shù)據(jù)

函數(shù)原型如下所示。

int32_t ini_write_string(const char *file, const char *pcSection, const char *pcKey, const char *pcStr);

具體介紹如下所示。

4. INI文件操作函數(shù)使用案例

使用代碼為EASY-EAI-Toolkit-1126B/Demos/common-ini/test-iniWrapper.c，程序邏輯如下所示。