AWTK项目中的FScript写缓冲(wbuffer)扩展详解-优快云博客

AWTK项目中的FScript写缓冲(wbuffer)扩展详解

awtk AWTK = Toolkit AnyWhere(a cross-platform embedded GUI) 项目地址: https://gitcode.com/gh_mirrors/aw/awtk

概述

在AWTK项目的FScript脚本语言中，wbuffer(写缓冲)扩展提供了一套强大的二进制数据操作功能。本文将全面介绍wbuffer的核心概念、使用方法以及实际应用场景，帮助开发者掌握这一重要工具。

wbuffer基础概念

wbuffer是FScript中用于处理二进制数据的缓冲区对象，具有以下核心属性：

data：指向实际存储数据的指针
cursor：当前写入位置指示器
capacity：缓冲区的最大容量

这种设计使得wbuffer非常适合处理各种二进制协议、文件格式等需要精确控制字节流的场景。

wbuffer创建与初始化

创建空缓冲区

使用wbuffer_create()函数可以创建一个空的wbuffer对象：

var buffer = wbuffer_create()

此时缓冲区初始为空，容量会根据后续写入操作自动扩展。

附加到现有数据

wbuffer_attach()函数允许我们将wbuffer附加到已有数据上，支持多种形式：

// 附加到字符串
var buf1 = wbuffer_attach("hello")

// 附加到二进制数据
var buf2 = wbuffer_attach(binary_data)

// 指定数据和大小
var buf3 = wbuffer_attach(data_ptr, data_size)

这种方式非常适合对现有数据进行修改或解析。

基本操作函数

跳过数据

wbuffer_skip()函数可以将写入指针向后移动指定字节数：

var buf = wbuffer_attach("hello")
wbuffer_skip(buf, 2)  // 跳过前2个字节

重置指针

wbuffer_rewind()函数将写入指针重置到缓冲区起始位置：

var buf = wbuffer_attach("hello")
wbuffer_skip(buf, 3)
wbuffer_rewind(buf)  // 指针回到位置0

数据类型写入操作

wbuffer提供了一系列函数用于写入不同类型的数据，每种函数都会返回实际写入的字节数。

整数类型写入

支持从8位到64位的无符号和有符号整数：

// 无符号整数
wbuffer_write_uint8(buf, 0x10)
wbuffer_write_uint16(buf, 0x1122)
wbuffer_write_uint32(buf, 0x11223344)
wbuffer_write_uint64(buf, 0x1122334455667788)

// 有符号整数
wbuffer_write_int8(buf, -10)
wbuffer_write_int16(buf, -1122)
wbuffer_write_int32(buf, -11223344)
wbuffer_write_int64(buf, -1122334455667788)

浮点数类型写入

支持单精度(float)和双精度(double)浮点数：

wbuffer_write_float(buf, 3.14)
wbuffer_write_double(buf, 3.1415926535)

字符串和二进制数据

// 写入字符串(会自动包含长度信息)
wbuffer_write_string(buf, "hello")

// 写入原始二进制数据
wbuffer_write_binary(buf, binary_data, data_length)

信息获取函数

获取缓冲区信息

// 获取数据指针
var data_ptr = wbuffer_get_data(buf)

// 获取当前写入位置
var pos = wbuffer_get_cursor(buf)

// 获取缓冲区容量
var cap = wbuffer_get_capacity(buf)

综合应用示例

下面是一个完整的示例，展示如何使用wbuffer进行各种数据类型的写入：

// 创建缓冲区
var buf = wbuffer_create()

// 写入各种类型数据
wbuffer_write_int8(buf, -10)
wbuffer_write_int16(buf, -1122)
wbuffer_write_int32(buf, -11223344)
wbuffer_write_int64(buf, -1122334455667788)

// 写入字符串和二进制数据
wbuffer_write_string(buf, "hello")
wbuffer_write_binary(buf, "world", 6)

// 验证写入位置
assert(wbuffer_get_cursor(buf) == 27)