1. INI文件簡介

INI文件時Initialization File的縮寫，即初始化文件。INI文件是Windows系統(tǒng)常見的配置文件存儲格式，當(dāng)前也可作為Linux的配置文件。INI文件由節(jié)、鍵、值組成?！肮?jié)”的表達(dá)方式為[Section1 Name]，以中括號“[]”包圍起來，它用來表示一個段落的開始，因INI文件可能是整個項目共用的，所以需要使用“節(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. 快速上手

如果您初次閱讀此文檔，請閱讀：《入門指南/源碼管理及編程介紹/源碼工程管理》，按需管理自己工程源碼（注：此文檔必看，并建議采用【遠(yuǎn)程掛載管理】方式，否則有代碼丟失風(fēng)險?。。。?。

2.1 源碼工程下載

先在PC虛擬機定位到nfs服務(wù)目錄，再在目錄中創(chuàng)建存放源碼倉庫的管理目錄：

cd ~/nfsroot
mkdir GitHub
cd GitHub

再通過git工具，在管理目錄內(nèi)克隆遠(yuǎn)程倉庫（需要設(shè)備能對外網(wǎng)進(jìn)行訪問）

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

注：

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

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

2.2 開發(fā)環(huán)境搭建

通過adb shell進(jìn)入板卡開發(fā)環(huán)境，如下圖所示。

通過以下命令，把nfs目錄掛載上nfs服務(wù)器。

mount -t nfs -o nolock : /home/orin-nano/Desktop/nfs/

2.3 例程編譯

然后定位到nfs的掛載目錄，再在目錄中創(chuàng)建存放源碼倉庫的管理目錄：

cd /home/orin-nano/Desktop/nfs/GitHub

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

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

2.4 例程運行及效果

進(jìn)入Release目錄執(zhí)行下方命令，運行示例程序：

./Release/test-iniWrapper

執(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-3576/easyeai-api/common/ini/。用戶可通過源代碼了解接口實現(xiàn)，甚至可對源碼進(jìn)行修改。

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

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

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

具體介紹如下所示。

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);

具體介紹如下所示。

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

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

審核編輯 黃宇