3.0.0 • Published 1 year ago
simple-circular-buffer v3.0.0
simple-circular-buffer
A simple circular buffer implementation in Typescript. More information about a circular buffer can be found here.
Installation
npm install simple-circular-buffer
Usage
import { CircularBuffer } from 'simple-circular-buffer';
const buffer = new CircularBuffer<number>(3);
buffer.push(1);
const item = buffer.get(); // 1
buffer.push(2);
API
CircularBuffer<T>(size: number, allowOverwrite: boolean = false)
:
Creates a new circular buffer with the given size. Can optionally allow overwriting the oldest item when the buffer is full.
push(item: T): boolean
:
Pushes an item into the buffer. Returns true
if the item was successfully pushed, false
if the buffer is full and allowOverwrite
is false
.
get(): T | null
:
Returns the oldest item in the buffer, or null
if the buffer is empty.
clear(): void
:
Clears the buffer.
isEmpty(): boolean
:
Returns true
if the buffer is empty, false
otherwise.
isFull(): boolean
:
Returns true
if the buffer is full, false
otherwise.
capacity(): number
:
Returns the maximum number of items the buffer can hold.
size(): number
:
Returns the current number of items in the buffer.
License
MIT