Ringbud NPM | npm.io

RingBud: Zero-Dependency, High-Performance RingBuffer Library

Introduction
Installation
Features
- New: Clamping
Usage
- Basic Usage
- Advanced Features
Memory Management
- Memory Preallocation
- Clamping for Large Buffers
Extensibility with Typed Arrays
Zero Dependencies
Package Size
License

Introduction

RingBud is a high-performance, TypeScript-based RingBuffer library engineered for efficient data storage and retrieval. The API is designed to be both user-friendly and versatile, allowing fine-grained control over buffer operations.

Installation

To install RingBud, you can use npm:

npm install ringbud

Or yarn:

yarn add ringbud

Features

Type-Safe: Fully written in TypeScript for robust type safety.
Memory-Efficient: Features like preallocation and clamping optimize memory usage.
Customizable: Adjustable frame size to fit diverse application requirements.
High-Speed Read/Write: Employs optimized algorithms for rapid data access.
Zero Dependencies: Completely standalone with no external dependencies.
Lightweight: A minuscule package footprint for efficient deployment.

New: Clamping

The library now includes a clamping feature, enabled by default. When clamping is enabled, the remaining bytes in the buffer are moved to the beginning after each read operation. This avoids the need for resizing the buffer for new data, thereby optimizing memory usage. The trade-off is that the buffer is copied upon each read operation.

Usage

Basic Usage

Here's a quick example to get started:

import { RingBufferF32 } from "ringbud";

const frameSize = 128;
const buffer = new RingBufferF32(frameSize);

// Write data into the buffer
const data = new Float32Array([1.1, 2.2, 3.3]);
buffer.write(data);

// Read data from the buffer
const readData = buffer.read();

Advanced Features

Drain all available data from the buffer:

const allData = buffer.drain();

Memory Management

Memory Preallocation

RingBud preallocates memory based on your specified frame size, offering significant performance benefits by reducing the overhead of dynamic memory allocation.

Clamping for Large Buffers

With the new clamping feature, RingBud can handle large buffers efficiently without resizing the memory, albeit at the cost of copying the buffer during each read operation.

Extensibility with Typed Arrays

RingBud supports a broad spectrum of Typed Arrays, including Float32Array, Int16Array, Int32Array, Uint8Array, Uint16Array, Uint32Array, and Uint8ClampedArray, providing unparalleled flexibility for different data storage needs.