123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924 |
- /*! *****************************************************************************
- Copyright (c) Microsoft Corporation. All rights reserved.
- Licensed under the Apache License, Version 2.0 (the "License"); you may not use
- this file except in compliance with the License. You may obtain a copy of the
- License at http://www.apache.org/licenses/LICENSE-2.0
- THIS CODE IS PROVIDED ON AN *AS IS* BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- KIND, EITHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY IMPLIED
- WARRANTIES OR CONDITIONS OF TITLE, FITNESS FOR A PARTICULAR PURPOSE,
- MERCHANTABLITY OR NON-INFRINGEMENT.
- See the Apache Version 2.0 License for specific language governing permissions
- and limitations under the License.
- ***************************************************************************** */
- /// <reference no-default-lib="true"/>
- interface Array<T> {
- /**
- * Returns the value of the last element in the array where predicate is true, and undefined
- * otherwise.
- * @param predicate findLast calls predicate once for each element of the array, in descending
- * order, until it finds one where predicate returns true. If such an element is found, findLast
- * immediately returns that element value. Otherwise, findLast returns undefined.
- * @param thisArg If provided, it will be used as the this value for each invocation of
- * predicate. If it is not provided, undefined is used instead.
- */
- findLast<S extends T>(predicate: (value: T, index: number, array: T[]) => value is S, thisArg?: any): S | undefined;
- findLast(predicate: (value: T, index: number, array: T[]) => unknown, thisArg?: any): T | undefined;
- /**
- * Returns the index of the last element in the array where predicate is true, and -1
- * otherwise.
- * @param predicate findLastIndex calls predicate once for each element of the array, in descending
- * order, until it finds one where predicate returns true. If such an element is found,
- * findLastIndex immediately returns that element index. Otherwise, findLastIndex returns -1.
- * @param thisArg If provided, it will be used as the this value for each invocation of
- * predicate. If it is not provided, undefined is used instead.
- */
- findLastIndex(predicate: (value: T, index: number, array: T[]) => unknown, thisArg?: any): number;
- /**
- * Returns a copy of an array with its elements reversed.
- */
- toReversed(): T[];
- /**
- * Returns a copy of an array with its elements sorted.
- * @param compareFn Function used to determine the order of the elements. It is expected to return
- * a negative value if the first argument is less than the second argument, zero if they're equal, and a positive
- * value otherwise. If omitted, the elements are sorted in ascending, ASCII character order.
- * ```ts
- * [11, 2, 22, 1].toSorted((a, b) => a - b) // [1, 2, 11, 22]
- * ```
- */
- toSorted(compareFn?: (a: T, b: T) => number): T[];
- /**
- * Copies an array and removes elements and, if necessary, inserts new elements in their place. Returns the copied array.
- * @param start The zero-based location in the array from which to start removing elements.
- * @param deleteCount The number of elements to remove.
- * @param items Elements to insert into the copied array in place of the deleted elements.
- * @returns The copied array.
- */
- toSpliced(start: number, deleteCount: number, ...items: T[]): T[];
- /**
- * Copies an array and removes elements while returning the remaining elements.
- * @param start The zero-based location in the array from which to start removing elements.
- * @param deleteCount The number of elements to remove.
- * @returns A copy of the original array with the remaining elements.
- */
- toSpliced(start: number, deleteCount?: number): T[];
- /**
- * Copies an array, then overwrites the value at the provided index with the
- * given value. If the index is negative, then it replaces from the end
- * of the array.
- * @param index The index of the value to overwrite. If the index is
- * negative, then it replaces from the end of the array.
- * @param value The value to write into the copied array.
- * @returns The copied array with the updated value.
- */
- with(index: number, value: T): T[];
- }
- interface ReadonlyArray<T> {
- /**
- * Returns the value of the last element in the array where predicate is true, and undefined
- * otherwise.
- * @param predicate findLast calls predicate once for each element of the array, in descending
- * order, until it finds one where predicate returns true. If such an element is found, findLast
- * immediately returns that element value. Otherwise, findLast returns undefined.
- * @param thisArg If provided, it will be used as the this value for each invocation of
- * predicate. If it is not provided, undefined is used instead.
- */
- findLast<S extends T>(
- predicate: (value: T, index: number, array: readonly T[]) => value is S,
- thisArg?: any,
- ): S | undefined;
- findLast(
- predicate: (value: T, index: number, array: readonly T[]) => unknown,
- thisArg?: any,
- ): T | undefined;
- /**
- * Returns the index of the last element in the array where predicate is true, and -1
- * otherwise.
- * @param predicate findLastIndex calls predicate once for each element of the array, in descending
- * order, until it finds one where predicate returns true. If such an element is found,
- * findLastIndex immediately returns that element index. Otherwise, findLastIndex returns -1.
- * @param thisArg If provided, it will be used as the this value for each invocation of
- * predicate. If it is not provided, undefined is used instead.
- */
- findLastIndex(
- predicate: (value: T, index: number, array: readonly T[]) => unknown,
- thisArg?: any,
- ): number;
- /**
- * Copies the array and returns the copied array with all of its elements reversed.
- */
- toReversed(): T[];
- /**
- * Copies and sorts the array.
- * @param compareFn Function used to determine the order of the elements. It is expected to return
- * a negative value if the first argument is less than the second argument, zero if they're equal, and a positive
- * value otherwise. If omitted, the elements are sorted in ascending, ASCII character order.
- * ```ts
- * [11, 2, 22, 1].toSorted((a, b) => a - b) // [1, 2, 11, 22]
- * ```
- */
- toSorted(compareFn?: (a: T, b: T) => number): T[];
- /**
- * Copies an array and removes elements while, if necessary, inserting new elements in their place, returning the remaining elements.
- * @param start The zero-based location in the array from which to start removing elements.
- * @param deleteCount The number of elements to remove.
- * @param items Elements to insert into the copied array in place of the deleted elements.
- * @returns A copy of the original array with the remaining elements.
- */
- toSpliced(start: number, deleteCount: number, ...items: T[]): T[];
- /**
- * Copies an array and removes elements while returning the remaining elements.
- * @param start The zero-based location in the array from which to start removing elements.
- * @param deleteCount The number of elements to remove.
- * @returns A copy of the original array with the remaining elements.
- */
- toSpliced(start: number, deleteCount?: number): T[];
- /**
- * Copies an array, then overwrites the value at the provided index with the
- * given value. If the index is negative, then it replaces from the end
- * of the array
- * @param index The index of the value to overwrite. If the index is
- * negative, then it replaces from the end of the array.
- * @param value The value to insert into the copied array.
- * @returns A copy of the original array with the inserted value.
- */
- with(index: number, value: T): T[];
- }
- interface Int8Array {
- /**
- * Returns the value of the last element in the array where predicate is true, and undefined
- * otherwise.
- * @param predicate findLast calls predicate once for each element of the array, in descending
- * order, until it finds one where predicate returns true. If such an element is found, findLast
- * immediately returns that element value. Otherwise, findLast returns undefined.
- * @param thisArg If provided, it will be used as the this value for each invocation of
- * predicate. If it is not provided, undefined is used instead.
- */
- findLast<S extends number>(
- predicate: (
- value: number,
- index: number,
- array: Int8Array,
- ) => value is S,
- thisArg?: any,
- ): S | undefined;
- findLast(
- predicate: (value: number, index: number, array: Int8Array) => unknown,
- thisArg?: any,
- ): number | undefined;
- /**
- * Returns the index of the last element in the array where predicate is true, and -1
- * otherwise.
- * @param predicate findLastIndex calls predicate once for each element of the array, in descending
- * order, until it finds one where predicate returns true. If such an element is found,
- * findLastIndex immediately returns that element index. Otherwise, findLastIndex returns -1.
- * @param thisArg If provided, it will be used as the this value for each invocation of
- * predicate. If it is not provided, undefined is used instead.
- */
- findLastIndex(
- predicate: (value: number, index: number, array: Int8Array) => unknown,
- thisArg?: any,
- ): number;
- /**
- * Copies the array and returns the copy with the elements in reverse order.
- */
- toReversed(): Uint8Array;
- /**
- * Copies and sorts the array.
- * @param compareFn Function used to determine the order of the elements. It is expected to return
- * a negative value if the first argument is less than the second argument, zero if they're equal, and a positive
- * value otherwise. If omitted, the elements are sorted in ascending order.
- * ```ts
- * const myNums = Uint8Array.from([11, 2, 22, 1]);
- * myNums.toSorted((a, b) => a - b) // Uint8Array(4) [1, 2, 11, 22]
- * ```
- */
- toSorted(compareFn?: (a: number, b: number) => number): Uint8Array;
- /**
- * Copies the array and inserts the given number at the provided index.
- * @param index The index of the value to overwrite. If the index is
- * negative, then it replaces from the end of the array.
- * @param value The value to insert into the copied array.
- * @returns A copy of the original array with the inserted value.
- */
- with(index: number, value: number): Uint8Array;
- }
- interface Uint8Array {
- /**
- * Returns the value of the last element in the array where predicate is true, and undefined
- * otherwise.
- * @param predicate findLast calls predicate once for each element of the array, in descending
- * order, until it finds one where predicate returns true. If such an element is found, findLast
- * immediately returns that element value. Otherwise, findLast returns undefined.
- * @param thisArg If provided, it will be used as the this value for each invocation of
- * predicate. If it is not provided, undefined is used instead.
- */
- findLast<S extends number>(
- predicate: (
- value: number,
- index: number,
- array: Uint8Array,
- ) => value is S,
- thisArg?: any,
- ): S | undefined;
- findLast(
- predicate: (value: number, index: number, array: Uint8Array) => unknown,
- thisArg?: any,
- ): number | undefined;
- /**
- * Returns the index of the last element in the array where predicate is true, and -1
- * otherwise.
- * @param predicate findLastIndex calls predicate once for each element of the array, in descending
- * order, until it finds one where predicate returns true. If such an element is found,
- * findLastIndex immediately returns that element index. Otherwise, findLastIndex returns -1.
- * @param thisArg If provided, it will be used as the this value for each invocation of
- * predicate. If it is not provided, undefined is used instead.
- */
- findLastIndex(
- predicate: (value: number, index: number, array: Uint8Array) => unknown,
- thisArg?: any,
- ): number;
- /**
- * Copies the array and returns the copy with the elements in reverse order.
- */
- toReversed(): Uint8Array;
- /**
- * Copies and sorts the array.
- * @param compareFn Function used to determine the order of the elements. It is expected to return
- * a negative value if the first argument is less than the second argument, zero if they're equal, and a positive
- * value otherwise. If omitted, the elements are sorted in ascending order.
- * ```ts
- * const myNums = Uint8Array.from([11, 2, 22, 1]);
- * myNums.toSorted((a, b) => a - b) // Uint8Array(4) [1, 2, 11, 22]
- * ```
- */
- toSorted(compareFn?: (a: number, b: number) => number): Uint8Array;
- /**
- * Copies the array and inserts the given number at the provided index.
- * @param index The index of the value to overwrite. If the index is
- * negative, then it replaces from the end of the array.
- * @param value The value to insert into the copied array.
- * @returns A copy of the original array with the inserted value.
- */
- with(index: number, value: number): Uint8Array;
- }
- interface Uint8ClampedArray {
- /**
- * Returns the value of the last element in the array where predicate is true, and undefined
- * otherwise.
- * @param predicate findLast calls predicate once for each element of the array, in descending
- * order, until it finds one where predicate returns true. If such an element is found, findLast
- * immediately returns that element value. Otherwise, findLast returns undefined.
- * @param thisArg If provided, it will be used as the this value for each invocation of
- * predicate. If it is not provided, undefined is used instead.
- */
- findLast<S extends number>(
- predicate: (
- value: number,
- index: number,
- array: Uint8ClampedArray,
- ) => value is S,
- thisArg?: any,
- ): S | undefined;
- findLast(
- predicate: (
- value: number,
- index: number,
- array: Uint8ClampedArray,
- ) => unknown,
- thisArg?: any,
- ): number | undefined;
- /**
- * Returns the index of the last element in the array where predicate is true, and -1
- * otherwise.
- * @param predicate findLastIndex calls predicate once for each element of the array, in descending
- * order, until it finds one where predicate returns true. If such an element is found,
- * findLastIndex immediately returns that element index. Otherwise, findLastIndex returns -1.
- * @param thisArg If provided, it will be used as the this value for each invocation of
- * predicate. If it is not provided, undefined is used instead.
- */
- findLastIndex(
- predicate: (
- value: number,
- index: number,
- array: Uint8ClampedArray,
- ) => unknown,
- thisArg?: any,
- ): number;
- /**
- * Copies the array and returns the copy with the elements in reverse order.
- */
- toReversed(): Uint8ClampedArray;
- /**
- * Copies and sorts the array.
- * @param compareFn Function used to determine the order of the elements. It is expected to return
- * a negative value if the first argument is less than the second argument, zero if they're equal, and a positive
- * value otherwise. If omitted, the elements are sorted in ascending order.
- * ```ts
- * const myNums = Uint8ClampedArray.from([11, 2, 22, 1]);
- * myNums.toSorted((a, b) => a - b) // Uint8ClampedArray(4) [1, 2, 11, 22]
- * ```
- */
- toSorted(compareFn?: (a: number, b: number) => number): Uint8ClampedArray;
- /**
- * Copies the array and inserts the given number at the provided index.
- * @param index The index of the value to overwrite. If the index is
- * negative, then it replaces from the end of the array.
- * @param value The value to insert into the copied array.
- * @returns A copy of the original array with the inserted value.
- */
- with(index: number, value: number): Uint8ClampedArray;
- }
- interface Int16Array {
- /**
- * Returns the value of the last element in the array where predicate is true, and undefined
- * otherwise.
- * @param predicate findLast calls predicate once for each element of the array, in descending
- * order, until it finds one where predicate returns true. If such an element is found, findLast
- * immediately returns that element value. Otherwise, findLast returns undefined.
- * @param thisArg If provided, it will be used as the this value for each invocation of
- * predicate. If it is not provided, undefined is used instead.
- */
- findLast<S extends number>(
- predicate: (
- value: number,
- index: number,
- array: Int16Array,
- ) => value is S,
- thisArg?: any,
- ): S | undefined;
- findLast(
- predicate: (value: number, index: number, array: Int16Array) => unknown,
- thisArg?: any,
- ): number | undefined;
- /**
- * Returns the index of the last element in the array where predicate is true, and -1
- * otherwise.
- * @param predicate findLastIndex calls predicate once for each element of the array, in descending
- * order, until it finds one where predicate returns true. If such an element is found,
- * findLastIndex immediately returns that element index. Otherwise, findLastIndex returns -1.
- * @param thisArg If provided, it will be used as the this value for each invocation of
- * predicate. If it is not provided, undefined is used instead.
- */
- findLastIndex(
- predicate: (value: number, index: number, array: Int16Array) => unknown,
- thisArg?: any,
- ): number;
- /**
- * Copies the array and returns the copy with the elements in reverse order.
- */
- toReversed(): Int16Array;
- /**
- * Copies and sorts the array.
- * @param compareFn Function used to determine the order of the elements. It is expected to return
- * a negative value if the first argument is less than the second argument, zero if they're equal, and a positive
- * value otherwise. If omitted, the elements are sorted in ascending order.
- * ```ts
- * const myNums = Int16Array.from([11, 2, -22, 1]);
- * myNums.toSorted((a, b) => a - b) // Int16Array(4) [-22, 1, 2, 11]
- * ```
- */
- toSorted(compareFn?: (a: number, b: number) => number): Int16Array;
- /**
- * Copies the array and inserts the given number at the provided index.
- * @param index The index of the value to overwrite. If the index is
- * negative, then it replaces from the end of the array.
- * @param value The value to insert into the copied array.
- * @returns A copy of the original array with the inserted value.
- */
- with(index: number, value: number): Int16Array;
- }
- interface Uint16Array {
- /**
- * Returns the value of the last element in the array where predicate is true, and undefined
- * otherwise.
- * @param predicate findLast calls predicate once for each element of the array, in descending
- * order, until it finds one where predicate returns true. If such an element is found, findLast
- * immediately returns that element value. Otherwise, findLast returns undefined.
- * @param thisArg If provided, it will be used as the this value for each invocation of
- * predicate. If it is not provided, undefined is used instead.
- */
- findLast<S extends number>(
- predicate: (
- value: number,
- index: number,
- array: Uint16Array,
- ) => value is S,
- thisArg?: any,
- ): S | undefined;
- findLast(
- predicate: (
- value: number,
- index: number,
- array: Uint16Array,
- ) => unknown,
- thisArg?: any,
- ): number | undefined;
- /**
- * Returns the index of the last element in the array where predicate is true, and -1
- * otherwise.
- * @param predicate findLastIndex calls predicate once for each element of the array, in descending
- * order, until it finds one where predicate returns true. If such an element is found,
- * findLastIndex immediately returns that element index. Otherwise, findLastIndex returns -1.
- * @param thisArg If provided, it will be used as the this value for each invocation of
- * predicate. If it is not provided, undefined is used instead.
- */
- findLastIndex(
- predicate: (
- value: number,
- index: number,
- array: Uint16Array,
- ) => unknown,
- thisArg?: any,
- ): number;
- /**
- * Copies the array and returns the copy with the elements in reverse order.
- */
- toReversed(): Uint16Array;
- /**
- * Copies and sorts the array.
- * @param compareFn Function used to determine the order of the elements. It is expected to return
- * a negative value if the first argument is less than the second argument, zero if they're equal, and a positive
- * value otherwise. If omitted, the elements are sorted in ascending order.
- * ```ts
- * const myNums = Uint16Array.from([11, 2, 22, 1]);
- * myNums.toSorted((a, b) => a - b) // Uint16Array(4) [1, 2, 11, 22]
- * ```
- */
- toSorted(compareFn?: (a: number, b: number) => number): Uint16Array;
- /**
- * Copies the array and inserts the given number at the provided index.
- * @param index The index of the value to overwrite. If the index is
- * negative, then it replaces from the end of the array.
- * @param value The value to insert into the copied array.
- * @returns A copy of the original array with the inserted value.
- */
- with(index: number, value: number): Uint16Array;
- }
- interface Int32Array {
- /**
- * Returns the value of the last element in the array where predicate is true, and undefined
- * otherwise.
- * @param predicate findLast calls predicate once for each element of the array, in descending
- * order, until it finds one where predicate returns true. If such an element is found, findLast
- * immediately returns that element value. Otherwise, findLast returns undefined.
- * @param thisArg If provided, it will be used as the this value for each invocation of
- * predicate. If it is not provided, undefined is used instead.
- */
- findLast<S extends number>(
- predicate: (
- value: number,
- index: number,
- array: Int32Array,
- ) => value is S,
- thisArg?: any,
- ): S | undefined;
- findLast(
- predicate: (value: number, index: number, array: Int32Array) => unknown,
- thisArg?: any,
- ): number | undefined;
- /**
- * Returns the index of the last element in the array where predicate is true, and -1
- * otherwise.
- * @param predicate findLastIndex calls predicate once for each element of the array, in descending
- * order, until it finds one where predicate returns true. If such an element is found,
- * findLastIndex immediately returns that element index. Otherwise, findLastIndex returns -1.
- * @param thisArg If provided, it will be used as the this value for each invocation of
- * predicate. If it is not provided, undefined is used instead.
- */
- findLastIndex(
- predicate: (value: number, index: number, array: Int32Array) => unknown,
- thisArg?: any,
- ): number;
- /**
- * Copies the array and returns the copy with the elements in reverse order.
- */
- toReversed(): Int32Array;
- /**
- * Copies and sorts the array.
- * @param compareFn Function used to determine the order of the elements. It is expected to return
- * a negative value if the first argument is less than the second argument, zero if they're equal, and a positive
- * value otherwise. If omitted, the elements are sorted in ascending order.
- * ```ts
- * const myNums = Int32Array.from([11, 2, -22, 1]);
- * myNums.toSorted((a, b) => a - b) // Int32Array(4) [-22, 1, 2, 11]
- * ```
- */
- toSorted(compareFn?: (a: number, b: number) => number): Int32Array;
- /**
- * Copies the array and inserts the given number at the provided index.
- * @param index The index of the value to overwrite. If the index is
- * negative, then it replaces from the end of the array.
- * @param value The value to insert into the copied array.
- * @returns A copy of the original array with the inserted value.
- */
- with(index: number, value: number): Int32Array;
- }
- interface Uint32Array {
- /**
- * Returns the value of the last element in the array where predicate is true, and undefined
- * otherwise.
- * @param predicate findLast calls predicate once for each element of the array, in descending
- * order, until it finds one where predicate returns true. If such an element is found, findLast
- * immediately returns that element value. Otherwise, findLast returns undefined.
- * @param thisArg If provided, it will be used as the this value for each invocation of
- * predicate. If it is not provided, undefined is used instead.
- */
- findLast<S extends number>(
- predicate: (
- value: number,
- index: number,
- array: Uint32Array,
- ) => value is S,
- thisArg?: any,
- ): S | undefined;
- findLast(
- predicate: (
- value: number,
- index: number,
- array: Uint32Array,
- ) => unknown,
- thisArg?: any,
- ): number | undefined;
- /**
- * Returns the index of the last element in the array where predicate is true, and -1
- * otherwise.
- * @param predicate findLastIndex calls predicate once for each element of the array, in descending
- * order, until it finds one where predicate returns true. If such an element is found,
- * findLastIndex immediately returns that element index. Otherwise, findLastIndex returns -1.
- * @param thisArg If provided, it will be used as the this value for each invocation of
- * predicate. If it is not provided, undefined is used instead.
- */
- findLastIndex(
- predicate: (
- value: number,
- index: number,
- array: Uint32Array,
- ) => unknown,
- thisArg?: any,
- ): number;
- /**
- * Copies the array and returns the copy with the elements in reverse order.
- */
- toReversed(): Uint32Array;
- /**
- * Copies and sorts the array.
- * @param compareFn Function used to determine the order of the elements. It is expected to return
- * a negative value if the first argument is less than the second argument, zero if they're equal, and a positive
- * value otherwise. If omitted, the elements are sorted in ascending order.
- * ```ts
- * const myNums = Uint32Array.from([11, 2, 22, 1]);
- * myNums.toSorted((a, b) => a - b) // Uint32Array(4) [1, 2, 11, 22]
- * ```
- */
- toSorted(compareFn?: (a: number, b: number) => number): Uint32Array;
- /**
- * Copies the array and inserts the given number at the provided index.
- * @param index The index of the value to overwrite. If the index is
- * negative, then it replaces from the end of the array.
- * @param value The value to insert into the copied array.
- * @returns A copy of the original array with the inserted value.
- */
- with(index: number, value: number): Uint32Array;
- }
- interface Float32Array {
- /**
- * Returns the value of the last element in the array where predicate is true, and undefined
- * otherwise.
- * @param predicate findLast calls predicate once for each element of the array, in descending
- * order, until it finds one where predicate returns true. If such an element is found, findLast
- * immediately returns that element value. Otherwise, findLast returns undefined.
- * @param thisArg If provided, it will be used as the this value for each invocation of
- * predicate. If it is not provided, undefined is used instead.
- */
- findLast<S extends number>(
- predicate: (
- value: number,
- index: number,
- array: Float32Array,
- ) => value is S,
- thisArg?: any,
- ): S | undefined;
- findLast(
- predicate: (
- value: number,
- index: number,
- array: Float32Array,
- ) => unknown,
- thisArg?: any,
- ): number | undefined;
- /**
- * Returns the index of the last element in the array where predicate is true, and -1
- * otherwise.
- * @param predicate findLastIndex calls predicate once for each element of the array, in descending
- * order, until it finds one where predicate returns true. If such an element is found,
- * findLastIndex immediately returns that element index. Otherwise, findLastIndex returns -1.
- * @param thisArg If provided, it will be used as the this value for each invocation of
- * predicate. If it is not provided, undefined is used instead.
- */
- findLastIndex(
- predicate: (
- value: number,
- index: number,
- array: Float32Array,
- ) => unknown,
- thisArg?: any,
- ): number;
- /**
- * Copies the array and returns the copy with the elements in reverse order.
- */
- toReversed(): Float32Array;
- /**
- * Copies and sorts the array.
- * @param compareFn Function used to determine the order of the elements. It is expected to return
- * a negative value if the first argument is less than the second argument, zero if they're equal, and a positive
- * value otherwise. If omitted, the elements are sorted in ascending order.
- * ```ts
- * const myNums = Float32Array.from([11.25, 2, -22.5, 1]);
- * myNums.toSorted((a, b) => a - b) // Float32Array(4) [-22.5, 1, 2, 11.5]
- * ```
- */
- toSorted(compareFn?: (a: number, b: number) => number): Float32Array;
- /**
- * Copies the array and inserts the given number at the provided index.
- * @param index The index of the value to overwrite. If the index is
- * negative, then it replaces from the end of the array.
- * @param value The value to insert into the copied array.
- * @returns A copy of the original array with the inserted value.
- */
- with(index: number, value: number): Float32Array;
- }
- interface Float64Array {
- /**
- * Returns the value of the last element in the array where predicate is true, and undefined
- * otherwise.
- * @param predicate findLast calls predicate once for each element of the array, in descending
- * order, until it finds one where predicate returns true. If such an element is found, findLast
- * immediately returns that element value. Otherwise, findLast returns undefined.
- * @param thisArg If provided, it will be used as the this value for each invocation of
- * predicate. If it is not provided, undefined is used instead.
- */
- findLast<S extends number>(
- predicate: (
- value: number,
- index: number,
- array: Float64Array,
- ) => value is S,
- thisArg?: any,
- ): S | undefined;
- findLast(
- predicate: (
- value: number,
- index: number,
- array: Float64Array,
- ) => unknown,
- thisArg?: any,
- ): number | undefined;
- /**
- * Returns the index of the last element in the array where predicate is true, and -1
- * otherwise.
- * @param predicate findLastIndex calls predicate once for each element of the array, in descending
- * order, until it finds one where predicate returns true. If such an element is found,
- * findLastIndex immediately returns that element index. Otherwise, findLastIndex returns -1.
- * @param thisArg If provided, it will be used as the this value for each invocation of
- * predicate. If it is not provided, undefined is used instead.
- */
- findLastIndex(
- predicate: (
- value: number,
- index: number,
- array: Float64Array,
- ) => unknown,
- thisArg?: any,
- ): number;
- /**
- * Copies the array and returns the copy with the elements in reverse order.
- */
- toReversed(): Float64Array;
- /**
- * Copies and sorts the array.
- * @param compareFn Function used to determine the order of the elements. It is expected to return
- * a negative value if the first argument is less than the second argument, zero if they're equal, and a positive
- * value otherwise. If omitted, the elements are sorted in ascending order.
- * ```ts
- * const myNums = Float64Array.from([11.25, 2, -22.5, 1]);
- * myNums.toSorted((a, b) => a - b) // Float64Array(4) [-22.5, 1, 2, 11.5]
- * ```
- */
- toSorted(compareFn?: (a: number, b: number) => number): Float64Array;
- /**
- * Copies the array and inserts the given number at the provided index.
- * @param index The index of the value to overwrite. If the index is
- * negative, then it replaces from the end of the array.
- * @param value The value to insert into the copied array.
- * @returns A copy of the original array with the inserted value.
- */
- with(index: number, value: number): Float64Array;
- }
- interface BigInt64Array {
- /**
- * Returns the value of the last element in the array where predicate is true, and undefined
- * otherwise.
- * @param predicate findLast calls predicate once for each element of the array, in descending
- * order, until it finds one where predicate returns true. If such an element is found, findLast
- * immediately returns that element value. Otherwise, findLast returns undefined.
- * @param thisArg If provided, it will be used as the this value for each invocation of
- * predicate. If it is not provided, undefined is used instead.
- */
- findLast<S extends bigint>(
- predicate: (
- value: bigint,
- index: number,
- array: BigInt64Array,
- ) => value is S,
- thisArg?: any,
- ): S | undefined;
- findLast(
- predicate: (
- value: bigint,
- index: number,
- array: BigInt64Array,
- ) => unknown,
- thisArg?: any,
- ): bigint | undefined;
- /**
- * Returns the index of the last element in the array where predicate is true, and -1
- * otherwise.
- * @param predicate findLastIndex calls predicate once for each element of the array, in descending
- * order, until it finds one where predicate returns true. If such an element is found,
- * findLastIndex immediately returns that element index. Otherwise, findLastIndex returns -1.
- * @param thisArg If provided, it will be used as the this value for each invocation of
- * predicate. If it is not provided, undefined is used instead.
- */
- findLastIndex(
- predicate: (
- value: bigint,
- index: number,
- array: BigInt64Array,
- ) => unknown,
- thisArg?: any,
- ): number;
- /**
- * Copies the array and returns the copy with the elements in reverse order.
- */
- toReversed(): BigInt64Array;
- /**
- * Copies and sorts the array.
- * @param compareFn Function used to determine the order of the elements. It is expected to return
- * a negative value if the first argument is less than the second argument, zero if they're equal, and a positive
- * value otherwise. If omitted, the elements are sorted in ascending order.
- * ```ts
- * const myNums = BigInt64Array.from([11n, 2n, -22n, 1n]);
- * myNums.toSorted((a, b) => Number(a - b)) // BigInt64Array(4) [-22n, 1n, 2n, 11n]
- * ```
- */
- toSorted(compareFn?: (a: bigint, b: bigint) => number): BigInt64Array;
- /**
- * Copies the array and inserts the given bigint at the provided index.
- * @param index The index of the value to overwrite. If the index is
- * negative, then it replaces from the end of the array.
- * @param value The value to insert into the copied array.
- * @returns A copy of the original array with the inserted value.
- */
- with(index: number, value: bigint): BigInt64Array;
- }
- interface BigUint64Array {
- /**
- * Returns the value of the last element in the array where predicate is true, and undefined
- * otherwise.
- * @param predicate findLast calls predicate once for each element of the array, in descending
- * order, until it finds one where predicate returns true. If such an element is found, findLast
- * immediately returns that element value. Otherwise, findLast returns undefined.
- * @param thisArg If provided, it will be used as the this value for each invocation of
- * predicate. If it is not provided, undefined is used instead.
- */
- findLast<S extends bigint>(
- predicate: (
- value: bigint,
- index: number,
- array: BigUint64Array,
- ) => value is S,
- thisArg?: any,
- ): S | undefined;
- findLast(
- predicate: (
- value: bigint,
- index: number,
- array: BigUint64Array,
- ) => unknown,
- thisArg?: any,
- ): bigint | undefined;
- /**
- * Returns the index of the last element in the array where predicate is true, and -1
- * otherwise.
- * @param predicate findLastIndex calls predicate once for each element of the array, in descending
- * order, until it finds one where predicate returns true. If such an element is found,
- * findLastIndex immediately returns that element index. Otherwise, findLastIndex returns -1.
- * @param thisArg If provided, it will be used as the this value for each invocation of
- * predicate. If it is not provided, undefined is used instead.
- */
- findLastIndex(
- predicate: (
- value: bigint,
- index: number,
- array: BigUint64Array,
- ) => unknown,
- thisArg?: any,
- ): number;
- /**
- * Copies the array and returns the copy with the elements in reverse order.
- */
- toReversed(): BigUint64Array;
- /**
- * Copies and sorts the array.
- * @param compareFn Function used to determine the order of the elements. It is expected to return
- * a negative value if the first argument is less than the second argument, zero if they're equal, and a positive
- * value otherwise. If omitted, the elements are sorted in ascending order.
- * ```ts
- * const myNums = BigUint64Array.from([11n, 2n, 22n, 1n]);
- * myNums.toSorted((a, b) => Number(a - b)) // BigUint64Array(4) [1n, 2n, 11n, 22n]
- * ```
- */
- toSorted(compareFn?: (a: bigint, b: bigint) => number): BigUint64Array;
- /**
- * Copies the array and inserts the given bigint at the provided index.
- * @param index The index of the value to overwrite. If the index is
- * negative, then it replaces from the end of the array.
- * @param value The value to insert into the copied array.
- * @returns A copy of the original array with the inserted value.
- */
- with(index: number, value: bigint): BigUint64Array;
- }
|