Interface BigInt64Array
[toStringTag]: "BigInt64Array";
buffer: ArrayBufferLike;
byteLength: number;
byteOffset: number;
BYTES_PER_ELEMENT: number;
length: number;
[iterator](): ArrayIterator<bigint>;
at(index: number): bigint;
copyWithin(target: number, start: number, end?: number): this;
entries(): ArrayIterator<[number, bigint]>;
every(predicate: ((value: bigint, index: number, array: BigInt64Array) => boolean), thisArg?: any): boolean;
fill(value: bigint, start?: number, end?: number): this;
filter(predicate: ((value: bigint, index: number, array: BigInt64Array) => any), thisArg?: any): BigInt64Array;
find(predicate: ((value: bigint, index: number, array: BigInt64Array) => boolean), thisArg?: any): bigint;
findIndex(predicate: ((value: bigint, index: number, array: BigInt64Array) => boolean), thisArg?: any): number;
findLast<S>(predicate: ((value: bigint, index: number, array: BigInt64Array) => value is S), thisArg?: any): S;
findLast(predicate: ((value: bigint, index: number, array: BigInt64Array) => unknown), thisArg?: any): bigint;
findLastIndex(predicate: ((value: bigint, index: number, array: BigInt64Array) => unknown), thisArg?: any): number;
forEach(callbackfn: ((value: bigint, index: number, array: BigInt64Array) => void), thisArg?: any): void;
includes(searchElement: bigint, fromIndex?: number): boolean;
indexOf(searchElement: bigint, fromIndex?: number): number;
join(separator?: string): string;
keys(): ArrayIterator<number>;
lastIndexOf(searchElement: bigint, fromIndex?: number): number;
map(callbackfn: ((value: bigint, index: number, array: BigInt64Array) => bigint), thisArg?: any): BigInt64Array;
reduce(callbackfn: ((previousValue: bigint, currentValue: bigint, currentIndex: number, array: BigInt64Array) => bigint)): bigint;
reduce<U>(callbackfn: ((previousValue: U, currentValue: bigint, currentIndex: number, array: BigInt64Array) => U), initialValue: U): U;
reduceRight(callbackfn: ((previousValue: bigint, currentValue: bigint, currentIndex: number, array: BigInt64Array) => bigint)): bigint;
reduceRight<U>(callbackfn: ((previousValue: U, currentValue: bigint, currentIndex: number, array: BigInt64Array) => U), initialValue: U): U;
reverse(): this;
set(array: ArrayLike<bigint>, offset?: number): void;
slice(start?: number, end?: number): BigInt64Array;
some(predicate: ((value: bigint, index: number, array: BigInt64Array) => boolean), thisArg?: any): boolean;
sort(compareFn?: ((a: bigint, b: bigint) => number | bigint)): this;
subarray(begin?: number, end?: number): BigInt64Array;
toLocaleString(locales?: string | string[], options?: NumberFormatOptions): string;
toReversed(): BigInt64Array;
toSorted(compareFn?: ((a: bigint, b: bigint) => number)): BigInt64Array;
toString(): string;
valueOf(): BigInt64Array;
values(): ArrayIterator<bigint>;
with(index: number, value: bigint): BigInt64Array;
[index: number]: bigint;
}
Indexable
- [index: number]: bigint
Index
Properties
Methods
Properties
Readonly
[toStringTag]
Readonly
buffer
Readonly
byteLength
The length in bytes of the array.
Readonly
byteOffset
The offset in bytes of the array.
Readonly
BYTES_PER_ELEMENT
The size in bytes of each element in the array.
Readonly
length
The length of the array.
Methods
[iterator]
- [iterator](): ArrayIterator<bigint>
Returns ArrayIterator<bigint>
at
copyWithin
- copy
Within (target, start, end?): this Returns the this object after copying a section of the array identified by start and end to the same array starting at position target
Parameters
- target: number
If target is negative, it is treated as length+target where length is the length of the array.
- start: number
If start is negative, it is treated as length+start. If end is negative, it is treated as length+end.
Optional
end: numberIf not specified, length of the this object is used as its default value.
Returns this
- target: number
entries
- entries(): ArrayIterator<[number, bigint]>
Yields index, value pairs for every entry in the array.
Returns ArrayIterator<[number, bigint]>
every
- every(predicate, thisArg?): boolean
Determines whether all the members of an array satisfy the specified test.
Parameters
- predicate: ((value: bigint, index: number, array: BigInt64Array) => boolean)
A function that accepts up to three arguments. The every method calls the predicate function for each element in the array until the predicate returns false, or until the end of the array.
- (value, index, array): boolean
Parameters
- value: bigint
- index: number
- array: BigInt64Array
Returns boolean
Optional
thisArg: anyAn object to which the this keyword can refer in the predicate function. If thisArg is omitted, undefined is used as the this value.
Returns boolean
- predicate: ((value: bigint, index: number, array: BigInt64Array) => boolean)
fill
- fill(value, start?, end?): this
Changes all array elements from
start
toend
index to a staticvalue
and returns the modified arrayParameters
- value: bigint
value to fill array section with
Optional
start: numberindex to start filling the array at. If start is negative, it is treated as length+start where length is the length of the array.
Optional
end: numberindex to stop filling the array at. If end is negative, it is treated as length+end.
Returns this
- value: bigint
filter
- filter(predicate, thisArg?): BigInt64Array
Returns the elements of an array that meet the condition specified in a callback function.
Parameters
- predicate: ((value: bigint, index: number, array: BigInt64Array) => any)
A function that accepts up to three arguments. The filter method calls the predicate function one time for each element in the array.
- (value, index, array): any
Parameters
- value: bigint
- index: number
- array: BigInt64Array
Returns any
Optional
thisArg: anyAn object to which the this keyword can refer in the predicate function. If thisArg is omitted, undefined is used as the this value.
Returns BigInt64Array
- predicate: ((value: bigint, index: number, array: BigInt64Array) => any)
find
- find(predicate, thisArg?): bigint
Returns the value of the first element in the array where predicate is true, and undefined otherwise.
Parameters
- predicate: ((value: bigint, index: number, array: BigInt64Array) => boolean)
find calls predicate once for each element of the array, in ascending order, until it finds one where predicate returns true. If such an element is found, find immediately returns that element value. Otherwise, find returns undefined.
- (value, index, array): boolean
Parameters
- value: bigint
- index: number
- array: BigInt64Array
Returns boolean
Optional
thisArg: anyIf provided, it will be used as the this value for each invocation of predicate. If it is not provided, undefined is used instead.
Returns bigint
- predicate: ((value: bigint, index: number, array: BigInt64Array) => boolean)
findIndex
- find
Index (predicate, thisArg?): number Returns the index of the first element in the array where predicate is true, and -1 otherwise.
Parameters
- predicate: ((value: bigint, index: number, array: BigInt64Array) => boolean)
find calls predicate once for each element of the array, in ascending order, until it finds one where predicate returns true. If such an element is found, findIndex immediately returns that element index. Otherwise, findIndex returns -1.
- (value, index, array): boolean
Parameters
- value: bigint
- index: number
- array: BigInt64Array
Returns boolean
Optional
thisArg: anyIf provided, it will be used as the this value for each invocation of predicate. If it is not provided, undefined is used instead.
Returns number
- predicate: ((value: bigint, index: number, array: BigInt64Array) => boolean)
findLast
- find
Last <S>(predicate, thisArg?): S Returns the value of the last element in the array where predicate is true, and undefined otherwise.
Type Parameters
Parameters
- predicate: ((value: bigint, index: number, array: BigInt64Array) => value is S)
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.
- (value, index, array): value is S
Parameters
- value: bigint
- index: number
- array: BigInt64Array
Returns value is S
Optional
thisArg: anyIf provided, it will be used as the this value for each invocation of predicate. If it is not provided, undefined is used instead.
Returns S
- predicate: ((value: bigint, index: number, array: BigInt64Array) => value is S)
- find
Last (predicate, thisArg?): bigint Parameters
- predicate: ((value: bigint, index: number, array: BigInt64Array) => unknown)
- (value, index, array): unknown
Parameters
- value: bigint
- index: number
- array: BigInt64Array
Returns unknown
Optional
thisArg: any
Returns bigint
- predicate: ((value: bigint, index: number, array: BigInt64Array) => unknown)
findLastIndex
- find
Last (predicate, thisArg?): numberIndex Returns the index of the last element in the array where predicate is true, and -1 otherwise.
Parameters
- predicate: ((value: bigint, index: number, array: BigInt64Array) => unknown)
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.
- (value, index, array): unknown
Parameters
- value: bigint
- index: number
- array: BigInt64Array
Returns unknown
Optional
thisArg: anyIf provided, it will be used as the this value for each invocation of predicate. If it is not provided, undefined is used instead.
Returns number
- predicate: ((value: bigint, index: number, array: BigInt64Array) => unknown)
forEach
- for
Each (callbackfn, thisArg?): void Performs the specified action for each element in an array.
Parameters
- callbackfn: ((value: bigint, index: number, array: BigInt64Array) => void)
A function that accepts up to three arguments. forEach calls the callbackfn function one time for each element in the array.
- (value, index, array): void
Parameters
- value: bigint
- index: number
- array: BigInt64Array
Returns void
Optional
thisArg: anyAn object to which the this keyword can refer in the callbackfn function. If thisArg is omitted, undefined is used as the this value.
Returns void
- callbackfn: ((value: bigint, index: number, array: BigInt64Array) => void)
includes
- includes(searchElement, fromIndex?): boolean
Determines whether an array includes a certain element, returning true or false as appropriate.
Parameters
- searchElement: bigint
The element to search for.
Optional
fromIndex: numberThe position in this array at which to begin searching for searchElement.
Returns boolean
- searchElement: bigint
indexOf
- index
Of (searchElement, fromIndex?): number Returns the index of the first occurrence of a value in an array.
Parameters
- searchElement: bigint
The value to locate in the array.
Optional
fromIndex: numberThe array index at which to begin the search. If fromIndex is omitted, the search starts at index 0.
Returns number
- searchElement: bigint
join
- join(separator?): string
Adds all the elements of an array separated by the specified separator string.
Parameters
Optional
separator: stringA string used to separate one element of an array from the next in the resulting String. If omitted, the array elements are separated with a comma.
Returns string
keys
- keys(): ArrayIterator<number>
Yields each index in the array.
Returns ArrayIterator<number>
lastIndexOf
- last
Index (searchElement, fromIndex?): numberOf Returns the index of the last occurrence of a value in an array.
Parameters
- searchElement: bigint
The value to locate in the array.
Optional
fromIndex: numberThe array index at which to begin the search. If fromIndex is omitted, the search starts at index 0.
Returns number
- searchElement: bigint
map
- map(callbackfn, thisArg?): BigInt64Array
Calls a defined callback function on each element of an array, and returns an array that contains the results.
Parameters
- callbackfn: ((value: bigint, index: number, array: BigInt64Array) => bigint)
A function that accepts up to three arguments. The map method calls the callbackfn function one time for each element in the array.
- (value, index, array): bigint
Parameters
- value: bigint
- index: number
- array: BigInt64Array
Returns bigint
Optional
thisArg: anyAn object to which the this keyword can refer in the callbackfn function. If thisArg is omitted, undefined is used as the this value.
Returns BigInt64Array
- callbackfn: ((value: bigint, index: number, array: BigInt64Array) => bigint)
reduce
- reduce(callbackfn): bigint
Calls the specified callback function for all the elements in an array. The return value of the callback function is the accumulated result, and is provided as an argument in the next call to the callback function.
Parameters
- callbackfn: ((previousValue: bigint, currentValue: bigint, currentIndex: number, array: BigInt64Array) => bigint)
A function that accepts up to four arguments. The reduce method calls the callbackfn function one time for each element in the array.
- (previousValue, currentValue, currentIndex, array): bigint
Parameters
- previousValue: bigint
- currentValue: bigint
- currentIndex: number
- array: BigInt64Array
Returns bigint
Returns bigint
- callbackfn: ((previousValue: bigint, currentValue: bigint, currentIndex: number, array: BigInt64Array) => bigint)
- reduce<U>(callbackfn, initialValue): U
Calls the specified callback function for all the elements in an array. The return value of the callback function is the accumulated result, and is provided as an argument in the next call to the callback function.
Type Parameters
Parameters
- callbackfn: ((previousValue: U, currentValue: bigint, currentIndex: number, array: BigInt64Array) => U)
A function that accepts up to four arguments. The reduce method calls the callbackfn function one time for each element in the array.
- (previousValue, currentValue, currentIndex, array): U
Parameters
- previousValue: U
- currentValue: bigint
- currentIndex: number
- array: BigInt64Array
Returns U
- initialValue: U
If initialValue is specified, it is used as the initial value to start the accumulation. The first call to the callbackfn function provides this value as an argument instead of an array value.
Returns U
- callbackfn: ((previousValue: U, currentValue: bigint, currentIndex: number, array: BigInt64Array) => U)
reduceRight
- reduce
Right (callbackfn): bigint Calls the specified callback function for all the elements in an array, in descending order. The return value of the callback function is the accumulated result, and is provided as an argument in the next call to the callback function.
Parameters
- callbackfn: ((previousValue: bigint, currentValue: bigint, currentIndex: number, array: BigInt64Array) => bigint)
A function that accepts up to four arguments. The reduceRight method calls the callbackfn function one time for each element in the array.
- (previousValue, currentValue, currentIndex, array): bigint
Parameters
- previousValue: bigint
- currentValue: bigint
- currentIndex: number
- array: BigInt64Array
Returns bigint
Returns bigint
- callbackfn: ((previousValue: bigint, currentValue: bigint, currentIndex: number, array: BigInt64Array) => bigint)
- reduce
Right <U>(callbackfn, initialValue): U Calls the specified callback function for all the elements in an array, in descending order. The return value of the callback function is the accumulated result, and is provided as an argument in the next call to the callback function.
Type Parameters
Parameters
- callbackfn: ((previousValue: U, currentValue: bigint, currentIndex: number, array: BigInt64Array) => U)
A function that accepts up to four arguments. The reduceRight method calls the callbackfn function one time for each element in the array.
- (previousValue, currentValue, currentIndex, array): U
Parameters
- previousValue: U
- currentValue: bigint
- currentIndex: number
- array: BigInt64Array
Returns U
- initialValue: U
If initialValue is specified, it is used as the initial value to start the accumulation. The first call to the callbackfn function provides this value as an argument instead of an array value.
Returns U
- callbackfn: ((previousValue: U, currentValue: bigint, currentIndex: number, array: BigInt64Array) => U)
reverse
set
- set(array, offset?): void
Sets a value or an array of values.
Parameters
- array: ArrayLike<bigint>
A typed or untyped array of values to set.
Optional
offset: numberThe index in the current array at which the values are to be written.
Returns void
- array: ArrayLike<bigint>
slice
- slice(start?, end?): BigInt64Array
Returns a section of an array.
Parameters
Optional
start: numberThe beginning of the specified portion of the array.
Optional
end: numberThe end of the specified portion of the array.
Returns BigInt64Array
some
- some(predicate, thisArg?): boolean
Determines whether the specified callback function returns true for any element of an array.
Parameters
- predicate: ((value: bigint, index: number, array: BigInt64Array) => boolean)
A function that accepts up to three arguments. The some method calls the predicate function for each element in the array until the predicate returns true, or until the end of the array.
- (value, index, array): boolean
Parameters
- value: bigint
- index: number
- array: BigInt64Array
Returns boolean
Optional
thisArg: anyAn object to which the this keyword can refer in the predicate function. If thisArg is omitted, undefined is used as the this value.
Returns boolean
- predicate: ((value: bigint, index: number, array: BigInt64Array) => boolean)
sort
- sort(compareFn?): this
Sorts the array.
Parameters
Optional
compareFn: ((a: bigint, b: bigint) => number | bigint)The function used to determine the order of the elements. If omitted, the elements are sorted in ascending order.
- (a, b): number | bigint
Parameters
- a: bigint
- b: bigint
Returns number | bigint
Returns this
subarray
- subarray(begin?, end?): BigInt64Array
Gets a new BigInt64Array view of the ArrayBuffer store for this array, referencing the elements at begin, inclusive, up to end, exclusive.
Parameters
Optional
begin: numberThe index of the beginning of the array.
Optional
end: numberThe index of the end of the array.
Returns BigInt64Array
toLocaleString
- to
Locale (locales?, options?): stringString Converts the array to a string by using the current locale.
Parameters
Optional
locales: string | string[]Optional
options: NumberFormatOptions
Returns string
toReversed
- to
Reversed (): BigInt64Array Copies the array and returns the copy with the elements in reverse order.
Returns BigInt64Array
toSorted
- to
Sorted (compareFn?): BigInt64Array Copies and sorts the array.
Parameters
Optional
compareFn: ((a: bigint, b: bigint) => number)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.
const myNums = BigInt64Array.from([11n, 2n, -22n, 1n]);
myNums.toSorted((a, b) => Number(a - b)) // BigInt64Array(4) [-22n, 1n, 2n, 11n]- (a, b): number
Parameters
- a: bigint
- b: bigint
Returns number
Returns BigInt64Array
toString
valueOf
- value
Of (): BigInt64Array Returns the primitive value of the specified object.
Returns BigInt64Array
values
- values(): ArrayIterator<bigint>
Yields each value in the array.
Returns ArrayIterator<bigint>
with
- with(index, value): BigInt64Array
Copies the array and inserts the given bigint at the provided index.
Parameters
- index: number
The index of the value to overwrite. If the index is negative, then it replaces from the end of the array.
- value: bigint
The value to insert into the copied array.
Returns BigInt64Array
A copy of the original array with the inserted value.
- index: number
The ArrayBuffer instance referenced by the array.