From ff81d3d1febf4bb8e2586762509c1e5eeeb3f33b Mon Sep 17 00:00:00 2001 From: stdlib-bot Date: Sat, 16 Dec 2023 23:20:04 +0000 Subject: [PATCH] Auto-generated commit --- .github/.keepalive | 1 - .github/workflows/benchmark.yml | 6 +- .github/workflows/examples.yml | 6 +- .github/workflows/npm_downloads.yml | 6 +- .github/workflows/productionize.yml | 34 ++--- .github/workflows/publish.yml | 6 +- .github/workflows/test.yml | 6 +- .github/workflows/test_bundles.yml | 16 +-- .github/workflows/test_coverage.yml | 6 +- .github/workflows/test_install.yml | 6 +- CONTRIBUTORS | 1 + README.md | 52 +++++++- benchmark/benchmark.at.js | 86 +++++++++++++ benchmark/benchmark.copy_within.js | 2 +- benchmark/benchmark.copy_within.length.js | 2 +- benchmark/benchmark.entries.js | 2 +- benchmark/benchmark.from.js | 2 +- benchmark/benchmark.get.js | 2 +- benchmark/benchmark.js | 2 +- benchmark/benchmark.length.js | 2 +- benchmark/benchmark.of.js | 2 +- benchmark/benchmark.set.js | 2 +- benchmark/benchmark.set.length.js | 2 +- dist/index.js | 2 +- dist/index.js.map | 4 +- docs/types/index.d.ts | 27 ++++ lib/main.js | 73 ++++++++++- package.json | 4 +- test/test.at.js | 147 ++++++++++++++++++++++ 29 files changed, 445 insertions(+), 64 deletions(-) delete mode 100644 .github/.keepalive create mode 100644 benchmark/benchmark.at.js create mode 100644 test/test.at.js diff --git a/.github/.keepalive b/.github/.keepalive deleted file mode 100644 index d510c00..0000000 --- a/.github/.keepalive +++ /dev/null @@ -1 +0,0 @@ -2023-12-01T05:38:56.265Z diff --git a/.github/workflows/benchmark.yml b/.github/workflows/benchmark.yml index ab56cca..30656c4 100644 --- a/.github/workflows/benchmark.yml +++ b/.github/workflows/benchmark.yml @@ -41,15 +41,15 @@ jobs: # Checkout the repository: - name: 'Checkout repository' - # Pin action to full length commit SHA corresponding to v4.1.0 - uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 + # Pin action to full length commit SHA + uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 # v4.1.0 # Install Node.js: - name: 'Install Node.js' # Pin action to full length commit SHA corresponding to v3.8.1 uses: actions/setup-node@5e21ff4d9bc1a8cf6de233a3057d20ec6b3fb69d with: - node-version: 16 + node-version: 20 timeout-minutes: 5 # Install dependencies: diff --git a/.github/workflows/examples.yml b/.github/workflows/examples.yml index c1c45e7..c92f5c4 100644 --- a/.github/workflows/examples.yml +++ b/.github/workflows/examples.yml @@ -41,15 +41,15 @@ jobs: # Checkout repository: - name: 'Checkout repository' - # Pin action to full length commit SHA corresponding to v4.1.0 - uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 + # Pin action to full length commit SHA + uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 # v4.1.0 # Install Node.js: - name: 'Install Node.js' # Pin action to full length commit SHA corresponding to v3.8.1 uses: actions/setup-node@5e21ff4d9bc1a8cf6de233a3057d20ec6b3fb69d with: - node-version: 16 + node-version: 20 timeout-minutes: 5 # Install dependencies: diff --git a/.github/workflows/npm_downloads.yml b/.github/workflows/npm_downloads.yml index 49ca224..5c77351 100644 --- a/.github/workflows/npm_downloads.yml +++ b/.github/workflows/npm_downloads.yml @@ -45,8 +45,8 @@ jobs: steps: # Checkout the repository: - name: 'Checkout repository' - # Pin action to full length commit SHA corresponding to v4.1.0 - uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 + # Pin action to full length commit SHA + uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 # v4.1.0 timeout-minutes: 10 # Install Node.js: @@ -54,7 +54,7 @@ jobs: # Pin action to full length commit SHA corresponding to v3.8.1 uses: actions/setup-node@5e21ff4d9bc1a8cf6de233a3057d20ec6b3fb69d with: - node-version: 16 + node-version: 20 timeout-minutes: 5 # Resolve package name: diff --git a/.github/workflows/productionize.yml b/.github/workflows/productionize.yml index 265afda..e1e3539 100644 --- a/.github/workflows/productionize.yml +++ b/.github/workflows/productionize.yml @@ -61,8 +61,8 @@ jobs: steps: # Checkout main branch of repository: - name: 'Checkout main branch' - # Pin action to full length commit SHA corresponding to v4.1.0 - uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 + # Pin action to full length commit SHA + uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 # v4.1.0 with: ref: main @@ -71,7 +71,7 @@ jobs: # Pin action to full length commit SHA corresponding to v3.8.1 uses: actions/setup-node@5e21ff4d9bc1a8cf6de233a3057d20ec6b3fb69d with: - node-version: 16 + node-version: 20 timeout-minutes: 5 # Create production branch: @@ -134,8 +134,8 @@ jobs: # Checkout the repository: - name: 'Checkout repository' if: ${{ github.event.inputs.require-passing-tests == 'true' }} - # Pin action to full length commit SHA corresponding to v4.1.0 - uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 + # Pin action to full length commit SHA + uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 # v4.1.0 with: # Use the `production` branch: ref: production @@ -146,7 +146,7 @@ jobs: # Pin action to full length commit SHA corresponding to v3.8.1 uses: actions/setup-node@5e21ff4d9bc1a8cf6de233a3057d20ec6b3fb69d with: - node-version: 16 + node-version: 20 timeout-minutes: 5 # Install dependencies: @@ -188,8 +188,8 @@ jobs: steps: # Checkout the repository: - name: 'Checkout repository' - # Pin action to full length commit SHA corresponding to v4.1.0 - uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 + # Pin action to full length commit SHA + uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 # v4.1.0 # Configure git: - name: 'Configure git' @@ -259,7 +259,7 @@ jobs: # Pin action to full length commit SHA corresponding to v3.8.1 uses: actions/setup-node@5e21ff4d9bc1a8cf6de233a3057d20ec6b3fb69d with: - node-version: 16 + node-version: 20 timeout-minutes: 5 # Install dependencies: @@ -364,8 +364,8 @@ jobs: steps: # Checkout the repository: - name: 'Checkout repository' - # Pin action to full length commit SHA corresponding to v4.1.0 - uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 + # Pin action to full length commit SHA + uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 # v4.1.0 # Configure git: - name: 'Configure git' @@ -427,7 +427,7 @@ jobs: # Pin action to full length commit SHA corresponding to v3.8.1 uses: actions/setup-node@5e21ff4d9bc1a8cf6de233a3057d20ec6b3fb69d with: - node-version: 16 + node-version: 20 timeout-minutes: 5 # Install dependencies: @@ -538,8 +538,8 @@ jobs: steps: # Checkout the repository: - name: 'Checkout repository' - # Pin action to full length commit SHA corresponding to v4.1.0 - uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 + # Pin action to full length commit SHA + uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 # v4.1.0 # Configure git: - name: 'Configure git' @@ -609,7 +609,7 @@ jobs: # Pin action to full length commit SHA corresponding to v3.8.1 uses: actions/setup-node@5e21ff4d9bc1a8cf6de233a3057d20ec6b3fb69d with: - node-version: 16 + node-version: 20 timeout-minutes: 5 # Install dependencies: @@ -719,8 +719,8 @@ jobs: # Checkout the repository: - name: 'Checkout repository' - # Pin action to full length commit SHA corresponding to v4.1.0 - uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 + # Pin action to full length commit SHA + uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 # v4.1.0 with: fetch-depth: 2 diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml index 8b8977f..1345024 100644 --- a/.github/workflows/publish.yml +++ b/.github/workflows/publish.yml @@ -61,15 +61,15 @@ jobs: # Checkout the repository: - name: 'Checkout repository' - # Pin action to full length commit SHA corresponding to v4.1.0 - uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 + # Pin action to full length commit SHA + uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 # v4.1.0 # Install Node.js: - name: 'Install Node.js' # Pin action to full length commit SHA corresponding to v3.8.1 uses: actions/setup-node@5e21ff4d9bc1a8cf6de233a3057d20ec6b3fb69d with: - node-version: 16 + node-version: 20 timeout-minutes: 5 # Configure git: diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml index b137590..829bcc3 100644 --- a/.github/workflows/test.yml +++ b/.github/workflows/test.yml @@ -58,15 +58,15 @@ jobs: # Checkout the repository: - name: 'Checkout repository' - # Pin action to full length commit SHA corresponding to v4.1.0 - uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 + # Pin action to full length commit SHA + uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 # v4.1.0 # Install Node.js: - name: 'Install Node.js' # Pin action to full length commit SHA corresponding to v3.8.1 uses: actions/setup-node@5e21ff4d9bc1a8cf6de233a3057d20ec6b3fb69d with: - node-version: 16 + node-version: 20 timeout-minutes: 5 # Install dependencies: diff --git a/.github/workflows/test_bundles.yml b/.github/workflows/test_bundles.yml index 0d26143..4c30492 100644 --- a/.github/workflows/test_bundles.yml +++ b/.github/workflows/test_bundles.yml @@ -49,8 +49,8 @@ jobs: steps: # Checkout UMD branch of the repository: - name: 'Checkout branch with UMD build' - # Pin action to full length commit SHA corresponding to v4.1.0 - uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 + # Pin action to full length commit SHA + uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 # v4.1.0 with: ref: umd @@ -59,7 +59,7 @@ jobs: # Pin action to full length commit SHA corresponding to v3.8.1 uses: actions/setup-node@5e21ff4d9bc1a8cf6de233a3057d20ec6b3fb69d with: - node-version: 17 + node-version: 20 # Try loading the UMD bundle: - name: 'Try loading UMD bundle' @@ -116,8 +116,8 @@ jobs: # Checkout ES modules branch of the repository: - name: 'Checkout branch with ESM build' - # Pin action to full length commit SHA corresponding to v4.1.0 - uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 + # Pin action to full length commit SHA + uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 # v4.1.0 with: ref: esm @@ -126,7 +126,7 @@ jobs: # Pin action to full length commit SHA corresponding to v3.8.1 uses: actions/setup-node@5e21ff4d9bc1a8cf6de233a3057d20ec6b3fb69d with: - node-version: 17 + node-version: 20 # Try loading the ES module bundle: - name: 'Try loading ESM' @@ -161,8 +161,8 @@ jobs: # Checkout Deno branch of the repository: - name: 'Checkout branch with Deno build' - # Pin action to full length commit SHA corresponding to v4.1.0 - uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 + # Pin action to full length commit SHA + uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 # v4.1.0 with: ref: deno diff --git a/.github/workflows/test_coverage.yml b/.github/workflows/test_coverage.yml index 5b2b1ea..25dcbef 100644 --- a/.github/workflows/test_coverage.yml +++ b/.github/workflows/test_coverage.yml @@ -46,15 +46,15 @@ jobs: # Checkout the repository: - name: 'Checkout repository' - # Pin action to full length commit SHA corresponding to v4.1.0 - uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 + # Pin action to full length commit SHA + uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 # v4.1.0 # Install Node.js: - name: 'Install Node.js' # Pin action to full length commit SHA corresponding to v3.8.1 uses: actions/setup-node@5e21ff4d9bc1a8cf6de233a3057d20ec6b3fb69d with: - node-version: 16 + node-version: 20 timeout-minutes: 5 # Install dependencies: diff --git a/.github/workflows/test_install.yml b/.github/workflows/test_install.yml index 932be5a..bcc2dda 100644 --- a/.github/workflows/test_install.yml +++ b/.github/workflows/test_install.yml @@ -58,15 +58,15 @@ jobs: # Checkout the repository: - name: 'Checkout repository' - # Pin action to full length commit SHA corresponding to v4.1.0 - uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 + # Pin action to full length commit SHA + uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 # v4.1.0 # Install Node.js: - name: 'Install Node.js' # Pin action to full length commit SHA corresponding to v3.8.1 uses: actions/setup-node@5e21ff4d9bc1a8cf6de233a3057d20ec6b3fb69d with: - node-version: 16 + node-version: 20 timeout-minutes: 5 # Install dependencies: diff --git a/CONTRIBUTORS b/CONTRIBUTORS index 188cda8..af2a74f 100644 --- a/CONTRIBUTORS +++ b/CONTRIBUTORS @@ -15,6 +15,7 @@ Dorrin Sotoudeh Frank Kovacs Harshita Kalani James Gelok +Jaysukh Makvana <111515433+Jaysukh-409@users.noreply.github.com> Jithin KS Joey Reed Jordan Gallivan <115050475+Jordan-Gallivan@users.noreply.github.com> diff --git a/README.md b/README.md index d75c914..2584582 100644 --- a/README.md +++ b/README.md @@ -783,7 +783,7 @@ var bool = it.next().done; #### Complex64Array.prototype.get( i ) -Returns an array element located at position (index) `i`. +Returns an array element located at a nonnegative integer position (index) `i`. ```javascript var realf = require( '@stdlib/complex-realf' ); @@ -814,6 +814,56 @@ var z = arr.get( 100 ); // returns undefined ``` + + +#### Complex64Array.prototype.at( i ) + +Returns an array element located at integer position (index) `i`, with support for both nonnegative and negative integer positions. + +```javascript +var realf = require( '@stdlib/complex-realf' ); +var imagf = require( '@stdlib/complex-imagf' ); + +var arr = new Complex64Array( 10 ); + +// Set the first, second, and last elements: +arr.set( [ 1.0, -1.0 ], 0 ); +arr.set( [ 2.0, -2.0 ], 1 ); +arr.set( [ 9.0, -9.0 ], 9 ); + +// Get the first element: +var z = arr.at( 0 ); +// returns + +var re = realf( z ); +// returns 1.0 + +var im = imagf( z ); +// returns -1.0 + +// Get the last element: +z = arr.at( -1 ); +// returns + +re = realf( z ); +// returns 9.0 + +im = imagf( z ); +// returns -9.0 +``` + +If provided an out-of-bounds index, the method returns `undefined`. + +```javascript +var arr = new Complex64Array( 10 ); + +var z = arr.at( 100 ); +// returns undefined + +z = arr.at( -100 ); +// returns undefined +``` + #### Complex64Array.prototype.set( z\[, i] ) diff --git a/benchmark/benchmark.at.js b/benchmark/benchmark.at.js new file mode 100644 index 0000000..5c4feae --- /dev/null +++ b/benchmark/benchmark.at.js @@ -0,0 +1,86 @@ +/** +* @license Apache-2.0 +* +* Copyright (c) 2023 The Stdlib Authors. +* +* 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 +* +* Unless required by applicable law or agreed to in writing, software +* distributed under the License is distributed on an "AS IS" BASIS, +* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +* See the License for the specific language governing permissions and +* limitations under the License. +*/ + +'use strict'; + +// MODULES // + +var bench = require( '@stdlib/bench-harness' ); +var Complex64 = require( '@stdlib/complex-float32' ); +var isComplex64 = require( '@stdlib/assert-is-complex64' ); +var pkg = require( './../package.json' ).name; +var Complex64Array = require( './../lib' ); + + +// MAIN // + +bench( pkg+'::nonnegative_indices:at', function benchmark( b ) { + var arr; + var N; + var z; + var i; + + arr = []; + for ( i = 0; i < 10; i++ ) { + arr.push( new Complex64( i, i ) ); + } + arr = new Complex64Array( arr ); + N = arr.length; + + b.tic(); + for ( i = 0; i < b.iterations; i++ ) { + z = arr.at( i%N ); + if ( typeof z !== 'object' ) { + b.fail( 'should return an object' ); + } + } + b.toc(); + if ( !isComplex64( z ) ) { + b.fail( 'should return a complex number' ); + } + b.pass( 'benchmark finished' ); + b.end(); +}); + +bench( pkg+'::negative_indices:at', function benchmark( b ) { + var arr; + var N; + var z; + var i; + + arr = []; + for ( i = 0; i < 10; i++ ) { + arr.push( new Complex64( i, i ) ); + } + arr = new Complex64Array( arr ); + N = arr.length; + + b.tic(); + for ( i = 0; i < b.iterations; i++ ) { + z = arr.at( -(i%N)-1 ); + if ( typeof z !== 'object' ) { + b.fail( 'should return an object' ); + } + } + b.toc(); + if ( !isComplex64( z ) ) { + b.fail( 'should return a complex number' ); + } + b.pass( 'benchmark finished' ); + b.end(); +}); diff --git a/benchmark/benchmark.copy_within.js b/benchmark/benchmark.copy_within.js index 2f6afbd..16dd0c1 100644 --- a/benchmark/benchmark.copy_within.js +++ b/benchmark/benchmark.copy_within.js @@ -20,7 +20,7 @@ // MODULES // -var bench = require( '@stdlib/bench' ); +var bench = require( '@stdlib/bench-harness' ); var Complex64 = require( '@stdlib/complex-float32' ); var pkg = require( './../package.json' ).name; var Complex64Array = require( './../lib' ); diff --git a/benchmark/benchmark.copy_within.length.js b/benchmark/benchmark.copy_within.length.js index 3afe5be..4eb93fc 100644 --- a/benchmark/benchmark.copy_within.length.js +++ b/benchmark/benchmark.copy_within.length.js @@ -20,7 +20,7 @@ // MODULES // -var bench = require( '@stdlib/bench' ); +var bench = require( '@stdlib/bench-harness' ); var pow = require( '@stdlib/math-base-special-pow' ); var Complex64 = require( '@stdlib/complex-float32' ); var pkg = require( './../package.json' ).name; diff --git a/benchmark/benchmark.entries.js b/benchmark/benchmark.entries.js index f4e9c44..5709408 100644 --- a/benchmark/benchmark.entries.js +++ b/benchmark/benchmark.entries.js @@ -20,7 +20,7 @@ // MODULES // -var bench = require( '@stdlib/bench' ); +var bench = require( '@stdlib/bench-harness' ); var Complex64 = require( '@stdlib/complex-float32' ); var pkg = require( './../package.json' ).name; var Complex64Array = require( './../lib' ); diff --git a/benchmark/benchmark.from.js b/benchmark/benchmark.from.js index f8424b0..f6a3f7c 100644 --- a/benchmark/benchmark.from.js +++ b/benchmark/benchmark.from.js @@ -20,7 +20,7 @@ // MODULES // -var bench = require( '@stdlib/bench' ); +var bench = require( '@stdlib/bench-harness' ); var Float32Array = require( '@stdlib/array-float32' ); var ITERATOR_SYMBOL = require( '@stdlib/symbol-iterator' ); var pkg = require( './../package.json' ).name; diff --git a/benchmark/benchmark.get.js b/benchmark/benchmark.get.js index d34da47..ffd8192 100644 --- a/benchmark/benchmark.get.js +++ b/benchmark/benchmark.get.js @@ -20,7 +20,7 @@ // MODULES // -var bench = require( '@stdlib/bench' ); +var bench = require( '@stdlib/bench-harness' ); var Complex64 = require( '@stdlib/complex-float32' ); var isComplex64 = require( '@stdlib/assert-is-complex64' ); var pkg = require( './../package.json' ).name; diff --git a/benchmark/benchmark.js b/benchmark/benchmark.js index dfc2d78..633822b 100644 --- a/benchmark/benchmark.js +++ b/benchmark/benchmark.js @@ -20,7 +20,7 @@ // MODULES // -var bench = require( '@stdlib/bench' ); +var bench = require( '@stdlib/bench-harness' ); var ArrayBuffer = require( '@stdlib/array-buffer' ); var Float32Array = require( '@stdlib/array-float32' ); var isArrayBuffer = require( '@stdlib/assert-is-arraybuffer' ); diff --git a/benchmark/benchmark.length.js b/benchmark/benchmark.length.js index 68a6041..89c4808 100644 --- a/benchmark/benchmark.length.js +++ b/benchmark/benchmark.length.js @@ -20,7 +20,7 @@ // MODULES // -var bench = require( '@stdlib/bench' ); +var bench = require( '@stdlib/bench-harness' ); var pow = require( '@stdlib/math-base-special-pow' ); var pkg = require( './../package.json' ).name; var Complex64Array = require( './../lib' ); diff --git a/benchmark/benchmark.of.js b/benchmark/benchmark.of.js index 6b72e68..9c11c59 100644 --- a/benchmark/benchmark.of.js +++ b/benchmark/benchmark.of.js @@ -20,7 +20,7 @@ // MODULES // -var bench = require( '@stdlib/bench' ); +var bench = require( '@stdlib/bench-harness' ); var Complex64 = require( '@stdlib/complex-float32' ); var pkg = require( './../package.json' ).name; var Complex64Array = require( './../lib' ); diff --git a/benchmark/benchmark.set.js b/benchmark/benchmark.set.js index fb98f56..98116ca 100644 --- a/benchmark/benchmark.set.js +++ b/benchmark/benchmark.set.js @@ -20,7 +20,7 @@ // MODULES // -var bench = require( '@stdlib/bench' ); +var bench = require( '@stdlib/bench-harness' ); var Float32Array = require( '@stdlib/array-float32' ); var Complex64 = require( '@stdlib/complex-float32' ); var pkg = require( './../package.json' ).name; diff --git a/benchmark/benchmark.set.length.js b/benchmark/benchmark.set.length.js index 96bf6a9..b646231 100644 --- a/benchmark/benchmark.set.length.js +++ b/benchmark/benchmark.set.length.js @@ -20,7 +20,7 @@ // MODULES // -var bench = require( '@stdlib/bench' ); +var bench = require( '@stdlib/bench-harness' ); var pow = require( '@stdlib/math-base-special-pow' ); var randu = require( '@stdlib/random-base-randu' ); var Complex64 = require( '@stdlib/complex-float32' ); diff --git a/dist/index.js b/dist/index.js index ae51373..711eb64 100644 --- a/dist/index.js +++ b/dist/index.js @@ -1,4 +1,4 @@ -"use strict";var q=function(n,t){return function(){return t||n((t={exports:{}}).exports,t),t.exports}};var C=q(function(Er,B){"use strict";var D=require("@stdlib/assert-is-array-like-object"),J=require("@stdlib/assert-is-complex-like"),K=require("@stdlib/complex-realf"),Q=require("@stdlib/complex-imagf"),U=require("@stdlib/string-format");function X(n){var t,r,e;for(t=[];r=n.next(),!r.done;)if(e=r.value,D(e)&&e.length>=2)t.push(e[0],e[1]);else if(J(e))t.push(K(e),Q(e));else return new TypeError(U("invalid argument. An iterator must return either a two-element array containing real and imaginary components or a complex number. Value: `%s`.",e));return t}B.exports=X});var O=q(function(dr,V){"use strict";var Z=require("@stdlib/assert-is-array-like-object"),$=require("@stdlib/assert-is-complex-like"),rr=require("@stdlib/complex-realf"),er=require("@stdlib/complex-imagf"),tr=require("@stdlib/string-format");function nr(n,t,r){var e,o,i,u;for(e=[],u=-1;o=n.next(),!o.done;)if(u+=1,i=t.call(r,o.value,u),Z(i)&&i.length>=2)e.push(i[0],i[1]);else if($(i))e.push(rr(i),er(i));else return new TypeError(tr("invalid argument. Callback must return either a two-element array containing real and imaginary components or a complex number. Value: `%s`.",i));return e}V.exports=nr});var S=q(function(Tr,M){"use strict";var ar=require("@stdlib/assert-is-complex-like"),ir=require("@stdlib/complex-realf"),or=require("@stdlib/complex-imagf");function ur(n,t){var r,e,o,i;for(r=t.length,i=0,o=0;or.byteLength-n)throw new RangeError(l("invalid arguments. ArrayBuffer has insufficient capacity. Either decrease the array length or provide a bigger buffer. Minimum capacity: `%u`.",e*y));r=new c(r,n,e*2)}}return v(this,"_buffer",r),v(this,"_length",r.length/2),this}v(g,"BYTES_PER_ELEMENT",y);v(g,"name","Complex64Array");v(g,"from",function(t){var r,e,o,i,u,f,w,a,h,m,s,p;if(!b(this))throw new TypeError("invalid invocation. `this` context must be a constructor.");if(!z(this))throw new TypeError("invalid invocation. `this` is not a complex number array.");if(e=arguments.length,e>1){if(o=arguments[1],!b(o))throw new TypeError(l("invalid argument. Second argument must be a function. Value: `%s`.",o));e>2&&(r=arguments[2])}if(T(t)){if(a=t.length,o){for(i=new this(a),u=i._buffer,p=0,s=0;s=2)u[p]=m[0],u[p+1]=m[1];else throw new TypeError(l("invalid argument. Callback must return either a two-element array containing real and imaginary components or a complex number. Value: `%s`.",m));p+=2}return i}return new this(t)}if(j(t)){if(o){for(a=t.length,t.get&&t.set?w=hr("default"):w=gr("default"),s=0;s=2)u[p]=m[0],u[p+1]=m[1];else throw new TypeError(l("invalid argument. Callback must return either a two-element array containing real and imaginary components or a complex number. Value: `%s`.",m));p+=2}return i}return new this(t)}if(Y(t)&&W&&b(t[d])){if(u=t[d](),!b(u.next))throw new TypeError(l("invalid argument. First argument must be an array-like object or an iterable. Value: `%s`.",t));if(o?f=vr(u,o,r):f=P(u),f instanceof Error)throw f;for(a=f.length/2,i=new this(a),u=i._buffer,s=0;s=o?{done:!0}:(f+=2,m=new F(t[f],t[f+1]),{value:[u,m],done:!1})}function a(m){return i=!0,arguments.length?{value:m,done:!0}:{done:!0}}function h(){return r.entries()}});v(g.prototype,"get",function(t){var r;if(!T(this))throw new TypeError("invalid invocation. `this` is not a complex number array.");if(!_(t))throw new TypeError(l("invalid argument. Must provide a nonnegative integer. Value: `%s`.",t));if(!(t>=this._length))return r=this._buffer,t*=2,new F(r[t],r[t+1])});k(g.prototype,"length",function(){return this._length});v(g.prototype,"set",function(t){var r,e,o,i,u,f,w,a,h;if(!T(this))throw new TypeError("invalid invocation. `this` is not a complex number array.");if(o=this._buffer,arguments.length>1){if(e=arguments[1],!_(e))throw new TypeError(l("invalid argument. Index argument must be a nonnegative integer. Value: `%s`.",e))}else e=0;if(E(t)){if(e>=this._length)throw new RangeError(l("invalid argument. Index argument is out-of-bounds. Value: `%u`.",e));e*=2,o[e]=A(t),o[e+1]=L(t);return}if(T(t)){if(f=t._length,e+f>this._length)throw new RangeError("invalid arguments. Target array lacks sufficient storage to accommodate source values.");if(r=t._buffer,h=o.byteOffset+e*y,r.buffer===o.buffer&&r.byteOffseth){for(i=new c(r.length),a=0;athis._length)throw new RangeError("invalid arguments. Target array lacks sufficient storage to accommodate source values.");if(r=t,h=o.byteOffset+e*y,r.buffer===o.buffer&&r.byteOffseth){for(i=new c(f),a=0;athis._length)throw new RangeError("invalid arguments. Target array lacks sufficient storage to accommodate source values.");for(e*=2,a=0;a=2)e.push(t[0],t[1]);else if(J(t))e.push(K(t),Q(t));else return new TypeError(U("invalid argument. An iterator must return either a two-element array containing real and imaginary components or a complex number. Value: `%s`.",t));return e}C.exports=X});var M=q(function(dr,O){"use strict";var Z=require("@stdlib/assert-is-array-like-object"),$=require("@stdlib/assert-is-complex-like"),rr=require("@stdlib/complex-realf"),er=require("@stdlib/complex-imagf"),tr=require("@stdlib/string-format");function nr(n,e,r){var t,o,i,u;for(t=[],u=-1;o=n.next(),!o.done;)if(u+=1,i=e.call(r,o.value,u),Z(i)&&i.length>=2)t.push(i[0],i[1]);else if($(i))t.push(rr(i),er(i));else return new TypeError(tr("invalid argument. Callback must return either a two-element array containing real and imaginary components or a complex number. Value: `%s`.",i));return t}O.exports=nr});var I=q(function(Tr,S){"use strict";var ar=require("@stdlib/assert-is-complex-like"),ir=require("@stdlib/complex-realf"),or=require("@stdlib/complex-imagf");function ur(n,e){var r,t,o,i;for(r=e.length,i=0,o=0;or.byteLength-n)throw new RangeError(l("invalid arguments. ArrayBuffer has insufficient capacity. Either decrease the array length or provide a bigger buffer. Minimum capacity: `%u`.",t*y));r=new c(r,n,t*2)}}return v(this,"_buffer",r),v(this,"_length",r.length/2),this}v(g,"BYTES_PER_ELEMENT",y);v(g,"name","Complex64Array");v(g,"from",function(e){var r,t,o,i,u,f,w,a,h,m,s,p;if(!b(this))throw new TypeError("invalid invocation. `this` context must be a constructor.");if(!z(this))throw new TypeError("invalid invocation. `this` is not a complex number array.");if(t=arguments.length,t>1){if(o=arguments[1],!b(o))throw new TypeError(l("invalid argument. Second argument must be a function. Value: `%s`.",o));t>2&&(r=arguments[2])}if(E(e)){if(a=e.length,o){for(i=new this(a),u=i._buffer,p=0,s=0;s=2)u[p]=m[0],u[p+1]=m[1];else throw new TypeError(l("invalid argument. Callback must return either a two-element array containing real and imaginary components or a complex number. Value: `%s`.",m));p+=2}return i}return new this(e)}if(j(e)){if(o){for(a=e.length,e.get&&e.set?w=hr("default"):w=gr("default"),s=0;s=2)u[p]=m[0],u[p+1]=m[1];else throw new TypeError(l("invalid argument. Callback must return either a two-element array containing real and imaginary components or a complex number. Value: `%s`.",m));p+=2}return i}return new this(e)}if(F(e)&&W&&b(e[T])){if(u=e[T](),!b(u.next))throw new TypeError(l("invalid argument. First argument must be an array-like object or an iterable. Value: `%s`.",e));if(o?f=vr(u,o,r):f=P(u),f instanceof Error)throw f;for(a=f.length/2,i=new this(a),u=i._buffer,s=0;s=o?{done:!0}:(f+=2,m=new B(e[f],e[f+1]),{value:[u,m],done:!1})}function a(m){return i=!0,arguments.length?{value:m,done:!0}:{done:!0}}function h(){return r.entries()}});v(g.prototype,"get",function(e){var r;if(!E(this))throw new TypeError("invalid invocation. `this` is not a complex number array.");if(!_(e))throw new TypeError(l("invalid argument. Must provide a nonnegative integer. Value: `%s`.",e));if(!(e>=this._length))return r=this._buffer,e*=2,new B(r[e],r[e+1])});v(g.prototype,"at",function(e){var r;if(!E(this))throw new TypeError("invalid invocation. `this` is not a complex number array.");if(!A(e))throw new TypeError(l("invalid argument. Must provide a integer. Value: `%s`.",e));if(e<0&&(e+=this._length),!(e<0||e>=this._length))return r=this._buffer,e*=2,new B(r[e],r[e+1])});R(g.prototype,"length",function(){return this._length});v(g.prototype,"set",function(e){var r,t,o,i,u,f,w,a,h;if(!E(this))throw new TypeError("invalid invocation. `this` is not a complex number array.");if(o=this._buffer,arguments.length>1){if(t=arguments[1],!_(t))throw new TypeError(l("invalid argument. Index argument must be a nonnegative integer. Value: `%s`.",t))}else t=0;if(d(e)){if(t>=this._length)throw new RangeError(l("invalid argument. Index argument is out-of-bounds. Value: `%u`.",t));t*=2,o[t]=L(e),o[t+1]=k(e);return}if(E(e)){if(f=e._length,t+f>this._length)throw new RangeError("invalid arguments. Target array lacks sufficient storage to accommodate source values.");if(r=e._buffer,h=o.byteOffset+t*y,r.buffer===o.buffer&&r.byteOffseth){for(i=new c(r.length),a=0;athis._length)throw new RangeError("invalid arguments. Target array lacks sufficient storage to accommodate source values.");if(r=e,h=o.byteOffset+t*y,r.buffer===o.buffer&&r.byteOffseth){for(i=new c(f),a=0;athis._length)throw new RangeError("invalid arguments. Target array lacks sufficient storage to accommodate source values.");for(t*=2,a=0;a= 2 ) {\n\t\t\tout.push( z[ 0 ], z[ 1 ] );\n\t\t} else if ( isComplexLike( z ) ) {\n\t\t\tout.push( realf( z ), imagf( z ) );\n\t\t} else {\n\t\t\treturn new TypeError( format( 'invalid argument. An iterator must return either a two-element array containing real and imaginary components or a complex number. Value: `%s`.', z ) );\n\t\t}\n\t}\n\treturn out;\n}\n\n\n// EXPORTS //\n\nmodule.exports = fromIterator;\n", "/**\n* @license Apache-2.0\n*\n* Copyright (c) 2018 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n* http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n// MODULES //\n\nvar isArrayLikeObject = require( '@stdlib/assert-is-array-like-object' );\nvar isComplexLike = require( '@stdlib/assert-is-complex-like' );\nvar realf = require( '@stdlib/complex-realf' );\nvar imagf = require( '@stdlib/complex-imagf' );\nvar format = require( '@stdlib/string-format' );\n\n\n// MAIN //\n\n/**\n* Returns an array of iterated values.\n*\n* @private\n* @param {Object} it - iterator\n* @param {Function} clbk - callback to invoke for each iterated value\n* @param {*} thisArg - invocation context\n* @returns {(Array|TypeError)} array or an error\n*/\nfunction fromIteratorMap( it, clbk, thisArg ) {\n\tvar out;\n\tvar v;\n\tvar z;\n\tvar i;\n\n\tout = [];\n\ti = -1;\n\twhile ( true ) {\n\t\tv = it.next();\n\t\tif ( v.done ) {\n\t\t\tbreak;\n\t\t}\n\t\ti += 1;\n\t\tz = clbk.call( thisArg, v.value, i );\n\t\tif ( isArrayLikeObject( z ) && z.length >= 2 ) {\n\t\t\tout.push( z[ 0 ], z[ 1 ] );\n\t\t} else if ( isComplexLike( z ) ) {\n\t\t\tout.push( realf( z ), imagf( z ) );\n\t\t} else {\n\t\t\treturn new TypeError( format( 'invalid argument. Callback must return either a two-element array containing real and imaginary components or a complex number. Value: `%s`.', z ) );\n\t\t}\n\t}\n\treturn out;\n}\n\n\n// EXPORTS //\n\nmodule.exports = fromIteratorMap;\n", "/**\n* @license Apache-2.0\n*\n* Copyright (c) 2018 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n* http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n// MODULES //\n\nvar isComplexLike = require( '@stdlib/assert-is-complex-like' );\nvar realf = require( '@stdlib/complex-realf' );\nvar imagf = require( '@stdlib/complex-imagf' );\n\n\n// MAIN //\n\n/**\n* Returns a strided array of real and imaginary components.\n*\n* @private\n* @param {Float32Array} buf - output array\n* @param {Array} arr - array containing complex numbers\n* @returns {(Float32Array|null)} output array or null\n*/\nfunction fromArray( buf, arr ) {\n\tvar len;\n\tvar v;\n\tvar i;\n\tvar j;\n\n\tlen = arr.length;\n\tj = 0;\n\tfor ( i = 0; i < len; i++ ) {\n\t\tv = arr[ i ];\n\t\tif ( !isComplexLike( v ) ) {\n\t\t\treturn null;\n\t\t}\n\t\tbuf[ j ] = realf( v );\n\t\tbuf[ j+1 ] = imagf( v );\n\t\tj += 2; // stride\n\t}\n\treturn buf;\n}\n\n\n// EXPORTS //\n\nmodule.exports = fromArray;\n", "/* eslint-disable no-restricted-syntax, max-lines, no-invalid-this */\n\n/**\n* @license Apache-2.0\n*\n* Copyright (c) 2018 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n* http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n// MODULES //\n\nvar isNonNegativeInteger = require( '@stdlib/assert-is-nonnegative-integer' ).isPrimitive;\nvar isArrayLikeObject = require( '@stdlib/assert-is-array-like-object' );\nvar isCollection = require( '@stdlib/assert-is-collection' );\nvar isArrayBuffer = require( '@stdlib/assert-is-arraybuffer' );\nvar isObject = require( '@stdlib/assert-is-object' );\nvar isArray = require( '@stdlib/assert-is-array' );\nvar isFunction = require( '@stdlib/assert-is-function' );\nvar isComplexLike = require( '@stdlib/assert-is-complex-like' );\nvar isEven = require( '@stdlib/math-base-assert-is-even' );\nvar isInteger = require( '@stdlib/math-base-assert-is-integer' );\nvar hasIteratorSymbolSupport = require( '@stdlib/assert-has-iterator-symbol-support' );\nvar ITERATOR_SYMBOL = require( '@stdlib/symbol-iterator' );\nvar setReadOnly = require( '@stdlib/utils-define-nonenumerable-read-only-property' );\nvar setReadOnlyAccessor = require( '@stdlib/utils-define-nonenumerable-read-only-accessor' );\nvar Float32Array = require( '@stdlib/array-float32' );\nvar Complex64 = require( '@stdlib/complex-float32' );\nvar format = require( '@stdlib/string-format' );\nvar realf = require( '@stdlib/complex-realf' );\nvar imagf = require( '@stdlib/complex-imagf' );\nvar reinterpret64 = require( '@stdlib/strided-base-reinterpret-complex64' );\nvar reinterpret128 = require( '@stdlib/strided-base-reinterpret-complex128' );\nvar getter = require( '@stdlib/array-base-getter' );\nvar accessorGetter = require( '@stdlib/array-base-accessor-getter' );\nvar fromIterator = require( './from_iterator.js' );\nvar fromIteratorMap = require( './from_iterator_map.js' );\nvar fromArray = require( './from_array.js' );\n\n\n// VARIABLES //\n\nvar BYTES_PER_ELEMENT = Float32Array.BYTES_PER_ELEMENT * 2;\nvar HAS_ITERATOR_SYMBOL = hasIteratorSymbolSupport();\n\n\n// FUNCTIONS //\n\n/**\n* Returns a boolean indicating if a value is a complex typed array.\n*\n* @private\n* @param {*} value - value to test\n* @returns {boolean} boolean indicating if a value is a complex typed array\n*/\nfunction isComplexArray( value ) {\n\treturn (\n\t\tvalue instanceof Complex64Array ||\n\t\t(\n\t\t\ttypeof value === 'object' &&\n\t\t\tvalue !== null &&\n\t\t\t(\n\t\t\t\tvalue.constructor.name === 'Complex64Array' ||\n\t\t\t\tvalue.constructor.name === 'Complex128Array'\n\t\t\t) &&\n\t\t\ttypeof value._length === 'number' && // eslint-disable-line no-underscore-dangle\n\n\t\t\t// NOTE: we don't perform a more rigorous test here for a typed array for performance reasons, as robustly checking for a typed array instance could require walking the prototype tree and performing relatively expensive constructor checks...\n\t\t\ttypeof value._buffer === 'object' // eslint-disable-line no-underscore-dangle\n\t\t)\n\t);\n}\n\n/**\n* Returns a boolean indicating if a value is a complex typed array constructor.\n*\n* @private\n* @param {*} value - value to test\n* @returns {boolean} boolean indicating if a value is a complex typed array constructor\n*/\nfunction isComplexArrayConstructor( value ) {\n\treturn (\n\t\tvalue === Complex64Array ||\n\n\t\t// NOTE: weaker test in order to avoid a circular dependency with Complex128Array...\n\t\tvalue.name === 'Complex128Array'\n\t);\n}\n\n/**\n* Returns a boolean indicating if a value is a `Complex64Array`.\n*\n* @private\n* @param {*} value - value to test\n* @returns {boolean} boolean indicating if a value is a `Complex64Array`\n*/\nfunction isComplex64Array( value ) {\n\treturn (\n\t\ttypeof value === 'object' &&\n\t\tvalue !== null &&\n\t\tvalue.constructor.name === 'Complex64Array' &&\n\t\tvalue.BYTES_PER_ELEMENT === BYTES_PER_ELEMENT\n\t);\n}\n\n/**\n* Returns a boolean indicating if a value is a `Complex128Array`.\n*\n* @private\n* @param {*} value - value to test\n* @returns {boolean} boolean indicating if a value is a `Complex128Array`\n*/\nfunction isComplex128Array( value ) {\n\treturn (\n\t\ttypeof value === 'object' &&\n\t\tvalue !== null &&\n\t\tvalue.constructor.name === 'Complex128Array' &&\n\t\tvalue.BYTES_PER_ELEMENT === BYTES_PER_ELEMENT*2\n\t);\n}\n\n\n// MAIN //\n\n/**\n* 64-bit complex number array constructor.\n*\n* @constructor\n* @param {(NonNegativeInteger|Collection|ArrayBuffer|Iterable)} [arg] - length, typed array, array-like object, buffer, or an iterable\n* @param {NonNegativeInteger} [byteOffset=0] - byte offset\n* @param {NonNegativeInteger} [length] - view length\n* @throws {RangeError} ArrayBuffer byte length must be a multiple of `8`\n* @throws {RangeError} array-like object and typed array input arguments must have a length which is a multiple of two\n* @throws {TypeError} if provided only a single argument, must provide a valid argument\n* @throws {TypeError} byte offset must be a nonnegative integer\n* @throws {RangeError} byte offset must be a multiple of `8`\n* @throws {TypeError} view length must be a positive multiple of `8`\n* @throws {RangeError} must provide sufficient memory to accommodate byte offset and view length requirements\n* @throws {TypeError} an iterator must return either a two element array containing real and imaginary components or a complex number\n* @returns {Complex64Array} complex number array\n*\n* @example\n* var arr = new Complex64Array();\n* // returns \n*\n* var len = arr.length;\n* // returns 0\n*\n* @example\n* var arr = new Complex64Array( 2 );\n* // returns \n*\n* var len = arr.length;\n* // returns 2\n*\n* @example\n* var arr = new Complex64Array( [ 1.0, -1.0 ] );\n* // returns \n*\n* var len = arr.length;\n* // returns 1\n*\n* @example\n* var ArrayBuffer = require( '@stdlib/array-buffer' );\n*\n* var buf = new ArrayBuffer( 16 );\n* var arr = new Complex64Array( buf );\n* // returns \n*\n* var len = arr.length;\n* // returns 2\n*\n* @example\n* var ArrayBuffer = require( '@stdlib/array-buffer' );\n*\n* var buf = new ArrayBuffer( 16 );\n* var arr = new Complex64Array( buf, 8 );\n* // returns \n*\n* var len = arr.length;\n* // returns 1\n*\n* @example\n* var ArrayBuffer = require( '@stdlib/array-buffer' );\n*\n* var buf = new ArrayBuffer( 32 );\n* var arr = new Complex64Array( buf, 8, 2 );\n* // returns \n*\n* var len = arr.length;\n* // returns 2\n*/\nfunction Complex64Array() {\n\tvar byteOffset;\n\tvar nargs;\n\tvar buf;\n\tvar len;\n\n\tnargs = arguments.length;\n\tif ( !(this instanceof Complex64Array) ) {\n\t\tif ( nargs === 0 ) {\n\t\t\treturn new Complex64Array();\n\t\t}\n\t\tif ( nargs === 1 ) {\n\t\t\treturn new Complex64Array( arguments[0] );\n\t\t}\n\t\tif ( nargs === 2 ) {\n\t\t\treturn new Complex64Array( arguments[0], arguments[1] );\n\t\t}\n\t\treturn new Complex64Array( arguments[0], arguments[1], arguments[2] );\n\t}\n\t// Create the underlying data buffer...\n\tif ( nargs === 0 ) {\n\t\tbuf = new Float32Array( 0 ); // backward-compatibility\n\t} else if ( nargs === 1 ) {\n\t\tif ( isNonNegativeInteger( arguments[0] ) ) {\n\t\t\tbuf = new Float32Array( arguments[0]*2 );\n\t\t} else if ( isCollection( arguments[0] ) ) {\n\t\t\tbuf = arguments[ 0 ];\n\t\t\tlen = buf.length;\n\n\t\t\t// If provided a \"generic\" array, peak at the first value, and, if the value is a complex number, try to process as an array of complex numbers, falling back to \"normal\" typed array initialization if we fail and ensuring consistency if the first value had not been a complex number...\n\t\t\tif ( len && isArray( buf ) && isComplexLike( buf[0] ) ) {\n\t\t\t\tbuf = fromArray( new Float32Array( len*2 ), buf );\n\t\t\t\tif ( buf === null ) {\n\t\t\t\t\t// We failed and we are now forced to allocate a new array :-(\n\t\t\t\t\tif ( !isEven( len ) ) {\n\t\t\t\t\t\tthrow new RangeError( format( 'invalid argument. Array-like object arguments must have a length which is a multiple of two. Length: `%u`.', len ) );\n\t\t\t\t\t}\n\t\t\t\t\t// We failed, so fall back to directly setting values...\n\t\t\t\t\tbuf = new Float32Array( arguments[0] );\n\t\t\t\t}\n\t\t\t} else {\n\t\t\t\tif ( isComplex64Array( buf ) ) {\n\t\t\t\t\tbuf = reinterpret64( buf, 0 );\n\t\t\t\t} else if ( isComplex128Array( buf ) ) {\n\t\t\t\t\tbuf = reinterpret128( buf, 0 );\n\t\t\t\t} else if ( !isEven( len ) ) {\n\t\t\t\t\tthrow new RangeError( format( 'invalid argument. Array-like object and typed array arguments must have a length which is a multiple of two. Length: `%u`.', len ) );\n\t\t\t\t}\n\t\t\t\tbuf = new Float32Array( buf );\n\t\t\t}\n\t\t} else if ( isArrayBuffer( arguments[0] ) ) {\n\t\t\tbuf = arguments[ 0 ];\n\t\t\tif ( !isInteger( buf.byteLength/BYTES_PER_ELEMENT ) ) {\n\t\t\t\tthrow new RangeError( format( 'invalid argument. ArrayBuffer byte length must be a multiple of %u. Byte length: `%u`.', BYTES_PER_ELEMENT, buf.byteLength ) );\n\t\t\t}\n\t\t\tbuf = new Float32Array( buf );\n\t\t} else if ( isObject( arguments[0] ) ) {\n\t\t\tbuf = arguments[ 0 ];\n\t\t\tif ( HAS_ITERATOR_SYMBOL === false ) {\n\t\t\t\tthrow new TypeError( format( 'invalid argument. Environment lacks Symbol.iterator support. Must provide a length, ArrayBuffer, typed array, or array-like object. Value: `%s`.', buf ) );\n\t\t\t}\n\t\t\tif ( !isFunction( buf[ ITERATOR_SYMBOL ] ) ) {\n\t\t\t\tthrow new TypeError( format( 'invalid argument. Must provide a length, ArrayBuffer, typed array, array-like object, or an iterable. Value: `%s`.', buf ) );\n\t\t\t}\n\t\t\tbuf = buf[ ITERATOR_SYMBOL ]();\n\t\t\tif ( !isFunction( buf.next ) ) {\n\t\t\t\tthrow new TypeError( format( 'invalid argument. Must provide a length, ArrayBuffer, typed array, array-like object, or an iterable. Value: `%s`.', buf ) );\n\t\t\t}\n\t\t\tbuf = fromIterator( buf );\n\t\t\tif ( buf instanceof Error ) {\n\t\t\t\tthrow buf;\n\t\t\t}\n\t\t\tbuf = new Float32Array( buf );\n\t\t} else {\n\t\t\tthrow new TypeError( format( 'invalid argument. Must provide a length, ArrayBuffer, typed array, array-like object, or an iterable. Value: `%s`.', arguments[0] ) );\n\t\t}\n\t} else {\n\t\tbuf = arguments[ 0 ];\n\t\tif ( !isArrayBuffer( buf ) ) {\n\t\t\tthrow new TypeError( format( 'invalid argument. First argument must be an ArrayBuffer. Value: `%s`.', buf ) );\n\t\t}\n\t\tbyteOffset = arguments[ 1 ];\n\t\tif ( !isNonNegativeInteger( byteOffset ) ) {\n\t\t\tthrow new TypeError( format( 'invalid argument. Byte offset must be a nonnegative integer. Value: `%s`.', byteOffset ) );\n\t\t}\n\t\tif ( !isInteger( byteOffset/BYTES_PER_ELEMENT ) ) {\n\t\t\tthrow new RangeError( format( 'invalid argument. Byte offset must be a multiple of %u. Value: `%u`.', BYTES_PER_ELEMENT, byteOffset ) );\n\t\t}\n\t\tif ( nargs === 2 ) {\n\t\t\tlen = buf.byteLength - byteOffset;\n\t\t\tif ( !isInteger( len/BYTES_PER_ELEMENT ) ) {\n\t\t\t\tthrow new RangeError( format( 'invalid arguments. ArrayBuffer view byte length must be a multiple of %u. View byte length: `%u`.', BYTES_PER_ELEMENT, len ) );\n\t\t\t}\n\t\t\tbuf = new Float32Array( buf, byteOffset );\n\t\t} else {\n\t\t\tlen = arguments[ 2 ];\n\t\t\tif ( !isNonNegativeInteger( len ) ) {\n\t\t\t\tthrow new TypeError( format( 'invalid argument. Length must be a nonnegative integer. Value: `%s`.', len ) );\n\t\t\t}\n\t\t\tif ( (len*BYTES_PER_ELEMENT) > (buf.byteLength-byteOffset) ) {\n\t\t\t\tthrow new RangeError( format( 'invalid arguments. ArrayBuffer has insufficient capacity. Either decrease the array length or provide a bigger buffer. Minimum capacity: `%u`.', len*BYTES_PER_ELEMENT ) );\n\t\t\t}\n\t\t\tbuf = new Float32Array( buf, byteOffset, len*2 );\n\t\t}\n\t}\n\tsetReadOnly( this, '_buffer', buf );\n\tsetReadOnly( this, '_length', buf.length/2 );\n\n\treturn this;\n}\n\n/**\n* Size (in bytes) of each array element.\n*\n* @name BYTES_PER_ELEMENT\n* @memberof Complex64Array\n* @readonly\n* @type {PositiveInteger}\n* @default 8\n*\n* @example\n* var nbytes = Complex64Array.BYTES_PER_ELEMENT;\n* // returns 8\n*/\nsetReadOnly( Complex64Array, 'BYTES_PER_ELEMENT', BYTES_PER_ELEMENT );\n\n/**\n* Constructor name.\n*\n* @name name\n* @memberof Complex64Array\n* @readonly\n* @type {string}\n* @default 'Complex64Array'\n*\n* @example\n* var str = Complex64Array.name;\n* // returns 'Complex64Array'\n*/\nsetReadOnly( Complex64Array, 'name', 'Complex64Array' );\n\n/**\n* Creates a new 64-bit complex number array from an array-like object or an iterable.\n*\n* @name from\n* @memberof Complex64Array\n* @type {Function}\n* @param {(Collection|Iterable)} src - array-like object or iterable\n* @param {Function} [clbk] - callback to invoke for each source element\n* @param {*} [thisArg] - context\n* @throws {TypeError} `this` context must be a constructor\n* @throws {TypeError} `this` must be a complex number array\n* @throws {TypeError} first argument must be an array-like object or an iterable\n* @throws {TypeError} second argument must be a function\n* @throws {RangeError} array-like objects must have a length which is a multiple of two\n* @throws {TypeError} an iterator must return either a two element array containing real and imaginary components or a complex number\n* @throws {TypeError} when provided an iterator, a callback must return either a two element array containing real and imaginary components or a complex number\n* @returns {Complex64Array} 64-bit complex number array\n*\n* @example\n* var arr = Complex64Array.from( [ 1.0, -1.0 ] );\n* // returns \n*\n* var len = arr.length;\n* // returns 1\n*\n* @example\n* var Complex64 = require( '@stdlib/complex-float32' );\n*\n* var arr = Complex64Array.from( [ new Complex64( 1.0, 1.0 ) ] );\n* // returns \n*\n* var len = arr.length;\n* // returns 1\n*\n* @example\n* var Complex64 = require( '@stdlib/complex-float32' );\n* var realf = require( '@stdlib/complex-realf' );\n* var imagf = require( '@stdlib/complex-imagf' );\n*\n* function clbk( v ) {\n* return new Complex64( realf(v)*2.0, imagf(v)*2.0 );\n* }\n*\n* var arr = Complex64Array.from( [ new Complex64( 1.0, 1.0 ) ], clbk );\n* // returns \n*\n* var len = arr.length;\n* // returns 1\n*/\nsetReadOnly( Complex64Array, 'from', function from( src ) {\n\tvar thisArg;\n\tvar nargs;\n\tvar clbk;\n\tvar out;\n\tvar buf;\n\tvar tmp;\n\tvar get;\n\tvar len;\n\tvar flg;\n\tvar v;\n\tvar i;\n\tvar j;\n\tif ( !isFunction( this ) ) {\n\t\tthrow new TypeError( 'invalid invocation. `this` context must be a constructor.' );\n\t}\n\tif ( !isComplexArrayConstructor( this ) ) {\n\t\tthrow new TypeError( 'invalid invocation. `this` is not a complex number array.' );\n\t}\n\tnargs = arguments.length;\n\tif ( nargs > 1 ) {\n\t\tclbk = arguments[ 1 ];\n\t\tif ( !isFunction( clbk ) ) {\n\t\t\tthrow new TypeError( format( 'invalid argument. Second argument must be a function. Value: `%s`.', clbk ) );\n\t\t}\n\t\tif ( nargs > 2 ) {\n\t\t\tthisArg = arguments[ 2 ];\n\t\t}\n\t}\n\tif ( isComplexArray( src ) ) {\n\t\tlen = src.length;\n\t\tif ( clbk ) {\n\t\t\tout = new this( len );\n\t\t\tbuf = out._buffer; // eslint-disable-line no-underscore-dangle\n\t\t\tj = 0;\n\t\t\tfor ( i = 0; i < len; i++ ) {\n\t\t\t\tv = clbk.call( thisArg, src.get( i ), i );\n\t\t\t\tif ( isComplexLike( v ) ) {\n\t\t\t\t\tbuf[ j ] = realf( v );\n\t\t\t\t\tbuf[ j+1 ] = imagf( v );\n\t\t\t\t} else if ( isArrayLikeObject( v ) && v.length >= 2 ) {\n\t\t\t\t\tbuf[ j ] = v[ 0 ];\n\t\t\t\t\tbuf[ j+1 ] = v[ 1 ];\n\t\t\t\t} else {\n\t\t\t\t\tthrow new TypeError( format( 'invalid argument. Callback must return either a two-element array containing real and imaginary components or a complex number. Value: `%s`.', v ) );\n\t\t\t\t}\n\t\t\t\tj += 2; // stride\n\t\t\t}\n\t\t\treturn out;\n\t\t}\n\t\treturn new this( src );\n\t}\n\tif ( isCollection( src ) ) {\n\t\tif ( clbk ) {\n\t\t\t// Note: array contents affect how we iterate over a provided data source. If only complex number objects, we can extract real and imaginary components. Otherwise, for non-complex number arrays (e.g., `Float64Array`, etc), we assume a strided array where real and imaginary components are interleaved. In the former case, we expect a callback to return real and imaginary components (possibly as a complex number). In the latter case, we expect a callback to return *either* a real or imaginary component.\n\n\t\t\tlen = src.length;\n\t\t\tif ( src.get && src.set ) {\n\t\t\t\tget = accessorGetter( 'default' );\n\t\t\t} else {\n\t\t\t\tget = getter( 'default' );\n\t\t\t}\n\t\t\t// Detect whether we've been provided an array which returns complex number objects...\n\t\t\tfor ( i = 0; i < len; i++ ) {\n\t\t\t\tif ( !isComplexLike( get( src, i ) ) ) {\n\t\t\t\t\tflg = true;\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\t\t\t// If an array does not contain only complex number objects, then we assume interleaved real and imaginary components...\n\t\t\tif ( flg ) {\n\t\t\t\tif ( !isEven( len ) ) {\n\t\t\t\t\tthrow new RangeError( format( 'invalid argument. First argument must have a length which is a multiple of %u. Length: `%u`.', 2, len ) );\n\t\t\t\t}\n\t\t\t\tout = new this( len/2 );\n\t\t\t\tbuf = out._buffer; // eslint-disable-line no-underscore-dangle\n\t\t\t\tfor ( i = 0; i < len; i++ ) {\n\t\t\t\t\tbuf[ i ] = clbk.call( thisArg, get( src, i ), i );\n\t\t\t\t}\n\t\t\t\treturn out;\n\t\t\t}\n\t\t\t// If an array contains only complex number objects, then we need to extract real and imaginary components...\n\t\t\tout = new this( len );\n\t\t\tbuf = out._buffer; // eslint-disable-line no-underscore-dangle\n\t\t\tj = 0;\n\t\t\tfor ( i = 0; i < len; i++ ) {\n\t\t\t\tv = clbk.call( thisArg, get( src, i ), i );\n\t\t\t\tif ( isComplexLike( v ) ) {\n\t\t\t\t\tbuf[ j ] = realf( v );\n\t\t\t\t\tbuf[ j+1 ] = imagf( v );\n\t\t\t\t} else if ( isArrayLikeObject( v ) && v.length >= 2 ) {\n\t\t\t\t\tbuf[ j ] = v[ 0 ];\n\t\t\t\t\tbuf[ j+1 ] = v[ 1 ];\n\t\t\t\t} else {\n\t\t\t\t\tthrow new TypeError( format( 'invalid argument. Callback must return either a two-element array containing real and imaginary components or a complex number. Value: `%s`.', v ) );\n\t\t\t\t}\n\t\t\t\tj += 2; // stride\n\t\t\t}\n\t\t\treturn out;\n\t\t}\n\t\treturn new this( src );\n\t}\n\tif ( isObject( src ) && HAS_ITERATOR_SYMBOL && isFunction( src[ ITERATOR_SYMBOL ] ) ) { // eslint-disable-line max-len\n\t\tbuf = src[ ITERATOR_SYMBOL ]();\n\t\tif ( !isFunction( buf.next ) ) {\n\t\t\tthrow new TypeError( format( 'invalid argument. First argument must be an array-like object or an iterable. Value: `%s`.', src ) );\n\t\t}\n\t\tif ( clbk ) {\n\t\t\ttmp = fromIteratorMap( buf, clbk, thisArg );\n\t\t} else {\n\t\t\ttmp = fromIterator( buf );\n\t\t}\n\t\tif ( tmp instanceof Error ) {\n\t\t\tthrow tmp;\n\t\t}\n\t\tlen = tmp.length / 2;\n\t\tout = new this( len );\n\t\tbuf = out._buffer; // eslint-disable-line no-underscore-dangle\n\t\tfor ( i = 0; i < len; i++ ) {\n\t\t\tbuf[ i ] = tmp[ i ];\n\t\t}\n\t\treturn out;\n\t}\n\tthrow new TypeError( format( 'invalid argument. First argument must be an array-like object or an iterable. Value: `%s`.', src ) );\n});\n\n/**\n* Creates a new 64-bit complex number array from a variable number of arguments.\n*\n* @name of\n* @memberof Complex64Array\n* @type {Function}\n* @param {...*} element - array elements\n* @throws {TypeError} `this` context must be a constructor\n* @throws {TypeError} `this` must be a complex number array\n* @returns {Complex64Array} 64-bit complex number array\n*\n* @example\n* var arr = Complex64Array.of( 1.0, 1.0, 1.0, 1.0 );\n* // returns \n*\n* var len = arr.length;\n* // returns 2\n*/\nsetReadOnly( Complex64Array, 'of', function of() {\n\tvar args;\n\tvar i;\n\tif ( !isFunction( this ) ) {\n\t\tthrow new TypeError( 'invalid invocation. `this` context must be a constructor.' );\n\t}\n\tif ( !isComplexArrayConstructor( this ) ) {\n\t\tthrow new TypeError( 'invalid invocation. `this` is not a complex number array.' );\n\t}\n\targs = [];\n\tfor ( i = 0; i < arguments.length; i++ ) {\n\t\targs.push( arguments[ i ] );\n\t}\n\treturn new this( args );\n});\n\n/**\n* Pointer to the underlying data buffer.\n*\n* @name buffer\n* @memberof Complex64Array.prototype\n* @readonly\n* @type {ArrayBuffer}\n*\n* @example\n* var arr = new Complex64Array( 10 );\n*\n* var buf = arr.buffer;\n* // returns \n*/\nsetReadOnlyAccessor( Complex64Array.prototype, 'buffer', function get() {\n\treturn this._buffer.buffer;\n});\n\n/**\n* Size (in bytes) of the array.\n*\n* @name byteLength\n* @memberof Complex64Array.prototype\n* @readonly\n* @type {NonNegativeInteger}\n*\n* @example\n* var arr = new Complex64Array( 10 );\n*\n* var byteLength = arr.byteLength;\n* // returns 80\n*/\nsetReadOnlyAccessor( Complex64Array.prototype, 'byteLength', function get() {\n\treturn this._buffer.byteLength;\n});\n\n/**\n* Offset (in bytes) of the array from the start of its underlying `ArrayBuffer`.\n*\n* @name byteOffset\n* @memberof Complex64Array.prototype\n* @readonly\n* @type {NonNegativeInteger}\n*\n* @example\n* var arr = new Complex64Array( 10 );\n*\n* var byteOffset = arr.byteOffset;\n* // returns 0\n*/\nsetReadOnlyAccessor( Complex64Array.prototype, 'byteOffset', function get() {\n\treturn this._buffer.byteOffset;\n});\n\n/**\n* Size (in bytes) of each array element.\n*\n* @name BYTES_PER_ELEMENT\n* @memberof Complex64Array.prototype\n* @readonly\n* @type {PositiveInteger}\n* @default 8\n*\n* @example\n* var arr = new Complex64Array( 10 );\n*\n* var nbytes = arr.BYTES_PER_ELEMENT;\n* // returns 8\n*/\nsetReadOnly( Complex64Array.prototype, 'BYTES_PER_ELEMENT', Complex64Array.BYTES_PER_ELEMENT );\n\n/**\n* Copies a sequence of elements within the array to the position starting at `target`.\n*\n* @name copyWithin\n* @memberof Complex64Array.prototype\n* @type {Function}\n* @param {integer} target - index at which to start copying elements\n* @param {integer} start - source index at which to copy elements from\n* @param {integer} [end] - source index at which to stop copying elements from\n* @throws {TypeError} `this` must be a complex number array\n* @returns {Complex64Array} modified array\n*\n* @example\n* var Complex64 = require( '@stdlib/complex-float32' );\n* var realf = require( '@stdlib/complex-realf' );\n* var imagf = require( '@stdlib/complex-imagf' );\n*\n* var arr = new Complex64Array( 4 );\n*\n* // Set the array elements:\n* arr.set( new Complex64( 1.0, 1.0 ), 0 );\n* arr.set( new Complex64( 2.0, 2.0 ), 1 );\n* arr.set( new Complex64( 3.0, 3.0 ), 2 );\n* arr.set( new Complex64( 4.0, 4.0 ), 3 );\n*\n* // Copy the first two elements to the last two elements:\n* arr.copyWithin( 2, 0, 2 );\n*\n* // Get the last array element:\n* var z = arr.get( 3 );\n*\n* var re = realf( z );\n* // returns 2.0\n*\n* var im = imagf( z );\n* // returns 2.0\n*/\nsetReadOnly( Complex64Array.prototype, 'copyWithin', function copyWithin( target, start ) {\n\tif ( !isComplexArray( this ) ) {\n\t\tthrow new TypeError( 'invalid invocation. `this` is not a complex number array.' );\n\t}\n\t// FIXME: prefer a functional `copyWithin` implementation which addresses lack of universal browser support (e.g., IE11 and Safari) or ensure that typed arrays are polyfilled\n\tif ( arguments.length === 2 ) {\n\t\tthis._buffer.copyWithin( target*2, start*2 );\n\t} else {\n\t\tthis._buffer.copyWithin( target*2, start*2, arguments[2]*2 );\n\t}\n\treturn this;\n});\n\n/**\n* Returns an iterator for iterating over array key-value pairs.\n*\n* @name entries\n* @memberof Complex64Array.prototype\n* @type {Function}\n* @throws {TypeError} `this` must be a complex number array\n* @returns {Iterator} iterator\n*\n* @example\n* var Complex64 = require( '@stdlib/complex-float32' );\n*\n* var arr = [\n* new Complex64( 1.0, 1.0 ),\n* new Complex64( 2.0, 2.0 ),\n* new Complex64( 3.0, 3.0 )\n* ];\n* arr = new Complex64Array( arr );\n*\n* // Create an iterator:\n* var it = arr.entries();\n*\n* // Iterate over the key-value pairs...\n* var v = it.next().value;\n* // returns [ 0, ]\n*\n* v = it.next().value;\n* // returns [ 1, ]\n*\n* v = it.next().value;\n* // returns [ 2, ]\n*\n* var bool = it.next().done;\n* // returns true\n*/\nsetReadOnly( Complex64Array.prototype, 'entries', function entries() {\n\tvar buffer;\n\tvar self;\n\tvar iter;\n\tvar len;\n\tvar FLG;\n\tvar i;\n\tvar j;\n\tif ( !isComplexArray( this ) ) {\n\t\tthrow new TypeError( 'invalid invocation. `this` is not a complex number array.' );\n\t}\n\tself = this;\n\tbuffer = this._buffer;\n\tlen = this._length;\n\n\t// Initialize the iteration indices:\n\ti = -1;\n\tj = -2;\n\n\t// Create an iterator protocol-compliant object:\n\titer = {};\n\tsetReadOnly( iter, 'next', next );\n\tsetReadOnly( iter, 'return', end );\n\n\tif ( ITERATOR_SYMBOL ) {\n\t\tsetReadOnly( iter, ITERATOR_SYMBOL, factory );\n\t}\n\treturn iter;\n\n\t/**\n\t* Returns an iterator protocol-compliant object containing the next iterated value.\n\t*\n\t* @private\n\t* @returns {Object} iterator protocol-compliant object\n\t*/\n\tfunction next() {\n\t\tvar z;\n\t\ti += 1;\n\t\tif ( FLG || i >= len ) {\n\t\t\treturn {\n\t\t\t\t'done': true\n\t\t\t};\n\t\t}\n\t\tj += 2;\n\t\tz = new Complex64( buffer[ j ], buffer[ j+1 ] );\n\t\treturn {\n\t\t\t'value': [ i, z ],\n\t\t\t'done': false\n\t\t};\n\t}\n\n\t/**\n\t* Finishes an iterator.\n\t*\n\t* @private\n\t* @param {*} [value] - value to return\n\t* @returns {Object} iterator protocol-compliant object\n\t*/\n\tfunction end( value ) {\n\t\tFLG = true;\n\t\tif ( arguments.length ) {\n\t\t\treturn {\n\t\t\t\t'value': value,\n\t\t\t\t'done': true\n\t\t\t};\n\t\t}\n\t\treturn {\n\t\t\t'done': true\n\t\t};\n\t}\n\n\t/**\n\t* Returns a new iterator.\n\t*\n\t* @private\n\t* @returns {Iterator} iterator\n\t*/\n\tfunction factory() {\n\t\treturn self.entries();\n\t}\n});\n\n/**\n* Returns an array element.\n*\n* @name get\n* @memberof Complex64Array.prototype\n* @type {Function}\n* @param {NonNegativeInteger} idx - element index\n* @throws {TypeError} `this` must be a complex number array\n* @throws {TypeError} must provide a nonnegative integer\n* @returns {(Complex64|void)} array element\n*\n* @example\n* var arr = new Complex64Array( 10 );\n* var realf = require( '@stdlib/complex-realf' );\n* var imagf = require( '@stdlib/complex-imagf' );\n*\n* var z = arr.get( 0 );\n* // returns \n*\n* var re = realf( z );\n* // returns 0.0\n*\n* var im = imagf( z );\n* // returns 0.0\n*\n* arr.set( [ 1.0, -1.0 ], 0 );\n*\n* z = arr.get( 0 );\n* // returns \n*\n* re = realf( z );\n* // returns 1.0\n*\n* im = imagf( z );\n* // returns -1.0\n*\n* z = arr.get( 100 );\n* // returns undefined\n*/\nsetReadOnly( Complex64Array.prototype, 'get', function get( idx ) {\n\tvar buf;\n\tif ( !isComplexArray( this ) ) {\n\t\tthrow new TypeError( 'invalid invocation. `this` is not a complex number array.' );\n\t}\n\tif ( !isNonNegativeInteger( idx ) ) {\n\t\tthrow new TypeError( format( 'invalid argument. Must provide a nonnegative integer. Value: `%s`.', idx ) );\n\t}\n\tif ( idx >= this._length ) {\n\t\treturn;\n\t}\n\tbuf = this._buffer;\n\tidx *= 2;\n\treturn new Complex64( buf[ idx ], buf[ idx+1 ] );\n});\n\n/**\n* Number of array elements.\n*\n* @name length\n* @memberof Complex64Array.prototype\n* @readonly\n* @type {NonNegativeInteger}\n*\n* @example\n* var arr = new Complex64Array( 10 );\n*\n* var len = arr.length;\n* // returns 10\n*/\nsetReadOnlyAccessor( Complex64Array.prototype, 'length', function get() {\n\treturn this._length;\n});\n\n/**\n* Sets an array element.\n*\n* ## Notes\n*\n* - When provided a typed array, real or complex, we must check whether the source array shares the same buffer as the target array and whether the underlying memory overlaps. In particular, we are concerned with the following scenario:\n*\n* ```text\n* buf: ---------------------\n* src: ---------------------\n* ```\n*\n* In the above, as we copy values from `src`, we will overwrite values in the `src` view, resulting in duplicated values copied into the end of `buf`, which is not intended. Hence, to avoid overwriting source values, we must **copy** source values to a temporary array.\n*\n* In the other overlapping scenario,\n*\n* ```text\n* buf: ---------------------\n* src: ---------------------\n* ```\n*\n* by the time we begin copying into the overlapping region, we are copying from the end of `src`, a non-overlapping region, which means we don't run the risk of copying copied values, rather than the original `src` values as intended.\n*\n*\n* @name set\n* @memberof Complex64Array.prototype\n* @type {Function}\n* @param {(Collection|Complex|ComplexArray)} value - value(s)\n* @param {NonNegativeInteger} [i=0] - element index at which to start writing values\n* @throws {TypeError} `this` must be a complex number array\n* @throws {TypeError} first argument must be either a complex number, an array-like object, or a complex number array\n* @throws {TypeError} index argument must be a nonnegative integer\n* @throws {RangeError} array-like objects must have a length which is a multiple of two\n* @throws {RangeError} index argument is out-of-bounds\n* @throws {RangeError} target array lacks sufficient storage to accommodate source values\n* @returns {void}\n*\n* @example\n* var realf = require( '@stdlib/complex-realf' );\n* var imagf = require( '@stdlib/complex-imagf' );\n*\n* var arr = new Complex64Array( 10 );\n*\n* var z = arr.get( 0 );\n* // returns \n*\n* var re = realf( z );\n* // returns 0.0\n*\n* var im = imagf( z );\n* // returns 0.0\n*\n* arr.set( [ 1.0, -1.0 ], 0 );\n*\n* z = arr.get( 0 );\n* // returns \n*\n* re = realf( z );\n* // returns 1.0\n*\n* im = imagf( z );\n* // returns -1.0\n*/\nsetReadOnly( Complex64Array.prototype, 'set', function set( value ) {\n\t/* eslint-disable no-underscore-dangle */\n\tvar sbuf;\n\tvar idx;\n\tvar buf;\n\tvar tmp;\n\tvar flg;\n\tvar N;\n\tvar v;\n\tvar i;\n\tvar j;\n\tif ( !isComplexArray( this ) ) {\n\t\tthrow new TypeError( 'invalid invocation. `this` is not a complex number array.' );\n\t}\n\tbuf = this._buffer;\n\tif ( arguments.length > 1 ) {\n\t\tidx = arguments[ 1 ];\n\t\tif ( !isNonNegativeInteger( idx ) ) {\n\t\t\tthrow new TypeError( format( 'invalid argument. Index argument must be a nonnegative integer. Value: `%s`.', idx ) );\n\t\t}\n\t} else {\n\t\tidx = 0;\n\t}\n\tif ( isComplexLike( value ) ) {\n\t\tif ( idx >= this._length ) {\n\t\t\tthrow new RangeError( format( 'invalid argument. Index argument is out-of-bounds. Value: `%u`.', idx ) );\n\t\t}\n\t\tidx *= 2;\n\t\tbuf[ idx ] = realf( value );\n\t\tbuf[ idx+1 ] = imagf( value );\n\t\treturn;\n\t}\n\tif ( isComplexArray( value ) ) {\n\t\tN = value._length;\n\t\tif ( idx+N > this._length ) {\n\t\t\tthrow new RangeError( 'invalid arguments. Target array lacks sufficient storage to accommodate source values.' );\n\t\t}\n\t\tsbuf = value._buffer;\n\n\t\t// Check for overlapping memory...\n\t\tj = buf.byteOffset + (idx*BYTES_PER_ELEMENT);\n\t\tif (\n\t\t\tsbuf.buffer === buf.buffer &&\n\t\t\t(\n\t\t\t\tsbuf.byteOffset < j &&\n\t\t\t\tsbuf.byteOffset+sbuf.byteLength > j\n\t\t\t)\n\t\t) {\n\t\t\t// We need to copy source values...\n\t\t\ttmp = new Float32Array( sbuf.length );\n\t\t\tfor ( i = 0; i < sbuf.length; i++ ) {\n\t\t\t\ttmp[ i ] = sbuf[ i ];\n\t\t\t}\n\t\t\tsbuf = tmp;\n\t\t}\n\t\tidx *= 2;\n\t\tj = 0;\n\t\tfor ( i = 0; i < N; i++ ) {\n\t\t\tbuf[ idx ] = sbuf[ j ];\n\t\t\tbuf[ idx+1 ] = sbuf[ j+1 ];\n\t\t\tidx += 2; // stride\n\t\t\tj += 2; // stride\n\t\t}\n\t\treturn;\n\t}\n\tif ( isCollection( value ) ) {\n\t\t// Detect whether we've been provided an array of complex numbers...\n\t\tN = value.length;\n\t\tfor ( i = 0; i < N; i++ ) {\n\t\t\tif ( !isComplexLike( value[ i ] ) ) {\n\t\t\t\tflg = true;\n\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\t\t// If an array does not contain only complex numbers, then we assume interleaved real and imaginary components...\n\t\tif ( flg ) {\n\t\t\tif ( !isEven( N ) ) {\n\t\t\t\tthrow new RangeError( format( 'invalid argument. Array-like object arguments must have a length which is a multiple of two. Length: `%u`.', N ) );\n\t\t\t}\n\t\t\tif ( idx+(N/2) > this._length ) {\n\t\t\t\tthrow new RangeError( 'invalid arguments. Target array lacks sufficient storage to accommodate source values.' );\n\t\t\t}\n\t\t\tsbuf = value;\n\n\t\t\t// Check for overlapping memory...\n\t\t\tj = buf.byteOffset + (idx*BYTES_PER_ELEMENT);\n\t\t\tif (\n\t\t\t\tsbuf.buffer === buf.buffer &&\n\t\t\t\t(\n\t\t\t\t\tsbuf.byteOffset < j &&\n\t\t\t\t\tsbuf.byteOffset+sbuf.byteLength > j\n\t\t\t\t)\n\t\t\t) {\n\t\t\t\t// We need to copy source values...\n\t\t\t\ttmp = new Float32Array( N );\n\t\t\t\tfor ( i = 0; i < N; i++ ) {\n\t\t\t\t\ttmp[ i ] = sbuf[ i ];\n\t\t\t\t}\n\t\t\t\tsbuf = tmp;\n\t\t\t}\n\t\t\tidx *= 2;\n\t\t\tN /= 2;\n\t\t\tj = 0;\n\t\t\tfor ( i = 0; i < N; i++ ) {\n\t\t\t\tbuf[ idx ] = sbuf[ j ];\n\t\t\t\tbuf[ idx+1 ] = sbuf[ j+1 ];\n\t\t\t\tidx += 2; // stride\n\t\t\t\tj += 2; // stride\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\t\t// If an array contains only complex numbers, then we need to extract real and imaginary components...\n\t\tif ( idx+N > this._length ) {\n\t\t\tthrow new RangeError( 'invalid arguments. Target array lacks sufficient storage to accommodate source values.' );\n\t\t}\n\t\tidx *= 2;\n\t\tfor ( i = 0; i < N; i++ ) {\n\t\t\tv = value[ i ];\n\t\t\tbuf[ idx ] = realf( v );\n\t\t\tbuf[ idx+1 ] = imagf( v );\n\t\t\tidx += 2; // stride\n\t\t}\n\t\treturn;\n\t}\n\tthrow new TypeError( format( 'invalid argument. First argument must be either a complex number, an array-like object, or a complex number array. Value: `%s`.', value ) );\n\n\t/* eslint-enable no-underscore-dangle */\n});\n\n\n// EXPORTS //\n\nmodule.exports = Complex64Array;\n", "/**\n* @license Apache-2.0\n*\n* Copyright (c) 2018 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n* http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n/**\n* 64-bit complex number array.\n*\n* @module @stdlib/array-complex64\n*\n* @example\n* var Complex64Array = require( '@stdlib/array-complex64' );\n*\n* var arr = new Complex64Array();\n* // returns \n*\n* var len = arr.length;\n* // returns 0\n*\n* @example\n* var Complex64Array = require( '@stdlib/array-complex64' );\n*\n* var arr = new Complex64Array( 2 );\n* // returns \n*\n* var len = arr.length;\n* // returns 2\n*\n* @example\n* var Complex64Array = require( '@stdlib/array-complex64' );\n*\n* var arr = new Complex64Array( [ 1.0, -1.0 ] );\n* // returns \n*\n* var len = arr.length;\n* // returns 1\n*\n* @example\n* var ArrayBuffer = require( '@stdlib/array-buffer' );\n* var Complex64Array = require( '@stdlib/array-complex64' );\n*\n* var buf = new ArrayBuffer( 16 );\n* var arr = new Complex64Array( buf );\n* // returns \n*\n* var len = arr.length;\n* // returns 2\n*\n* @example\n* var ArrayBuffer = require( '@stdlib/array-buffer' );\n* var Complex64Array = require( '@stdlib/array-complex64' );\n*\n* var buf = new ArrayBuffer( 16 );\n* var arr = new Complex64Array( buf, 8 );\n* // returns \n*\n* var len = arr.length;\n* // returns 2\n*\n* @example\n* var ArrayBuffer = require( '@stdlib/array-buffer' );\n* var Complex64Array = require( '@stdlib/array-complex64' );\n*\n* var buf = new ArrayBuffer( 32 );\n* var arr = new Complex64Array( buf, 8, 2 );\n* // returns \n*\n* var len = arr.length;\n* // returns 2\n*/\n\n// MODULES //\n\nvar main = require( './main.js' );\n\n\n// EXPORTS //\n\nmodule.exports = main;\n"], - "mappings": "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", + "sourcesContent": ["/**\n* @license Apache-2.0\n*\n* Copyright (c) 2018 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n* http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n// MODULES //\n\nvar isArrayLikeObject = require( '@stdlib/assert-is-array-like-object' );\nvar isComplexLike = require( '@stdlib/assert-is-complex-like' );\nvar realf = require( '@stdlib/complex-realf' );\nvar imagf = require( '@stdlib/complex-imagf' );\nvar format = require( '@stdlib/string-format' );\n\n\n// MAIN //\n\n/**\n* Returns an array of iterated values.\n*\n* @private\n* @param {Object} it - iterator\n* @returns {(Array|TypeError)} array or an error\n*/\nfunction fromIterator( it ) {\n\tvar out;\n\tvar v;\n\tvar z;\n\n\tout = [];\n\twhile ( true ) {\n\t\tv = it.next();\n\t\tif ( v.done ) {\n\t\t\tbreak;\n\t\t}\n\t\tz = v.value;\n\t\tif ( isArrayLikeObject( z ) && z.length >= 2 ) {\n\t\t\tout.push( z[ 0 ], z[ 1 ] );\n\t\t} else if ( isComplexLike( z ) ) {\n\t\t\tout.push( realf( z ), imagf( z ) );\n\t\t} else {\n\t\t\treturn new TypeError( format( 'invalid argument. An iterator must return either a two-element array containing real and imaginary components or a complex number. Value: `%s`.', z ) );\n\t\t}\n\t}\n\treturn out;\n}\n\n\n// EXPORTS //\n\nmodule.exports = fromIterator;\n", "/**\n* @license Apache-2.0\n*\n* Copyright (c) 2018 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n* http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n// MODULES //\n\nvar isArrayLikeObject = require( '@stdlib/assert-is-array-like-object' );\nvar isComplexLike = require( '@stdlib/assert-is-complex-like' );\nvar realf = require( '@stdlib/complex-realf' );\nvar imagf = require( '@stdlib/complex-imagf' );\nvar format = require( '@stdlib/string-format' );\n\n\n// MAIN //\n\n/**\n* Returns an array of iterated values.\n*\n* @private\n* @param {Object} it - iterator\n* @param {Function} clbk - callback to invoke for each iterated value\n* @param {*} thisArg - invocation context\n* @returns {(Array|TypeError)} array or an error\n*/\nfunction fromIteratorMap( it, clbk, thisArg ) {\n\tvar out;\n\tvar v;\n\tvar z;\n\tvar i;\n\n\tout = [];\n\ti = -1;\n\twhile ( true ) {\n\t\tv = it.next();\n\t\tif ( v.done ) {\n\t\t\tbreak;\n\t\t}\n\t\ti += 1;\n\t\tz = clbk.call( thisArg, v.value, i );\n\t\tif ( isArrayLikeObject( z ) && z.length >= 2 ) {\n\t\t\tout.push( z[ 0 ], z[ 1 ] );\n\t\t} else if ( isComplexLike( z ) ) {\n\t\t\tout.push( realf( z ), imagf( z ) );\n\t\t} else {\n\t\t\treturn new TypeError( format( 'invalid argument. Callback must return either a two-element array containing real and imaginary components or a complex number. Value: `%s`.', z ) );\n\t\t}\n\t}\n\treturn out;\n}\n\n\n// EXPORTS //\n\nmodule.exports = fromIteratorMap;\n", "/**\n* @license Apache-2.0\n*\n* Copyright (c) 2018 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n* http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n// MODULES //\n\nvar isComplexLike = require( '@stdlib/assert-is-complex-like' );\nvar realf = require( '@stdlib/complex-realf' );\nvar imagf = require( '@stdlib/complex-imagf' );\n\n\n// MAIN //\n\n/**\n* Returns a strided array of real and imaginary components.\n*\n* @private\n* @param {Float32Array} buf - output array\n* @param {Array} arr - array containing complex numbers\n* @returns {(Float32Array|null)} output array or null\n*/\nfunction fromArray( buf, arr ) {\n\tvar len;\n\tvar v;\n\tvar i;\n\tvar j;\n\n\tlen = arr.length;\n\tj = 0;\n\tfor ( i = 0; i < len; i++ ) {\n\t\tv = arr[ i ];\n\t\tif ( !isComplexLike( v ) ) {\n\t\t\treturn null;\n\t\t}\n\t\tbuf[ j ] = realf( v );\n\t\tbuf[ j+1 ] = imagf( v );\n\t\tj += 2; // stride\n\t}\n\treturn buf;\n}\n\n\n// EXPORTS //\n\nmodule.exports = fromArray;\n", "/* eslint-disable no-restricted-syntax, max-lines, no-invalid-this */\n\n/**\n* @license Apache-2.0\n*\n* Copyright (c) 2018 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n* http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n// MODULES //\n\nvar isNonNegativeInteger = require( '@stdlib/assert-is-nonnegative-integer' ).isPrimitive;\nvar isArrayLikeObject = require( '@stdlib/assert-is-array-like-object' );\nvar isCollection = require( '@stdlib/assert-is-collection' );\nvar isArrayBuffer = require( '@stdlib/assert-is-arraybuffer' );\nvar isObject = require( '@stdlib/assert-is-object' );\nvar isArray = require( '@stdlib/assert-is-array' );\nvar isFunction = require( '@stdlib/assert-is-function' );\nvar isComplexLike = require( '@stdlib/assert-is-complex-like' );\nvar isEven = require( '@stdlib/math-base-assert-is-even' );\nvar isInteger = require( '@stdlib/math-base-assert-is-integer' );\nvar hasIteratorSymbolSupport = require( '@stdlib/assert-has-iterator-symbol-support' );\nvar ITERATOR_SYMBOL = require( '@stdlib/symbol-iterator' );\nvar setReadOnly = require( '@stdlib/utils-define-nonenumerable-read-only-property' );\nvar setReadOnlyAccessor = require( '@stdlib/utils-define-nonenumerable-read-only-accessor' );\nvar Float32Array = require( '@stdlib/array-float32' );\nvar Complex64 = require( '@stdlib/complex-float32' );\nvar format = require( '@stdlib/string-format' );\nvar realf = require( '@stdlib/complex-realf' );\nvar imagf = require( '@stdlib/complex-imagf' );\nvar reinterpret64 = require( '@stdlib/strided-base-reinterpret-complex64' );\nvar reinterpret128 = require( '@stdlib/strided-base-reinterpret-complex128' );\nvar getter = require( '@stdlib/array-base-getter' );\nvar accessorGetter = require( '@stdlib/array-base-accessor-getter' );\nvar fromIterator = require( './from_iterator.js' );\nvar fromIteratorMap = require( './from_iterator_map.js' );\nvar fromArray = require( './from_array.js' );\n\n\n// VARIABLES //\n\nvar BYTES_PER_ELEMENT = Float32Array.BYTES_PER_ELEMENT * 2;\nvar HAS_ITERATOR_SYMBOL = hasIteratorSymbolSupport();\n\n\n// FUNCTIONS //\n\n/**\n* Returns a boolean indicating if a value is a complex typed array.\n*\n* @private\n* @param {*} value - value to test\n* @returns {boolean} boolean indicating if a value is a complex typed array\n*/\nfunction isComplexArray( value ) {\n\treturn (\n\t\tvalue instanceof Complex64Array ||\n\t\t(\n\t\t\ttypeof value === 'object' &&\n\t\t\tvalue !== null &&\n\t\t\t(\n\t\t\t\tvalue.constructor.name === 'Complex64Array' ||\n\t\t\t\tvalue.constructor.name === 'Complex128Array'\n\t\t\t) &&\n\t\t\ttypeof value._length === 'number' && // eslint-disable-line no-underscore-dangle\n\n\t\t\t// NOTE: we don't perform a more rigorous test here for a typed array for performance reasons, as robustly checking for a typed array instance could require walking the prototype tree and performing relatively expensive constructor checks...\n\t\t\ttypeof value._buffer === 'object' // eslint-disable-line no-underscore-dangle\n\t\t)\n\t);\n}\n\n/**\n* Returns a boolean indicating if a value is a complex typed array constructor.\n*\n* @private\n* @param {*} value - value to test\n* @returns {boolean} boolean indicating if a value is a complex typed array constructor\n*/\nfunction isComplexArrayConstructor( value ) {\n\treturn (\n\t\tvalue === Complex64Array ||\n\n\t\t// NOTE: weaker test in order to avoid a circular dependency with Complex128Array...\n\t\tvalue.name === 'Complex128Array'\n\t);\n}\n\n/**\n* Returns a boolean indicating if a value is a `Complex64Array`.\n*\n* @private\n* @param {*} value - value to test\n* @returns {boolean} boolean indicating if a value is a `Complex64Array`\n*/\nfunction isComplex64Array( value ) {\n\treturn (\n\t\ttypeof value === 'object' &&\n\t\tvalue !== null &&\n\t\tvalue.constructor.name === 'Complex64Array' &&\n\t\tvalue.BYTES_PER_ELEMENT === BYTES_PER_ELEMENT\n\t);\n}\n\n/**\n* Returns a boolean indicating if a value is a `Complex128Array`.\n*\n* @private\n* @param {*} value - value to test\n* @returns {boolean} boolean indicating if a value is a `Complex128Array`\n*/\nfunction isComplex128Array( value ) {\n\treturn (\n\t\ttypeof value === 'object' &&\n\t\tvalue !== null &&\n\t\tvalue.constructor.name === 'Complex128Array' &&\n\t\tvalue.BYTES_PER_ELEMENT === BYTES_PER_ELEMENT*2\n\t);\n}\n\n\n// MAIN //\n\n/**\n* 64-bit complex number array constructor.\n*\n* @constructor\n* @param {(NonNegativeInteger|Collection|ArrayBuffer|Iterable)} [arg] - length, typed array, array-like object, buffer, or an iterable\n* @param {NonNegativeInteger} [byteOffset=0] - byte offset\n* @param {NonNegativeInteger} [length] - view length\n* @throws {RangeError} ArrayBuffer byte length must be a multiple of `8`\n* @throws {RangeError} array-like object and typed array input arguments must have a length which is a multiple of two\n* @throws {TypeError} if provided only a single argument, must provide a valid argument\n* @throws {TypeError} byte offset must be a nonnegative integer\n* @throws {RangeError} byte offset must be a multiple of `8`\n* @throws {TypeError} view length must be a positive multiple of `8`\n* @throws {RangeError} must provide sufficient memory to accommodate byte offset and view length requirements\n* @throws {TypeError} an iterator must return either a two element array containing real and imaginary components or a complex number\n* @returns {Complex64Array} complex number array\n*\n* @example\n* var arr = new Complex64Array();\n* // returns \n*\n* var len = arr.length;\n* // returns 0\n*\n* @example\n* var arr = new Complex64Array( 2 );\n* // returns \n*\n* var len = arr.length;\n* // returns 2\n*\n* @example\n* var arr = new Complex64Array( [ 1.0, -1.0 ] );\n* // returns \n*\n* var len = arr.length;\n* // returns 1\n*\n* @example\n* var ArrayBuffer = require( '@stdlib/array-buffer' );\n*\n* var buf = new ArrayBuffer( 16 );\n* var arr = new Complex64Array( buf );\n* // returns \n*\n* var len = arr.length;\n* // returns 2\n*\n* @example\n* var ArrayBuffer = require( '@stdlib/array-buffer' );\n*\n* var buf = new ArrayBuffer( 16 );\n* var arr = new Complex64Array( buf, 8 );\n* // returns \n*\n* var len = arr.length;\n* // returns 1\n*\n* @example\n* var ArrayBuffer = require( '@stdlib/array-buffer' );\n*\n* var buf = new ArrayBuffer( 32 );\n* var arr = new Complex64Array( buf, 8, 2 );\n* // returns \n*\n* var len = arr.length;\n* // returns 2\n*/\nfunction Complex64Array() {\n\tvar byteOffset;\n\tvar nargs;\n\tvar buf;\n\tvar len;\n\n\tnargs = arguments.length;\n\tif ( !(this instanceof Complex64Array) ) {\n\t\tif ( nargs === 0 ) {\n\t\t\treturn new Complex64Array();\n\t\t}\n\t\tif ( nargs === 1 ) {\n\t\t\treturn new Complex64Array( arguments[0] );\n\t\t}\n\t\tif ( nargs === 2 ) {\n\t\t\treturn new Complex64Array( arguments[0], arguments[1] );\n\t\t}\n\t\treturn new Complex64Array( arguments[0], arguments[1], arguments[2] );\n\t}\n\t// Create the underlying data buffer...\n\tif ( nargs === 0 ) {\n\t\tbuf = new Float32Array( 0 ); // backward-compatibility\n\t} else if ( nargs === 1 ) {\n\t\tif ( isNonNegativeInteger( arguments[0] ) ) {\n\t\t\tbuf = new Float32Array( arguments[0]*2 );\n\t\t} else if ( isCollection( arguments[0] ) ) {\n\t\t\tbuf = arguments[ 0 ];\n\t\t\tlen = buf.length;\n\n\t\t\t// If provided a \"generic\" array, peak at the first value, and, if the value is a complex number, try to process as an array of complex numbers, falling back to \"normal\" typed array initialization if we fail and ensuring consistency if the first value had not been a complex number...\n\t\t\tif ( len && isArray( buf ) && isComplexLike( buf[0] ) ) {\n\t\t\t\tbuf = fromArray( new Float32Array( len*2 ), buf );\n\t\t\t\tif ( buf === null ) {\n\t\t\t\t\t// We failed and we are now forced to allocate a new array :-(\n\t\t\t\t\tif ( !isEven( len ) ) {\n\t\t\t\t\t\tthrow new RangeError( format( 'invalid argument. Array-like object arguments must have a length which is a multiple of two. Length: `%u`.', len ) );\n\t\t\t\t\t}\n\t\t\t\t\t// We failed, so fall back to directly setting values...\n\t\t\t\t\tbuf = new Float32Array( arguments[0] );\n\t\t\t\t}\n\t\t\t} else {\n\t\t\t\tif ( isComplex64Array( buf ) ) {\n\t\t\t\t\tbuf = reinterpret64( buf, 0 );\n\t\t\t\t} else if ( isComplex128Array( buf ) ) {\n\t\t\t\t\tbuf = reinterpret128( buf, 0 );\n\t\t\t\t} else if ( !isEven( len ) ) {\n\t\t\t\t\tthrow new RangeError( format( 'invalid argument. Array-like object and typed array arguments must have a length which is a multiple of two. Length: `%u`.', len ) );\n\t\t\t\t}\n\t\t\t\tbuf = new Float32Array( buf );\n\t\t\t}\n\t\t} else if ( isArrayBuffer( arguments[0] ) ) {\n\t\t\tbuf = arguments[ 0 ];\n\t\t\tif ( !isInteger( buf.byteLength/BYTES_PER_ELEMENT ) ) {\n\t\t\t\tthrow new RangeError( format( 'invalid argument. ArrayBuffer byte length must be a multiple of %u. Byte length: `%u`.', BYTES_PER_ELEMENT, buf.byteLength ) );\n\t\t\t}\n\t\t\tbuf = new Float32Array( buf );\n\t\t} else if ( isObject( arguments[0] ) ) {\n\t\t\tbuf = arguments[ 0 ];\n\t\t\tif ( HAS_ITERATOR_SYMBOL === false ) {\n\t\t\t\tthrow new TypeError( format( 'invalid argument. Environment lacks Symbol.iterator support. Must provide a length, ArrayBuffer, typed array, or array-like object. Value: `%s`.', buf ) );\n\t\t\t}\n\t\t\tif ( !isFunction( buf[ ITERATOR_SYMBOL ] ) ) {\n\t\t\t\tthrow new TypeError( format( 'invalid argument. Must provide a length, ArrayBuffer, typed array, array-like object, or an iterable. Value: `%s`.', buf ) );\n\t\t\t}\n\t\t\tbuf = buf[ ITERATOR_SYMBOL ]();\n\t\t\tif ( !isFunction( buf.next ) ) {\n\t\t\t\tthrow new TypeError( format( 'invalid argument. Must provide a length, ArrayBuffer, typed array, array-like object, or an iterable. Value: `%s`.', buf ) );\n\t\t\t}\n\t\t\tbuf = fromIterator( buf );\n\t\t\tif ( buf instanceof Error ) {\n\t\t\t\tthrow buf;\n\t\t\t}\n\t\t\tbuf = new Float32Array( buf );\n\t\t} else {\n\t\t\tthrow new TypeError( format( 'invalid argument. Must provide a length, ArrayBuffer, typed array, array-like object, or an iterable. Value: `%s`.', arguments[0] ) );\n\t\t}\n\t} else {\n\t\tbuf = arguments[ 0 ];\n\t\tif ( !isArrayBuffer( buf ) ) {\n\t\t\tthrow new TypeError( format( 'invalid argument. First argument must be an ArrayBuffer. Value: `%s`.', buf ) );\n\t\t}\n\t\tbyteOffset = arguments[ 1 ];\n\t\tif ( !isNonNegativeInteger( byteOffset ) ) {\n\t\t\tthrow new TypeError( format( 'invalid argument. Byte offset must be a nonnegative integer. Value: `%s`.', byteOffset ) );\n\t\t}\n\t\tif ( !isInteger( byteOffset/BYTES_PER_ELEMENT ) ) {\n\t\t\tthrow new RangeError( format( 'invalid argument. Byte offset must be a multiple of %u. Value: `%u`.', BYTES_PER_ELEMENT, byteOffset ) );\n\t\t}\n\t\tif ( nargs === 2 ) {\n\t\t\tlen = buf.byteLength - byteOffset;\n\t\t\tif ( !isInteger( len/BYTES_PER_ELEMENT ) ) {\n\t\t\t\tthrow new RangeError( format( 'invalid arguments. ArrayBuffer view byte length must be a multiple of %u. View byte length: `%u`.', BYTES_PER_ELEMENT, len ) );\n\t\t\t}\n\t\t\tbuf = new Float32Array( buf, byteOffset );\n\t\t} else {\n\t\t\tlen = arguments[ 2 ];\n\t\t\tif ( !isNonNegativeInteger( len ) ) {\n\t\t\t\tthrow new TypeError( format( 'invalid argument. Length must be a nonnegative integer. Value: `%s`.', len ) );\n\t\t\t}\n\t\t\tif ( (len*BYTES_PER_ELEMENT) > (buf.byteLength-byteOffset) ) {\n\t\t\t\tthrow new RangeError( format( 'invalid arguments. ArrayBuffer has insufficient capacity. Either decrease the array length or provide a bigger buffer. Minimum capacity: `%u`.', len*BYTES_PER_ELEMENT ) );\n\t\t\t}\n\t\t\tbuf = new Float32Array( buf, byteOffset, len*2 );\n\t\t}\n\t}\n\tsetReadOnly( this, '_buffer', buf );\n\tsetReadOnly( this, '_length', buf.length/2 );\n\n\treturn this;\n}\n\n/**\n* Size (in bytes) of each array element.\n*\n* @name BYTES_PER_ELEMENT\n* @memberof Complex64Array\n* @readonly\n* @type {PositiveInteger}\n* @default 8\n*\n* @example\n* var nbytes = Complex64Array.BYTES_PER_ELEMENT;\n* // returns 8\n*/\nsetReadOnly( Complex64Array, 'BYTES_PER_ELEMENT', BYTES_PER_ELEMENT );\n\n/**\n* Constructor name.\n*\n* @name name\n* @memberof Complex64Array\n* @readonly\n* @type {string}\n* @default 'Complex64Array'\n*\n* @example\n* var str = Complex64Array.name;\n* // returns 'Complex64Array'\n*/\nsetReadOnly( Complex64Array, 'name', 'Complex64Array' );\n\n/**\n* Creates a new 64-bit complex number array from an array-like object or an iterable.\n*\n* @name from\n* @memberof Complex64Array\n* @type {Function}\n* @param {(Collection|Iterable)} src - array-like object or iterable\n* @param {Function} [clbk] - callback to invoke for each source element\n* @param {*} [thisArg] - context\n* @throws {TypeError} `this` context must be a constructor\n* @throws {TypeError} `this` must be a complex number array\n* @throws {TypeError} first argument must be an array-like object or an iterable\n* @throws {TypeError} second argument must be a function\n* @throws {RangeError} array-like objects must have a length which is a multiple of two\n* @throws {TypeError} an iterator must return either a two element array containing real and imaginary components or a complex number\n* @throws {TypeError} when provided an iterator, a callback must return either a two element array containing real and imaginary components or a complex number\n* @returns {Complex64Array} 64-bit complex number array\n*\n* @example\n* var arr = Complex64Array.from( [ 1.0, -1.0 ] );\n* // returns \n*\n* var len = arr.length;\n* // returns 1\n*\n* @example\n* var Complex64 = require( '@stdlib/complex-float32' );\n*\n* var arr = Complex64Array.from( [ new Complex64( 1.0, 1.0 ) ] );\n* // returns \n*\n* var len = arr.length;\n* // returns 1\n*\n* @example\n* var Complex64 = require( '@stdlib/complex-float32' );\n* var realf = require( '@stdlib/complex-realf' );\n* var imagf = require( '@stdlib/complex-imagf' );\n*\n* function clbk( v ) {\n* return new Complex64( realf(v)*2.0, imagf(v)*2.0 );\n* }\n*\n* var arr = Complex64Array.from( [ new Complex64( 1.0, 1.0 ) ], clbk );\n* // returns \n*\n* var len = arr.length;\n* // returns 1\n*/\nsetReadOnly( Complex64Array, 'from', function from( src ) {\n\tvar thisArg;\n\tvar nargs;\n\tvar clbk;\n\tvar out;\n\tvar buf;\n\tvar tmp;\n\tvar get;\n\tvar len;\n\tvar flg;\n\tvar v;\n\tvar i;\n\tvar j;\n\tif ( !isFunction( this ) ) {\n\t\tthrow new TypeError( 'invalid invocation. `this` context must be a constructor.' );\n\t}\n\tif ( !isComplexArrayConstructor( this ) ) {\n\t\tthrow new TypeError( 'invalid invocation. `this` is not a complex number array.' );\n\t}\n\tnargs = arguments.length;\n\tif ( nargs > 1 ) {\n\t\tclbk = arguments[ 1 ];\n\t\tif ( !isFunction( clbk ) ) {\n\t\t\tthrow new TypeError( format( 'invalid argument. Second argument must be a function. Value: `%s`.', clbk ) );\n\t\t}\n\t\tif ( nargs > 2 ) {\n\t\t\tthisArg = arguments[ 2 ];\n\t\t}\n\t}\n\tif ( isComplexArray( src ) ) {\n\t\tlen = src.length;\n\t\tif ( clbk ) {\n\t\t\tout = new this( len );\n\t\t\tbuf = out._buffer; // eslint-disable-line no-underscore-dangle\n\t\t\tj = 0;\n\t\t\tfor ( i = 0; i < len; i++ ) {\n\t\t\t\tv = clbk.call( thisArg, src.get( i ), i );\n\t\t\t\tif ( isComplexLike( v ) ) {\n\t\t\t\t\tbuf[ j ] = realf( v );\n\t\t\t\t\tbuf[ j+1 ] = imagf( v );\n\t\t\t\t} else if ( isArrayLikeObject( v ) && v.length >= 2 ) {\n\t\t\t\t\tbuf[ j ] = v[ 0 ];\n\t\t\t\t\tbuf[ j+1 ] = v[ 1 ];\n\t\t\t\t} else {\n\t\t\t\t\tthrow new TypeError( format( 'invalid argument. Callback must return either a two-element array containing real and imaginary components or a complex number. Value: `%s`.', v ) );\n\t\t\t\t}\n\t\t\t\tj += 2; // stride\n\t\t\t}\n\t\t\treturn out;\n\t\t}\n\t\treturn new this( src );\n\t}\n\tif ( isCollection( src ) ) {\n\t\tif ( clbk ) {\n\t\t\t// Note: array contents affect how we iterate over a provided data source. If only complex number objects, we can extract real and imaginary components. Otherwise, for non-complex number arrays (e.g., `Float64Array`, etc), we assume a strided array where real and imaginary components are interleaved. In the former case, we expect a callback to return real and imaginary components (possibly as a complex number). In the latter case, we expect a callback to return *either* a real or imaginary component.\n\n\t\t\tlen = src.length;\n\t\t\tif ( src.get && src.set ) {\n\t\t\t\tget = accessorGetter( 'default' );\n\t\t\t} else {\n\t\t\t\tget = getter( 'default' );\n\t\t\t}\n\t\t\t// Detect whether we've been provided an array which returns complex number objects...\n\t\t\tfor ( i = 0; i < len; i++ ) {\n\t\t\t\tif ( !isComplexLike( get( src, i ) ) ) {\n\t\t\t\t\tflg = true;\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\t\t\t// If an array does not contain only complex number objects, then we assume interleaved real and imaginary components...\n\t\t\tif ( flg ) {\n\t\t\t\tif ( !isEven( len ) ) {\n\t\t\t\t\tthrow new RangeError( format( 'invalid argument. First argument must have a length which is a multiple of %u. Length: `%u`.', 2, len ) );\n\t\t\t\t}\n\t\t\t\tout = new this( len/2 );\n\t\t\t\tbuf = out._buffer; // eslint-disable-line no-underscore-dangle\n\t\t\t\tfor ( i = 0; i < len; i++ ) {\n\t\t\t\t\tbuf[ i ] = clbk.call( thisArg, get( src, i ), i );\n\t\t\t\t}\n\t\t\t\treturn out;\n\t\t\t}\n\t\t\t// If an array contains only complex number objects, then we need to extract real and imaginary components...\n\t\t\tout = new this( len );\n\t\t\tbuf = out._buffer; // eslint-disable-line no-underscore-dangle\n\t\t\tj = 0;\n\t\t\tfor ( i = 0; i < len; i++ ) {\n\t\t\t\tv = clbk.call( thisArg, get( src, i ), i );\n\t\t\t\tif ( isComplexLike( v ) ) {\n\t\t\t\t\tbuf[ j ] = realf( v );\n\t\t\t\t\tbuf[ j+1 ] = imagf( v );\n\t\t\t\t} else if ( isArrayLikeObject( v ) && v.length >= 2 ) {\n\t\t\t\t\tbuf[ j ] = v[ 0 ];\n\t\t\t\t\tbuf[ j+1 ] = v[ 1 ];\n\t\t\t\t} else {\n\t\t\t\t\tthrow new TypeError( format( 'invalid argument. Callback must return either a two-element array containing real and imaginary components or a complex number. Value: `%s`.', v ) );\n\t\t\t\t}\n\t\t\t\tj += 2; // stride\n\t\t\t}\n\t\t\treturn out;\n\t\t}\n\t\treturn new this( src );\n\t}\n\tif ( isObject( src ) && HAS_ITERATOR_SYMBOL && isFunction( src[ ITERATOR_SYMBOL ] ) ) { // eslint-disable-line max-len\n\t\tbuf = src[ ITERATOR_SYMBOL ]();\n\t\tif ( !isFunction( buf.next ) ) {\n\t\t\tthrow new TypeError( format( 'invalid argument. First argument must be an array-like object or an iterable. Value: `%s`.', src ) );\n\t\t}\n\t\tif ( clbk ) {\n\t\t\ttmp = fromIteratorMap( buf, clbk, thisArg );\n\t\t} else {\n\t\t\ttmp = fromIterator( buf );\n\t\t}\n\t\tif ( tmp instanceof Error ) {\n\t\t\tthrow tmp;\n\t\t}\n\t\tlen = tmp.length / 2;\n\t\tout = new this( len );\n\t\tbuf = out._buffer; // eslint-disable-line no-underscore-dangle\n\t\tfor ( i = 0; i < len; i++ ) {\n\t\t\tbuf[ i ] = tmp[ i ];\n\t\t}\n\t\treturn out;\n\t}\n\tthrow new TypeError( format( 'invalid argument. First argument must be an array-like object or an iterable. Value: `%s`.', src ) );\n});\n\n/**\n* Creates a new 64-bit complex number array from a variable number of arguments.\n*\n* @name of\n* @memberof Complex64Array\n* @type {Function}\n* @param {...*} element - array elements\n* @throws {TypeError} `this` context must be a constructor\n* @throws {TypeError} `this` must be a complex number array\n* @returns {Complex64Array} 64-bit complex number array\n*\n* @example\n* var arr = Complex64Array.of( 1.0, 1.0, 1.0, 1.0 );\n* // returns \n*\n* var len = arr.length;\n* // returns 2\n*/\nsetReadOnly( Complex64Array, 'of', function of() {\n\tvar args;\n\tvar i;\n\tif ( !isFunction( this ) ) {\n\t\tthrow new TypeError( 'invalid invocation. `this` context must be a constructor.' );\n\t}\n\tif ( !isComplexArrayConstructor( this ) ) {\n\t\tthrow new TypeError( 'invalid invocation. `this` is not a complex number array.' );\n\t}\n\targs = [];\n\tfor ( i = 0; i < arguments.length; i++ ) {\n\t\targs.push( arguments[ i ] );\n\t}\n\treturn new this( args );\n});\n\n/**\n* Pointer to the underlying data buffer.\n*\n* @name buffer\n* @memberof Complex64Array.prototype\n* @readonly\n* @type {ArrayBuffer}\n*\n* @example\n* var arr = new Complex64Array( 10 );\n*\n* var buf = arr.buffer;\n* // returns \n*/\nsetReadOnlyAccessor( Complex64Array.prototype, 'buffer', function get() {\n\treturn this._buffer.buffer;\n});\n\n/**\n* Size (in bytes) of the array.\n*\n* @name byteLength\n* @memberof Complex64Array.prototype\n* @readonly\n* @type {NonNegativeInteger}\n*\n* @example\n* var arr = new Complex64Array( 10 );\n*\n* var byteLength = arr.byteLength;\n* // returns 80\n*/\nsetReadOnlyAccessor( Complex64Array.prototype, 'byteLength', function get() {\n\treturn this._buffer.byteLength;\n});\n\n/**\n* Offset (in bytes) of the array from the start of its underlying `ArrayBuffer`.\n*\n* @name byteOffset\n* @memberof Complex64Array.prototype\n* @readonly\n* @type {NonNegativeInteger}\n*\n* @example\n* var arr = new Complex64Array( 10 );\n*\n* var byteOffset = arr.byteOffset;\n* // returns 0\n*/\nsetReadOnlyAccessor( Complex64Array.prototype, 'byteOffset', function get() {\n\treturn this._buffer.byteOffset;\n});\n\n/**\n* Size (in bytes) of each array element.\n*\n* @name BYTES_PER_ELEMENT\n* @memberof Complex64Array.prototype\n* @readonly\n* @type {PositiveInteger}\n* @default 8\n*\n* @example\n* var arr = new Complex64Array( 10 );\n*\n* var nbytes = arr.BYTES_PER_ELEMENT;\n* // returns 8\n*/\nsetReadOnly( Complex64Array.prototype, 'BYTES_PER_ELEMENT', Complex64Array.BYTES_PER_ELEMENT );\n\n/**\n* Copies a sequence of elements within the array to the position starting at `target`.\n*\n* @name copyWithin\n* @memberof Complex64Array.prototype\n* @type {Function}\n* @param {integer} target - index at which to start copying elements\n* @param {integer} start - source index at which to copy elements from\n* @param {integer} [end] - source index at which to stop copying elements from\n* @throws {TypeError} `this` must be a complex number array\n* @returns {Complex64Array} modified array\n*\n* @example\n* var Complex64 = require( '@stdlib/complex-float32' );\n* var realf = require( '@stdlib/complex-realf' );\n* var imagf = require( '@stdlib/complex-imagf' );\n*\n* var arr = new Complex64Array( 4 );\n*\n* // Set the array elements:\n* arr.set( new Complex64( 1.0, 1.0 ), 0 );\n* arr.set( new Complex64( 2.0, 2.0 ), 1 );\n* arr.set( new Complex64( 3.0, 3.0 ), 2 );\n* arr.set( new Complex64( 4.0, 4.0 ), 3 );\n*\n* // Copy the first two elements to the last two elements:\n* arr.copyWithin( 2, 0, 2 );\n*\n* // Get the last array element:\n* var z = arr.get( 3 );\n*\n* var re = realf( z );\n* // returns 2.0\n*\n* var im = imagf( z );\n* // returns 2.0\n*/\nsetReadOnly( Complex64Array.prototype, 'copyWithin', function copyWithin( target, start ) {\n\tif ( !isComplexArray( this ) ) {\n\t\tthrow new TypeError( 'invalid invocation. `this` is not a complex number array.' );\n\t}\n\t// FIXME: prefer a functional `copyWithin` implementation which addresses lack of universal browser support (e.g., IE11 and Safari) or ensure that typed arrays are polyfilled\n\tif ( arguments.length === 2 ) {\n\t\tthis._buffer.copyWithin( target*2, start*2 );\n\t} else {\n\t\tthis._buffer.copyWithin( target*2, start*2, arguments[2]*2 );\n\t}\n\treturn this;\n});\n\n/**\n* Returns an iterator for iterating over array key-value pairs.\n*\n* @name entries\n* @memberof Complex64Array.prototype\n* @type {Function}\n* @throws {TypeError} `this` must be a complex number array\n* @returns {Iterator} iterator\n*\n* @example\n* var Complex64 = require( '@stdlib/complex-float32' );\n*\n* var arr = [\n* new Complex64( 1.0, 1.0 ),\n* new Complex64( 2.0, 2.0 ),\n* new Complex64( 3.0, 3.0 )\n* ];\n* arr = new Complex64Array( arr );\n*\n* // Create an iterator:\n* var it = arr.entries();\n*\n* // Iterate over the key-value pairs...\n* var v = it.next().value;\n* // returns [ 0, ]\n*\n* v = it.next().value;\n* // returns [ 1, ]\n*\n* v = it.next().value;\n* // returns [ 2, ]\n*\n* var bool = it.next().done;\n* // returns true\n*/\nsetReadOnly( Complex64Array.prototype, 'entries', function entries() {\n\tvar buffer;\n\tvar self;\n\tvar iter;\n\tvar len;\n\tvar FLG;\n\tvar i;\n\tvar j;\n\tif ( !isComplexArray( this ) ) {\n\t\tthrow new TypeError( 'invalid invocation. `this` is not a complex number array.' );\n\t}\n\tself = this;\n\tbuffer = this._buffer;\n\tlen = this._length;\n\n\t// Initialize the iteration indices:\n\ti = -1;\n\tj = -2;\n\n\t// Create an iterator protocol-compliant object:\n\titer = {};\n\tsetReadOnly( iter, 'next', next );\n\tsetReadOnly( iter, 'return', end );\n\n\tif ( ITERATOR_SYMBOL ) {\n\t\tsetReadOnly( iter, ITERATOR_SYMBOL, factory );\n\t}\n\treturn iter;\n\n\t/**\n\t* Returns an iterator protocol-compliant object containing the next iterated value.\n\t*\n\t* @private\n\t* @returns {Object} iterator protocol-compliant object\n\t*/\n\tfunction next() {\n\t\tvar z;\n\t\ti += 1;\n\t\tif ( FLG || i >= len ) {\n\t\t\treturn {\n\t\t\t\t'done': true\n\t\t\t};\n\t\t}\n\t\tj += 2;\n\t\tz = new Complex64( buffer[ j ], buffer[ j+1 ] );\n\t\treturn {\n\t\t\t'value': [ i, z ],\n\t\t\t'done': false\n\t\t};\n\t}\n\n\t/**\n\t* Finishes an iterator.\n\t*\n\t* @private\n\t* @param {*} [value] - value to return\n\t* @returns {Object} iterator protocol-compliant object\n\t*/\n\tfunction end( value ) {\n\t\tFLG = true;\n\t\tif ( arguments.length ) {\n\t\t\treturn {\n\t\t\t\t'value': value,\n\t\t\t\t'done': true\n\t\t\t};\n\t\t}\n\t\treturn {\n\t\t\t'done': true\n\t\t};\n\t}\n\n\t/**\n\t* Returns a new iterator.\n\t*\n\t* @private\n\t* @returns {Iterator} iterator\n\t*/\n\tfunction factory() {\n\t\treturn self.entries();\n\t}\n});\n\n/**\n* Returns an array element.\n*\n* @name get\n* @memberof Complex64Array.prototype\n* @type {Function}\n* @param {NonNegativeInteger} idx - element index\n* @throws {TypeError} `this` must be a complex number array\n* @throws {TypeError} must provide a nonnegative integer\n* @returns {(Complex64|void)} array element\n*\n* @example\n* var arr = new Complex64Array( 10 );\n* var realf = require( '@stdlib/complex-realf' );\n* var imagf = require( '@stdlib/complex-imagf' );\n*\n* var z = arr.get( 0 );\n* // returns \n*\n* var re = realf( z );\n* // returns 0.0\n*\n* var im = imagf( z );\n* // returns 0.0\n*\n* arr.set( [ 1.0, -1.0 ], 0 );\n*\n* z = arr.get( 0 );\n* // returns \n*\n* re = realf( z );\n* // returns 1.0\n*\n* im = imagf( z );\n* // returns -1.0\n*\n* z = arr.get( 100 );\n* // returns undefined\n*/\nsetReadOnly( Complex64Array.prototype, 'get', function get( idx ) {\n\tvar buf;\n\tif ( !isComplexArray( this ) ) {\n\t\tthrow new TypeError( 'invalid invocation. `this` is not a complex number array.' );\n\t}\n\tif ( !isNonNegativeInteger( idx ) ) {\n\t\tthrow new TypeError( format( 'invalid argument. Must provide a nonnegative integer. Value: `%s`.', idx ) );\n\t}\n\tif ( idx >= this._length ) {\n\t\treturn;\n\t}\n\tbuf = this._buffer;\n\tidx *= 2;\n\treturn new Complex64( buf[ idx ], buf[ idx+1 ] );\n});\n\n/**\n* Returns an array element with support for both nonnegative and negative integer indices.\n*\n* @name at\n* @memberof Complex64Array.prototype\n* @type {Function}\n* @param {integer} idx - element index\n* @throws {TypeError} `this` must be a complex number array\n* @throws {TypeError} must provide a integer\n* @returns {(Complex64|void)} array element\n*\n* @example\n* var arr = new Complex64Array( 10 );\n* var realf = require( '@stdlib/complex-realf' );\n* var imagf = require( '@stdlib/complex-imagf' );\n*\n* var z = arr.at( 0 );\n* // returns \n*\n* var re = realf( z );\n* // returns 0.0\n*\n* var im = imagf( z );\n* // returns 0.0\n*\n* arr.set( [ 1.0, -1.0 ], 0 );\n* arr.set( [ 2.0, -2.0 ], 1 );\n* arr.set( [ 9.0, -9.0 ], 9 );\n*\n* z = arr.at( 0 );\n* // returns \n*\n* re = realf( z );\n* // returns 1.0\n*\n* im = imagf( z );\n* // returns -1.0\n*\n* z = arr.at( -1 );\n* // returns \n*\n* re = realf( z );\n* // returns 9.0\n*\n* im = imagf( z );\n* // returns -9.0\n*\n* z = arr.at( 100 );\n* // returns undefined\n*\n* z = arr.at( -100 );\n* // returns undefined\n*/\nsetReadOnly( Complex64Array.prototype, 'at', function at( idx ) {\n\tvar buf;\n\tif ( !isComplexArray( this ) ) {\n\t\tthrow new TypeError( 'invalid invocation. `this` is not a complex number array.' );\n\t}\n\tif ( !isInteger( idx ) ) {\n\t\tthrow new TypeError( format( 'invalid argument. Must provide a integer. Value: `%s`.', idx ) );\n\t}\n\tif ( idx < 0 ) {\n\t\tidx += this._length;\n\t}\n\tif ( idx < 0 || idx >= this._length ) {\n\t\treturn;\n\t}\n\tbuf = this._buffer;\n\tidx *= 2;\n\treturn new Complex64( buf[ idx ], buf[ idx+1 ] );\n});\n\n/**\n* Number of array elements.\n*\n* @name length\n* @memberof Complex64Array.prototype\n* @readonly\n* @type {NonNegativeInteger}\n*\n* @example\n* var arr = new Complex64Array( 10 );\n*\n* var len = arr.length;\n* // returns 10\n*/\nsetReadOnlyAccessor( Complex64Array.prototype, 'length', function get() {\n\treturn this._length;\n});\n\n/**\n* Sets an array element.\n*\n* ## Notes\n*\n* - When provided a typed array, real or complex, we must check whether the source array shares the same buffer as the target array and whether the underlying memory overlaps. In particular, we are concerned with the following scenario:\n*\n* ```text\n* buf: ---------------------\n* src: ---------------------\n* ```\n*\n* In the above, as we copy values from `src`, we will overwrite values in the `src` view, resulting in duplicated values copied into the end of `buf`, which is not intended. Hence, to avoid overwriting source values, we must **copy** source values to a temporary array.\n*\n* In the other overlapping scenario,\n*\n* ```text\n* buf: ---------------------\n* src: ---------------------\n* ```\n*\n* by the time we begin copying into the overlapping region, we are copying from the end of `src`, a non-overlapping region, which means we don't run the risk of copying copied values, rather than the original `src` values as intended.\n*\n* @name set\n* @memberof Complex64Array.prototype\n* @type {Function}\n* @param {(Collection|Complex|ComplexArray)} value - value(s)\n* @param {NonNegativeInteger} [i=0] - element index at which to start writing values\n* @throws {TypeError} `this` must be a complex number array\n* @throws {TypeError} first argument must be either a complex number, an array-like object, or a complex number array\n* @throws {TypeError} index argument must be a nonnegative integer\n* @throws {RangeError} array-like objects must have a length which is a multiple of two\n* @throws {RangeError} index argument is out-of-bounds\n* @throws {RangeError} target array lacks sufficient storage to accommodate source values\n* @returns {void}\n*\n* @example\n* var realf = require( '@stdlib/complex-realf' );\n* var imagf = require( '@stdlib/complex-imagf' );\n*\n* var arr = new Complex64Array( 10 );\n*\n* var z = arr.get( 0 );\n* // returns \n*\n* var re = realf( z );\n* // returns 0.0\n*\n* var im = imagf( z );\n* // returns 0.0\n*\n* arr.set( [ 1.0, -1.0 ], 0 );\n*\n* z = arr.get( 0 );\n* // returns \n*\n* re = realf( z );\n* // returns 1.0\n*\n* im = imagf( z );\n* // returns -1.0\n*/\nsetReadOnly( Complex64Array.prototype, 'set', function set( value ) {\n\t/* eslint-disable no-underscore-dangle */\n\tvar sbuf;\n\tvar idx;\n\tvar buf;\n\tvar tmp;\n\tvar flg;\n\tvar N;\n\tvar v;\n\tvar i;\n\tvar j;\n\tif ( !isComplexArray( this ) ) {\n\t\tthrow new TypeError( 'invalid invocation. `this` is not a complex number array.' );\n\t}\n\tbuf = this._buffer;\n\tif ( arguments.length > 1 ) {\n\t\tidx = arguments[ 1 ];\n\t\tif ( !isNonNegativeInteger( idx ) ) {\n\t\t\tthrow new TypeError( format( 'invalid argument. Index argument must be a nonnegative integer. Value: `%s`.', idx ) );\n\t\t}\n\t} else {\n\t\tidx = 0;\n\t}\n\tif ( isComplexLike( value ) ) {\n\t\tif ( idx >= this._length ) {\n\t\t\tthrow new RangeError( format( 'invalid argument. Index argument is out-of-bounds. Value: `%u`.', idx ) );\n\t\t}\n\t\tidx *= 2;\n\t\tbuf[ idx ] = realf( value );\n\t\tbuf[ idx+1 ] = imagf( value );\n\t\treturn;\n\t}\n\tif ( isComplexArray( value ) ) {\n\t\tN = value._length;\n\t\tif ( idx+N > this._length ) {\n\t\t\tthrow new RangeError( 'invalid arguments. Target array lacks sufficient storage to accommodate source values.' );\n\t\t}\n\t\tsbuf = value._buffer;\n\n\t\t// Check for overlapping memory...\n\t\tj = buf.byteOffset + (idx*BYTES_PER_ELEMENT);\n\t\tif (\n\t\t\tsbuf.buffer === buf.buffer &&\n\t\t\t(\n\t\t\t\tsbuf.byteOffset < j &&\n\t\t\t\tsbuf.byteOffset+sbuf.byteLength > j\n\t\t\t)\n\t\t) {\n\t\t\t// We need to copy source values...\n\t\t\ttmp = new Float32Array( sbuf.length );\n\t\t\tfor ( i = 0; i < sbuf.length; i++ ) {\n\t\t\t\ttmp[ i ] = sbuf[ i ];\n\t\t\t}\n\t\t\tsbuf = tmp;\n\t\t}\n\t\tidx *= 2;\n\t\tj = 0;\n\t\tfor ( i = 0; i < N; i++ ) {\n\t\t\tbuf[ idx ] = sbuf[ j ];\n\t\t\tbuf[ idx+1 ] = sbuf[ j+1 ];\n\t\t\tidx += 2; // stride\n\t\t\tj += 2; // stride\n\t\t}\n\t\treturn;\n\t}\n\tif ( isCollection( value ) ) {\n\t\t// Detect whether we've been provided an array of complex numbers...\n\t\tN = value.length;\n\t\tfor ( i = 0; i < N; i++ ) {\n\t\t\tif ( !isComplexLike( value[ i ] ) ) {\n\t\t\t\tflg = true;\n\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\t\t// If an array does not contain only complex numbers, then we assume interleaved real and imaginary components...\n\t\tif ( flg ) {\n\t\t\tif ( !isEven( N ) ) {\n\t\t\t\tthrow new RangeError( format( 'invalid argument. Array-like object arguments must have a length which is a multiple of two. Length: `%u`.', N ) );\n\t\t\t}\n\t\t\tif ( idx+(N/2) > this._length ) {\n\t\t\t\tthrow new RangeError( 'invalid arguments. Target array lacks sufficient storage to accommodate source values.' );\n\t\t\t}\n\t\t\tsbuf = value;\n\n\t\t\t// Check for overlapping memory...\n\t\t\tj = buf.byteOffset + (idx*BYTES_PER_ELEMENT);\n\t\t\tif (\n\t\t\t\tsbuf.buffer === buf.buffer &&\n\t\t\t\t(\n\t\t\t\t\tsbuf.byteOffset < j &&\n\t\t\t\t\tsbuf.byteOffset+sbuf.byteLength > j\n\t\t\t\t)\n\t\t\t) {\n\t\t\t\t// We need to copy source values...\n\t\t\t\ttmp = new Float32Array( N );\n\t\t\t\tfor ( i = 0; i < N; i++ ) {\n\t\t\t\t\ttmp[ i ] = sbuf[ i ];\n\t\t\t\t}\n\t\t\t\tsbuf = tmp;\n\t\t\t}\n\t\t\tidx *= 2;\n\t\t\tN /= 2;\n\t\t\tj = 0;\n\t\t\tfor ( i = 0; i < N; i++ ) {\n\t\t\t\tbuf[ idx ] = sbuf[ j ];\n\t\t\t\tbuf[ idx+1 ] = sbuf[ j+1 ];\n\t\t\t\tidx += 2; // stride\n\t\t\t\tj += 2; // stride\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\t\t// If an array contains only complex numbers, then we need to extract real and imaginary components...\n\t\tif ( idx+N > this._length ) {\n\t\t\tthrow new RangeError( 'invalid arguments. Target array lacks sufficient storage to accommodate source values.' );\n\t\t}\n\t\tidx *= 2;\n\t\tfor ( i = 0; i < N; i++ ) {\n\t\t\tv = value[ i ];\n\t\t\tbuf[ idx ] = realf( v );\n\t\t\tbuf[ idx+1 ] = imagf( v );\n\t\t\tidx += 2; // stride\n\t\t}\n\t\treturn;\n\t}\n\tthrow new TypeError( format( 'invalid argument. First argument must be either a complex number, an array-like object, or a complex number array. Value: `%s`.', value ) );\n\n\t/* eslint-enable no-underscore-dangle */\n});\n\n\n// EXPORTS //\n\nmodule.exports = Complex64Array;\n", "/**\n* @license Apache-2.0\n*\n* Copyright (c) 2018 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n* http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n/**\n* 64-bit complex number array.\n*\n* @module @stdlib/array-complex64\n*\n* @example\n* var Complex64Array = require( '@stdlib/array-complex64' );\n*\n* var arr = new Complex64Array();\n* // returns \n*\n* var len = arr.length;\n* // returns 0\n*\n* @example\n* var Complex64Array = require( '@stdlib/array-complex64' );\n*\n* var arr = new Complex64Array( 2 );\n* // returns \n*\n* var len = arr.length;\n* // returns 2\n*\n* @example\n* var Complex64Array = require( '@stdlib/array-complex64' );\n*\n* var arr = new Complex64Array( [ 1.0, -1.0 ] );\n* // returns \n*\n* var len = arr.length;\n* // returns 1\n*\n* @example\n* var ArrayBuffer = require( '@stdlib/array-buffer' );\n* var Complex64Array = require( '@stdlib/array-complex64' );\n*\n* var buf = new ArrayBuffer( 16 );\n* var arr = new Complex64Array( buf );\n* // returns \n*\n* var len = arr.length;\n* // returns 2\n*\n* @example\n* var ArrayBuffer = require( '@stdlib/array-buffer' );\n* var Complex64Array = require( '@stdlib/array-complex64' );\n*\n* var buf = new ArrayBuffer( 16 );\n* var arr = new Complex64Array( buf, 8 );\n* // returns \n*\n* var len = arr.length;\n* // returns 2\n*\n* @example\n* var ArrayBuffer = require( '@stdlib/array-buffer' );\n* var Complex64Array = require( '@stdlib/array-complex64' );\n*\n* var buf = new ArrayBuffer( 32 );\n* var arr = new Complex64Array( buf, 8, 2 );\n* // returns \n*\n* var len = arr.length;\n* // returns 2\n*/\n\n// MODULES //\n\nvar main = require( './main.js' );\n\n\n// EXPORTS //\n\nmodule.exports = main;\n"], + "mappings": "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", "names": ["require_from_iterator", "__commonJSMin", "exports", "module", "isArrayLikeObject", "isComplexLike", "realf", "imagf", "format", "fromIterator", "it", "out", "v", "z", "require_from_iterator_map", "__commonJSMin", "exports", "module", "isArrayLikeObject", "isComplexLike", "realf", "imagf", "format", "fromIteratorMap", "it", "clbk", "thisArg", "out", "v", "z", "i", "require_from_array", "__commonJSMin", "exports", "module", "isComplexLike", "realf", "imagf", "fromArray", "buf", "arr", "len", "v", "i", "j", "require_main", "__commonJSMin", "exports", "module", "isNonNegativeInteger", "isArrayLikeObject", "isCollection", "isArrayBuffer", "isObject", "isArray", "isFunction", "isComplexLike", "isEven", "isInteger", "hasIteratorSymbolSupport", "ITERATOR_SYMBOL", "setReadOnly", "setReadOnlyAccessor", "Float32Array", "Complex64", "format", "realf", "imagf", "reinterpret64", "reinterpret128", "getter", "accessorGetter", "fromIterator", "fromIteratorMap", "fromArray", "BYTES_PER_ELEMENT", "HAS_ITERATOR_SYMBOL", "isComplexArray", "value", "Complex64Array", "isComplexArrayConstructor", "isComplex64Array", "isComplex128Array", "byteOffset", "nargs", "buf", "len", "src", "thisArg", "clbk", "out", "tmp", "get", "flg", "v", "i", "j", "args", "target", "start", "buffer", "self", "iter", "FLG", "next", "end", "factory", "z", "idx", "sbuf", "N", "main"] } diff --git a/docs/types/index.d.ts b/docs/types/index.d.ts index 7bf86b4..f9673d3 100644 --- a/docs/types/index.d.ts +++ b/docs/types/index.d.ts @@ -233,6 +233,33 @@ declare class Complex64Array implements Complex64ArrayInterface { */ get( i: number ): Complex64 | void; + /** + * Returns an array element with support for both nonnegative and negative integer indices. + * + * @param i - element index + * @throws index argument must be a integer + * @returns array element + * + * @example + * var arr = new Complex64Array( 10 ); + * + * var z = arr.at( 0 ); + * // returns + * + * arr.set( [ 1.0, -1.0 ], 0 ); + * arr.set( [ 9.0, -9.0 ], 9 ); + * + * z = arr.get( -1 ) + * // return + * + * z = arr.at( 100 ); + * // returns undefined + * + * z = arr.at( -100 ); + * // returns undefined + */ + at( i: number ): Complex64 | void; + /** * Sets an array element. * diff --git a/lib/main.js b/lib/main.js index c213d85..caee6eb 100644 --- a/lib/main.js +++ b/lib/main.js @@ -845,6 +845,78 @@ setReadOnly( Complex64Array.prototype, 'get', function get( idx ) { return new Complex64( buf[ idx ], buf[ idx+1 ] ); }); +/** +* Returns an array element with support for both nonnegative and negative integer indices. +* +* @name at +* @memberof Complex64Array.prototype +* @type {Function} +* @param {integer} idx - element index +* @throws {TypeError} `this` must be a complex number array +* @throws {TypeError} must provide a integer +* @returns {(Complex64|void)} array element +* +* @example +* var arr = new Complex64Array( 10 ); +* var realf = require( '@stdlib/complex-realf' ); +* var imagf = require( '@stdlib/complex-imagf' ); +* +* var z = arr.at( 0 ); +* // returns +* +* var re = realf( z ); +* // returns 0.0 +* +* var im = imagf( z ); +* // returns 0.0 +* +* arr.set( [ 1.0, -1.0 ], 0 ); +* arr.set( [ 2.0, -2.0 ], 1 ); +* arr.set( [ 9.0, -9.0 ], 9 ); +* +* z = arr.at( 0 ); +* // returns +* +* re = realf( z ); +* // returns 1.0 +* +* im = imagf( z ); +* // returns -1.0 +* +* z = arr.at( -1 ); +* // returns +* +* re = realf( z ); +* // returns 9.0 +* +* im = imagf( z ); +* // returns -9.0 +* +* z = arr.at( 100 ); +* // returns undefined +* +* z = arr.at( -100 ); +* // returns undefined +*/ +setReadOnly( Complex64Array.prototype, 'at', function at( idx ) { + var buf; + if ( !isComplexArray( this ) ) { + throw new TypeError( 'invalid invocation. `this` is not a complex number array.' ); + } + if ( !isInteger( idx ) ) { + throw new TypeError( format( 'invalid argument. Must provide a integer. Value: `%s`.', idx ) ); + } + if ( idx < 0 ) { + idx += this._length; + } + if ( idx < 0 || idx >= this._length ) { + return; + } + buf = this._buffer; + idx *= 2; + return new Complex64( buf[ idx ], buf[ idx+1 ] ); +}); + /** * Number of array elements. * @@ -886,7 +958,6 @@ setReadOnlyAccessor( Complex64Array.prototype, 'length', function get() { * * by the time we begin copying into the overlapping region, we are copying from the end of `src`, a non-overlapping region, which means we don't run the risk of copying copied values, rather than the original `src` values as intended. * -* * @name set * @memberof Complex64Array.prototype * @type {Function} diff --git a/package.json b/package.json index fc62cd6..6cb8f0b 100644 --- a/package.json +++ b/package.json @@ -69,7 +69,6 @@ "@stdlib/assert-is-complex64": "^0.1.1", "@stdlib/assert-is-negative-zero": "^0.1.1", "@stdlib/assert-is-positive-zero": "^0.1.1", - "@stdlib/bench": "^0.2.1", "@stdlib/complex-imag": "^0.1.1", "@stdlib/complex-real": "^0.1.1", "@stdlib/console-log-each": "^0.1.0", @@ -78,7 +77,8 @@ "proxyquire": "^2.0.0", "tape": "git+https://github.com/kgryte/tape.git#fix/globby", "istanbul": "^0.4.1", - "tap-min": "git+https://github.com/Planeshifter/tap-min.git" + "tap-min": "git+https://github.com/Planeshifter/tap-min.git", + "@stdlib/bench-harness": "^0.1.2" }, "engines": { "node": ">=0.10.0", diff --git a/test/test.at.js b/test/test.at.js new file mode 100644 index 0000000..33cfd21 --- /dev/null +++ b/test/test.at.js @@ -0,0 +1,147 @@ +/** +* @license Apache-2.0 +* +* Copyright (c) 2023 The Stdlib Authors. +* +* 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 +* +* Unless required by applicable law or agreed to in writing, software +* distributed under the License is distributed on an "AS IS" BASIS, +* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +* See the License for the specific language governing permissions and +* limitations under the License. +*/ + +'use strict'; + +// MODULES // + +var tape = require( 'tape' ); +var hasOwnProp = require( '@stdlib/assert-has-own-property' ); +var isFunction = require( '@stdlib/assert-is-function' ); +var Complex64 = require( '@stdlib/complex-float32' ); +var realf = require( '@stdlib/complex-realf' ); +var imagf = require( '@stdlib/complex-imagf' ); +var Complex64Array = require( './../lib' ); + + +// TESTS // + +tape( 'main export is a function', function test( t ) { + t.ok( true, __filename ); + t.strictEqual( typeof Complex64Array, 'function', 'main export is a function' ); + t.end(); +}); + +tape( 'attached to the prototype of the main export is an `at` method for returning an array element', function test( t ) { + t.strictEqual( hasOwnProp( Complex64Array.prototype, 'at' ), true, 'has property' ); + t.strictEqual( isFunction( Complex64Array.prototype.at ), true, 'has method' ); + t.end(); +}); + +tape( 'the method throws an error if invoked with a `this` context which is not a complex number array instance', function test( t ) { + var values; + var arr; + var i; + + arr = new Complex64Array( 5 ); + + values = [ + '5', + 5, + NaN, + true, + false, + null, + void 0, + {}, + [] + ]; + for ( i = 0; i < values.length; i++ ) { + t.throws( badValue( values[i] ), TypeError, 'throws an error when provided '+values[i] ); + } + t.end(); + + function badValue( value ) { + return function badValue() { + return arr.at.call( value, 0 ); + }; + } +}); + +tape( 'the method throws an error if provided an index argument which is not a integer', function test( t ) { + var values; + var arr; + var i; + + arr = new Complex64Array( 10 ); + + values = [ + '5', + 3.14, + NaN, + true, + false, + null, + void 0, + {}, + [], + function noop() {} + ]; + for ( i = 0; i < values.length; i++ ) { + t.throws( badValue( values[i] ), TypeError, 'throws an error when provided '+values[i] ); + } + t.end(); + + function badValue( value ) { + return function badValue() { + return arr.at( value ); + }; + } +}); + +tape( 'the method returns `undefined` if provided an index which exceeds array dimensions', function test( t ) { + var arr; + var v; + var i; + + arr = new Complex64Array( 10 ); + for ( i = -arr.length; i < arr.length; i++ ) { + if ( i < 0 ) { + v = arr.at( i-arr.length ); + t.strictEqual( v, void 0, 'returns expected value for index '+(i-arr.length) ); + } else { + v = arr.at( arr.length+i ); + t.strictEqual( v, void 0, 'returns expected value for index '+(arr.length+i) ); + } + } + t.end(); +}); + +tape( 'the method returns an array element', function test( t ) { + var arr; + var v; + var i; + + arr = []; + for ( i = 0; i < 10; i++ ) { + arr.push( new Complex64( i, -i ) ); + } + arr = new Complex64Array( arr ); + + for ( i = -arr.length; i < arr.length; i++ ) { + v = arr.at( i ); + if ( i < 0 ) { + t.strictEqual( realf( v ), arr.length + i, 'returns expected real component for index '+i ); + t.strictEqual( imagf( v ), -arr.length - i, 'returns expected imaginary component for index '+i ); + } else { + t.strictEqual( realf( v ), i, 'returns expected real component for index '+i ); + t.strictEqual( imagf( v ), -i, 'returns expected imaginary component for index '+i ); + } + } + t.end(); +});