31 lines
827 B
TypeScript
31 lines
827 B
TypeScript
|
//#region src/compat/array/concat.d.ts
|
||
|
|
/**
|
||
|
|
* Concatenates multiple arrays and values into a single array.
|
||
|
|
*
|
||
|
|
* @template T The type of elements in the array.
|
||
|
|
* @param {...(T | T[])} values - The values and/or arrays to concatenate.
|
||
|
|
* @returns {T[]} A new array containing all the input values.
|
||
|
|
*
|
||
|
|
* @example
|
||
|
|
* // Concatenate individual values
|
||
|
|
* concat(1, 2, 3);
|
||
|
|
* // returns [1, 2, 3]
|
||
|
|
*
|
||
|
|
* @example
|
||
|
|
* // Concatenate arrays of values
|
||
|
|
* concat([1, 2], [3, 4]);
|
||
|
|
* // returns [1, 2, 3, 4]
|
||
|
|
*
|
||
|
|
* @example
|
||
|
|
* // Concatenate a mix of individual values and arrays
|
||
|
|
* concat(1, [2, 3], 4);
|
||
|
|
* // returns [1, 2, 3, 4]
|
||
|
|
*
|
||
|
|
* @example
|
||
|
|
* // Concatenate nested arrays
|
||
|
|
* concat([1, [2, 3]], 4);
|
||
|
|
* // returns [1, [2, 3], 4]
|
||
|
|
*/
|
||
|
|
declare function concat<T>(...values: Array<T | readonly T[]>): T[];
|
||
|
|
//#endregion
|
||
|
|
export { concat };
|