C语言内存数组(zbuff)

一、ZBUFF(C 内存数组)简介

zbuff 库可以用 c 风格直接操作(下标从 0 开始)，例如 buff[0] = buff[3]

可以在 sram 上或者 psram 上申请空间，也可以自动申请(如存在 psram 则在 psram 进行申请,如不存在或失败则在 sram 进行申请)。

操作里面的元素时，可以根据光标进行增删改查。偏移方式有三种：从头、当前位置、末尾开始。常用参数如下：

常量	类型	解释
zbuff.SEEK_SET	number	以头为基点
zbuff.SEEK_CUR	number	以当前位置为基点
zbuff.SEEK_END	number	以末尾为基点
zbuff.HEAP_AUTO	number	自动申请(如存在 psram 则在 psram 进行申请,如不存在或失败则在 sram 进行申请)
zbuff.HEAP_SRAM	number	在 sram 申请
zbuff.HEAP_PSRAM	number	在 psram 申请

二、演示功能概述

本 demo 将演示 ZBUFF 的创建、写入数据、读取数据、获取 zbuff 长度、获取光标位置。

三、准备硬件环境

参考：硬件环境清单第二章节内容，准备以及组装好硬件环境。

四、软件环境

“凡事预则立，不预则废。”在详细阐述本功能示例之前，我们需先精心筹备好以下软件环境。

1. Luatools工具；

2. 内核固件文件（底层core固件文件）：LuatOS-SoC_V2002_Air780EP；参考项目使用的内核固件；

3. luatos需要的脚本和资源文件

脚本和资源文件点我,下载完整压缩文件包

lib脚本文件：使用Luatools烧录时，勾选添加默认lib 选项，使用默认lib脚本文件；

准备好软件环境之后，接下来查看如何烧录项目文件到Air780EP核心板，将本篇文章中演示使用的项目文件烧录到Air780EP核心板中。

zbuff-api地址

六、代码示例介绍

6.1 zbuff 操作示例

6.1.1 创建 zbuff，以 c 语言数组的形式操作 zbuff

local buff = zbuff.create(1024)
    -- 可当成数组直接赋值和取值
    buff[0] = 0xAE
    log.info("zbuff", "buff[0]", buff[0])

6.1.2 以 io 的形式操作

-- 写数据write, 操作之后指针会移动,跟文件句柄一样
    buff:write("123") -- 字符串
    buff:write(0x12, 0x13, 0x13, 0x33) -- 直接写数值也可以

    -- 设置指针位置, seek
    buff:seek(5, zbuff.SEEK_CUR) -- 指针位置+5
    -- 指针位置设置为0
    buff:seek(0)                 -- 绝对地址

    -- 读数据read, 指针也会移动
    -- 读取前三个字节，即"123"
    local data = buff:read(3)
    log.info("zbuff", "data", data)

6.1.3 清除 zbuff

-- 清除全部数据,但指针位置不变
    buff:clear() -- 默认填0
    buff:clear(0xA5) -- 也可以指定填充的内容

6.1.4 以 pack 库的形式写入或读取数据

-- 支持以pack库的形式写入或读取数据
    buff:seek(0)
    buff:pack(">IIHA", 0x1234, 0x4567, 0x12,"abcdefg")
    buff:seek(0)
    local cnt,a,b,c,s = buff:unpack(">IIHA10")

6.1.5 按类型读写数据

读取类型可为：I8、U8、I16、U16、I32、U32、I64、U64、F32、F64

读取的时候，记得注意下标位置。

-- 也可以直接按类型读写数据
    local len = buff:writeI8(10)
    local len = buff:writeU32(1024)
    local i8data = buff:readI8()
    local u32data = buff:readU32()

6.1.6 取出指定区间的数据

-- 取出指定区间的数据
    local fz = buff:toStr(0,5)

6.1.7 获取创建的 zbuff 的长度，和指针当前位置

-- 获取其长度
    log.info("zbuff", "len", buff:len())
    -- 获取其指针位置
    log.info("zbuff", "len", buff:used())

6.1.8 测试 F32（32 位单精度浮点数）类型数据的读写

-- 测试writeF32, 注意, EC618系列(Air780EP等), V1106会死机, 在V1107修复
    buff:seek(0, zbuff.SEEK_SET)
    buff:writeF32(1.2)
    buff:seek(0, zbuff.SEEK_SET)
    log.info("buff", "rw", "f32", buff:readF32())

七、功能验证

测试 zbuff 的使用

八、总结

本示例介绍了 zbuff 的作用和用法。

扩展

常见问题

1、先 buff:write(0x12)，再设置光标到正确位置后，使用 buff:read(1)读取不到数据。

直接读取是不可见字符，要使用 buff:read(1):toHex()读取数据。

给读者的话

本篇文章由Linden开发；

本篇文章描述的内容，如果有错误、细节缺失、细节不清晰或者其他任何问题，总之就是无法解决您遇到的问题；

请登录合宙技术交流论坛，点击文档找错赢奖金-Air780EP-LuatOS-软件指南-通用工具库-C语言内存数组(zbuff)；

用截图标注+文字描述的方式跟帖回复，记录清楚您发现的问题；

我们会迅速核实并且修改文档；

同时也会为您累计找错积分，您还可能赢取月度找错奖金！