72 lines
1.6 KiB
Plaintext
72 lines
1.6 KiB
Plaintext
|
/**
|
||
|
|
* Copyright (c) Meta Platforms, Inc. and affiliates.
|
||
|
|
*
|
||
|
|
* This source code is licensed under the MIT license found in the
|
||
|
|
* LICENSE file in the root directory of this source tree.
|
||
|
|
*
|
||
|
|
* @flow strict
|
||
|
|
* @format
|
||
|
|
*/
|
||
|
|
|
||
|
|
function assertArrayBounds<T>(array: $ReadOnlyArray<T>, index: number): void {
|
||
|
|
if (index < 0 || index >= array.length) {
|
||
|
|
throw new Error(
|
||
|
|
`Invalid Mutation: Tried to mutate an elements array with an out of bounds index. Index: ${index}, Array Size: ${array.length}`,
|
||
|
|
);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
export function arrayIsEqual(
|
||
|
|
a1: $ReadOnlyArray<mixed>,
|
||
|
|
a2: $ReadOnlyArray<mixed>,
|
||
|
|
): boolean {
|
||
|
|
if (a1 === a2) {
|
||
|
|
return true;
|
||
|
|
}
|
||
|
|
|
||
|
|
if (a1.length !== a2.length) {
|
||
|
|
return false;
|
||
|
|
}
|
||
|
|
|
||
|
|
for (let i = 0; i < a1.length; i++) {
|
||
|
|
if (a1[i] !== a2[i]) {
|
||
|
|
return false;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
return true;
|
||
|
|
}
|
||
|
|
|
||
|
|
export function insertInArray<T>(
|
||
|
|
array: $ReadOnlyArray<T>,
|
||
|
|
index: number,
|
||
|
|
elements: $ReadOnlyArray<T>,
|
||
|
|
): Array<T> {
|
||
|
|
if (index === array.length) {
|
||
|
|
// Support the insert at end of array case.
|
||
|
|
return array.concat(elements);
|
||
|
|
}
|
||
|
|
assertArrayBounds(array, index);
|
||
|
|
return array.slice(0, index).concat(elements).concat(array.slice(index));
|
||
|
|
}
|
||
|
|
|
||
|
|
export function removeFromArray<T>(
|
||
|
|
array: $ReadOnlyArray<T>,
|
||
|
|
index: number,
|
||
|
|
): Array<T> {
|
||
|
|
assertArrayBounds(array, index);
|
||
|
|
return [...array.slice(0, index), ...array.slice(index + 1)];
|
||
|
|
}
|
||
|
|
|
||
|
|
export function replaceInArray<T>(
|
||
|
|
array: $ReadOnlyArray<T>,
|
||
|
|
index: number,
|
||
|
|
elements: $ReadOnlyArray<T>,
|
||
|
|
): Array<T> {
|
||
|
|
assertArrayBounds(array, index);
|
||
|
|
return array
|
||
|
|
.slice(0, index)
|
||
|
|
.concat(elements)
|
||
|
|
.concat(array.slice(index + 1));
|
||
|
|
}
|