1. BASE64編解碼簡介

Base64是網絡上最常見的用于傳輸8Bit字節碼的編碼方式之一，Base64就是一種基于64個可打印字符來表示二進制數據的方法。EASY EAI api封裝了BASE64編解碼工具，方便用戶對數據進行BASE64封裝。

2. 快速上手

2.1 開發環境準備

如果您初次閱讀此文檔，請閱讀《入門指南/開發環境準備/Easy-Eai編譯環境準備與更新》，并按照其相關的操作，進行編譯環境的部署。

在PC端Ubuntu系統中執行run腳本，進入EASY-EAI編譯環境，具體如下所示。

cd ~/develop_environment ./run.sh 2204

2.2 源碼下載以及例程編譯

在EASY-EAI編譯環境下創建存放源碼倉庫的管理目錄：

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

通過git工具，在管理目錄內克隆遠程倉庫

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

注：

* 此處可能會因網絡原因造成卡頓，請耐心等待。

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

進入到對應的例程目錄執行編譯操作，具體命令如下所示：

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

注：

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

2.3 例程運行

通過串口調試或ssh調試，進入板卡后臺，定位到例程部署的位置，如下所示：

cd /userdata/Demo/common-base64

運行例程命令如下所示：

./test-base64

2.4 運行效果

執行效果如下所示。

3. BASE64編解碼API說明

3.1 引用方式

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

API源代碼路徑為EASY-EAI-Toolkit-1126B/easyeai-api/common/base64/。用戶可通過源代碼了解接口實現，甚至可對源碼進行修改。

3.2 BASE64編碼操作

編碼函數原型如下所示。

int32_t base64_encode(char *out_data, const char* in_data, unsigned int in_len);

具體介紹如下所示。

3.3 BASE64解碼操作

解碼函數原型如下所示。

int32_t base64_decode(char *out_data, unsigned int out_len, const char* encoded_string);

具體介紹如下所示。

4. BASE64操作API案例

示例代碼路徑為EASY-EAI-Toolkit-1126B/Demos/common-base64/test-base64.c。

示例一，對字符串進行BASE64編碼，然后將得出的編碼數據再解碼。

char *cStr = "my name is hao"; char base64_data[1024] = {0}; char src_string[1024] = {0}; memset(base64_data, 0, sizeof(base64_data)); base64_encode(base64_data, cStr, strlen(cStr)); printf("encode data : %s\n", base64_data); base64_decode(src_string, sizeof(src_string), base64_data); printf("source string : %s\n", src_string)

示例二，驗證數據中有0x00，還原出來的數據不會在0x00處斷開。

char num_data[8] = {0x67, 0x88, 0x70, '\0', '\r', '\n', 0x73, 0x73}; char decode_data[8] = {0}; memset(base64_data, 0, sizeof(base64_data)); base64_encode(base64_data, num_data, sizeof(num_data)); printf("encode data : %s\n", base64_data); base64_decode(decode_data, sizeof(decode_data), base64_data); printf("source string : 0x%02x 0x%02x 0x%02x 0x%02x 0x%02x 0x%02x 0x%02x 0x%02x\n", decode_data[0], decode_data[1], decode_data[2], decode_data[3], decode_data[4], decode_data[5], decode_data[6], decode_data[7]);