ubique/lib/matarrs/size.js

A mathematical and quantitative library for Javascript and Node.js

/**
 * Array Dimensions
 */
 module.exports = function($u) {
/**
 * @method size
 * @summary Size of N-D array
 * @description Size of N-D array. N-D array is equal to MxN matrix, 
 * 1-D Array is equal to 1xN, Number is equal to 1x1 array
 * 
 * @param  {string|number|array|matrix} x array of elements
 * @return {array}  
 *
 * @example
 * ubique.size([[[[5,6,5],[7,8,-1]]]]);
 * // [ 1, 1, 2, 3 ]
 * 
 * ubique.size([[3,2,7],[4,5,6]]);
 * //  [ 2, 3 ]
 * 
 * ubique.size([5,4,4]);
 * // [ 1, 3 ]
 * 
 * ubique.size(5);
 * // [ 1, 1 ]
 * 
 * ubique.size('ubique');
 * // [ 1, 6 ]
 * 
 * ubique.size([['first','second']]);
 * // [ 1, 2 ]
 */
 $u.size = function(x) {
 	if (arguments.length === 0) {
 		throw new Error('not enough input arguments');
 	}
 	if ($u.isnull(x) || $u.isundefined(x)) {
 		throw new Error('unknown input type');
 	}
  if ($u.isstring(x)) {
    return [1,x.length];
  }
  if ($u.isnumber(x)) {
    return [1, 1];
  }
  if ($u.isarray(x)) {
    return [1,x.length];
  }
  var siz = x.length;
  var _siz = [];
  while (!$u.isundefined(siz) && !$u.isstring(x)) {
   _siz.push(siz);
   x = x[0];
   siz = x.length;
 } 
 return _siz;
}

}