#api-calls #buffer #winapi #growable #api #string

grob

适用于Windows API调用的可增长缓冲区

4个版本

0.1.3 2024年3月7日
0.1.2 2024年2月13日
0.1.1 2023年5月27日
0.1.0 2023年5月26日

#64Windows API

Apache-2.0 OR MIT

100KB
906

简介

欢迎使用grob包!

grob是可增长缓冲区的缩写。

许多Windows API函数要求调用者提供缓冲区。模式大致如下...

  • 使用初始缓冲区和大小调用函数
  • 如果成功,则处理返回的数据
  • 如果因为缓冲区太小而失败,则创建更大的缓冲区并重试
  • 如果因其他原因失败,则处理错误

关于可增长缓冲区有很多示例,包括Rust标准库中的一个版本。所有示例之间缺乏一致性。有些版本无限期地尝试。有些版本尝试任意次数,例如三次,然后放弃。有些版本将新缓冲区的大小加倍。有些版本通过固定数量(如128字节)增加大小。即使是微软的API示例也不一致。

此包的目标是提供一个单一的、高质量的、任何Rust开发者都可以轻松使用的可增长缓冲区。

许可证

grob 根据MIT许可证和Apache许可证(版本2.0)的条款分发。

有关详细信息,请参阅 LICENSE-APACHELICENSE-MIT

构建状态

Clippy Examples Miri Test

依赖项

~0–38MB
~521K SLoC