docs: improve doctests for complex number typed arrays in array/complex64

lib/node_modules/@stdlib/array/complex64/docs/types/index.d.ts

@@ -444,10 +444,7 @@ declare class Complex64Array implements Complex64ArrayInterface {
 	*
 	* // Copy the first two elements to the last two elements:
 	* arr.copyWithin( 2, 0, 2 );
-	*
-	* // Get the last array element:
-	* var z = arr.get( 3 );
-	* // returns <Complex64>[ 2.0, 2.0 ]
+	* // arr => <Complex64Array>[ 1.0, 1.0, 2.0, 2.0, 1.0, 1.0, 2.0, 2.0 ]
 	*/
 	copyWithin( target: number, start: number, end?: number ): Complex64Array;
 

lib/node_modules/@stdlib/array/complex64/lib/main.js

@@ -254,7 +254,7 @@
 			}
 			buf = buf[ ITERATOR_SYMBOL ]();
 			if ( !isFunction( buf.next ) ) {
 				throw new TypeError( format( 'invalid argument. Must provide a length, ArrayBuffer, typed array, array-like object, or an iterable. Value: `%s`.', buf ) ); // FIXME: `buf` is what is returned from above, NOT the original value
 			}
 			buf = fromIterator( buf );
 			if ( buf instanceof Error ) {
@@ -683,16 +683,13 @@
 *
 * // Copy the first two elements to the last two elements:
 * arr.copyWithin( 2, 0, 2 );
-*
-* // Get the last array element:
-* var z = arr.get( 3 );
-* // returns <Complex64>[ 2.0, 2.0 ]
+* // arr => <Complex64Array>[ 1.0, 1.0, 2.0, 2.0, 1.0, 1.0, 2.0, 2.0 ]
 */
 setReadOnly( Complex64Array.prototype, 'copyWithin', function copyWithin( target, start ) {
 	if ( !isComplexArray( this ) ) {
 		throw new TypeError( 'invalid invocation. `this` is not a complex number array.' );
 	}
 	// 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
 	if ( arguments.length === 2 ) {
 		this._buffer.copyWithin( target*2, start*2 );
 	} else {
@@ -1731,7 +1728,7 @@
 * arr.set( [ 2.0, 2.0 ], 1 );
 * arr.set( [ 3.0, 3.0 ], 2 );
 *
 * var z = arr.reduce( caddf );
 * // returns <Complex64>[ 6.0, 6.0 ]
 */
 setReadOnly( Complex64Array.prototype, 'reduce', function reduce( reducer, initialValue ) {
@@ -1788,7 +1785,7 @@
 * arr.set( [ 2.0, 2.0 ], 1 );
 * arr.set( [ 3.0, 3.0 ], 2 );
 *
 * var z = arr.reduceRight( caddf );
 * // returns <Complex64>[ 6.0, 6.0 ]
 */
 setReadOnly( Complex64Array.prototype, 'reduceRight', function reduceRight( reducer, initialValue ) {
@@ -2010,7 +2007,7 @@
 				// We need to copy source values...
 				tmp = new Float32Array( N );
 				for ( i = 0; i < N; i++ ) {
 					tmp[ i ] = sbuf[ i ]; // TODO: handle accessor arrays
 				}
 				sbuf = tmp;
 			}