index.mjs.map

{"version":3,"file":"index.mjs","sources":["../lib/main.js"],"sourcesContent":["/**\n* @license Apache-2.0\n*\n* Copyright (c) 2023 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\nimport args2multislice from '@stdlib/slice-base-args2multislice';\nimport Slice from '@stdlib/slice-ctor';\nimport slice from '@stdlib/ndarray-base-slice';\nimport nulls from '@stdlib/array-base-nulls';\nimport ndims from '@stdlib/ndarray-base-ndims';\nimport format from '@stdlib/error-tools-fmtprodmsg';\n\n\n// MAIN //\n\n/**\n* Returns a view of an input ndarray in which the order of elements along a specified dimension is reversed.\n*\n* @param {ndarray} x - input array\n* @param {integer} dim - index of dimension to reverse\n* @param {boolean} writable - boolean indicating whether a returned array should be writable\n* @throws {TypeError} first argument must be an ndarray having one or more dimensions\n* @throws {RangeError} dimension index exceeds the number of dimensions\n* @returns {ndarray} ndarray view\n*\n* @example\n* import ndarray from '@stdlib/ndarray-ctor';\n* import ndarray2array from '@stdlib/ndarray-to-array';\n*\n* var buffer = [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ];\n* var shape = [ 3, 2 ];\n* var strides = [ 2, 1 ];\n* var offset = 0;\n*\n* var x = ndarray( 'generic', buffer, shape, strides, offset, 'row-major' );\n* // returns <ndarray>\n*\n* var sh = x.shape;\n* // returns [ 3, 2 ]\n*\n* var arr = ndarray2array( x );\n* // returns [ [ 1.0, 2.0 ], [ 3.0, 4.0 ], [ 5.0, 6.0 ] ]\n*\n* var y = reverseDimension( x, 0, false );\n* // returns <ndarray>\n*\n* sh = y.shape;\n* // returns [ 3, 2 ]\n*\n* arr = ndarray2array( y );\n* // returns [ [ 5.0, 6.0 ], [ 3.0, 4.0 ], [ 1.0, 2.0 ] ]\n*/\nfunction reverseDimension( x, dim, writable ) {\n\tvar args;\n\tvar N;\n\tvar d;\n\n\t// Retrieve the number of array dimensions:\n\tN = ndims( x );\n\n\t// Check whether we were provided a zero-dimensional array...\n\tif ( N === 0 ) {\n\t\tthrow new TypeError( format( '1lBF7', N ) );\n\t}\n\t// Normalize the dimension index...\n\td = dim;\n\tif ( d < 0 ) {\n\t\td += N;\n\t\tif ( d < 0 ) {\n\t\t\tthrow new RangeError( format( '1lBF8', N, dim ) );\n\t\t}\n\t} else if ( d >= N ) {\n\t\tthrow new RangeError( format( '1lBF8', N, dim ) );\n\t}\n\t// Define a list of MultiSlice constructor arguments:\n\targs = nulls( N );\n\targs[ d ] = new Slice( null, null, -1 );\n\n\t// Return a new array view:\n\treturn slice( x, args2multislice( args ), true, writable );\n}\n\n\n// EXPORTS //\n\nexport default reverseDimension;\n"],"names":["reverseDimension","x","dim","writable","args","N","d","ndims","TypeError","format","RangeError","nulls","Slice","slice","args2multislice"],"mappings":";;yiBAqEA,SAASA,EAAkBC,EAAGC,EAAKC,GAClC,IAAIC,EACAC,EACAC,EAMJ,GAAW,KAHXD,EAAIE,EAAON,IAIV,MAAM,IAAIO,UAAWC,EAAQ,QAASJ,IAIvC,IADAC,EAAIJ,GACK,GAER,IADAI,GAAKD,GACI,EACR,MAAM,IAAIK,WAAYD,EAAQ,QAASJ,EAAGH,SAErC,GAAKI,GAAKD,EAChB,MAAM,IAAIK,WAAYD,EAAQ,QAASJ,EAAGH,IAO3C,OAJAE,EAAOO,EAAON,IACRC,GAAM,IAAIM,EAAO,KAAM,MAAO,GAG7BC,EAAOZ,EAAGa,EAAiBV,IAAQ,EAAMD,EACjD"}