X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=src%2Futils%2FCircularArray.ts;h=f84b21aa3ac9d93a19075b8db1a2f889e05bdfa9;hb=452a4864d4a8d0286ddd351958d8cc02574b4ba9;hp=ba3eba19231ab7b7dff4eef88e27461ecc29c7f5;hpb=d0641efac20e7bc7c114a3183574b6cad8667733;p=e-mobility-charging-stations-simulator.git diff --git a/src/utils/CircularArray.ts b/src/utils/CircularArray.ts index ba3eba19..f84b21aa 100644 --- a/src/utils/CircularArray.ts +++ b/src/utils/CircularArray.ts @@ -1,36 +1,96 @@ +// Copyright Jerome Benoit. 2021-2024. All Rights Reserved. -export default class CircularArray extends Array { - public size: number; - private readonly maximumCircularArraySize = 2000; +export const DEFAULT_CIRCULAR_ARRAY_SIZE = 1024 - constructor(size?: number) { - super(); - this.size = size && size <= this.maximumCircularArraySize ? size : this.maximumCircularArraySize; +/** + * Array with a maximum length and shifting items when full. + */ +export class CircularArray extends Array { + public size: number + + constructor (size: number = DEFAULT_CIRCULAR_ARRAY_SIZE, ...items: T[]) { + super() + this.checkSize(size) + this.size = size + if (arguments.length > 1) { + this.push(...items) + } + } + + public push (...items: T[]): number { + const length = super.push(...items) + if (length > this.size) { + super.splice(0, length - this.size) + } + return this.length + } + + public unshift (...items: T[]): number { + const length = super.unshift(...items) + if (length > this.size) { + super.splice(this.size, items.length) + } + return this.length } - push(...items: T[]): number { - if (this.length + items.length > this.size) { - super.splice(0, (this.length + items.length) - this.size); + public concat (...items: Array>): CircularArray { + const concatenatedCircularArray = super.concat(items as T[]) as CircularArray + concatenatedCircularArray.size = this.size + if (concatenatedCircularArray.length > concatenatedCircularArray.size) { + concatenatedCircularArray.splice( + 0, + concatenatedCircularArray.length - concatenatedCircularArray.size + ) } - return super.push(...items); + return concatenatedCircularArray } - unshift(...items: T[]): number { - if (this.length + items.length > this.size) { - super.splice(this.size - items.length, (this.length + items.length) - this.size); + public splice (start: number, deleteCount?: number, ...items: T[]): CircularArray { + let itemsRemoved: T[] = [] + if (arguments.length >= 3 && deleteCount != null) { + itemsRemoved = super.splice(start, deleteCount, ...items) + if (this.length > this.size) { + const itemsOverflowing = super.splice(0, this.length - this.size) + itemsRemoved = new CircularArray( + itemsRemoved.length + itemsOverflowing.length, + ...itemsRemoved, + ...itemsOverflowing + ) + } + } else if (arguments.length === 2) { + itemsRemoved = super.splice(start, deleteCount) + } else { + itemsRemoved = super.splice(start) } - return super.unshift(...items); + return itemsRemoved as CircularArray } - concat(...items: (T | ConcatArray)[]): T[] { - if (this.length + items.length > this.size) { - super.splice(0, (this.length + items.length) - this.size); + public resize (size: number): void { + this.checkSize(size) + if (size === 0) { + this.length = 0 + } else if (size < this.size) { + for (let i = size; i < this.size; i++) { + super.pop() + } } - return super.concat(items as T[]); + this.size = size + } + + public empty (): boolean { + return this.length === 0 } - splice(start: number, deleteCount?: number, ...items: T[]): T[] { - this.push(...items); - return super.splice(start, deleteCount); + public full (): boolean { + return this.length === this.size + } + + private checkSize (size: number): void { + if (!Number.isSafeInteger(size)) { + throw new TypeError(`Invalid circular array size: ${size} is not a safe integer`) + } + if (size < 0) { + throw new RangeError(`Invalid circular array size: ${size} < 0`) + } } }