1. INI文件簡(jiǎn)介

INI文件時(shí)Initialization File的縮寫(xiě)，即初始化文件。INI文件是Windows系統(tǒng)常見(jiàn)的配置文件存儲(chǔ)格式，當(dāng)前也可作為Linux的配置文件。INI文件由節(jié)、鍵、值組成?！肮?jié)”的表達(dá)方式為[Section1 Name]，以中括號(hào)“[]”包圍起來(lái)，它用來(lái)表示一個(gè)段落的開(kāi)始，因INI文件可能是整個(gè)項(xiàng)目共用的，所以需要使用“節(jié)”來(lái)區(qū)分不同用途的參數(shù)區(qū)?！版I”與“值”的組合表達(dá)方式為KeyName=value，以等號(hào)“=”分隔。INI文件注釋以分號(hào)“;”表示，在分號(hào)后面的文字直到該行結(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 開(kāi)發(fā)環(huán)境準(zhǔn)備

如果您初次閱讀此文檔，請(qǐng)閱讀《入門(mén)指南/開(kāi)發(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)建存放源碼倉(cāng)庫(kù)的管理目錄：

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

通過(guò)git工具，在管理目錄內(nèi)克隆遠(yuǎn)程倉(cāng)庫(kù)

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

注：

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

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

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

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

注：

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

2.3 例程運(yùn)行

通過(guò)串口調(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ì)說(shuō)明，以及API的調(diào)用（本例程源碼），詳細(xì)信息見(jiàn)下方說(shuō)明。

3. INI文件API說(shuō)明

3.1 引用方式

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

API源代碼路徑為EASY-EAI-Toolkit-1126B/easyeai-api/common/ini/。用戶可通過(guò)源代碼了解接口實(shí)現(xiàn)，甚至可對(duì)源碼進(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寫(xiě)入整型數(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寫(xiě)入字符串?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，程序邏輯如下所示。