columns

28 Okt 2022

Library "columns"
Error Tolerant Matrix Setter/Getter Operations. Easy ways to add/remove items into start and end of Columns as well as arrays to grow and shrink matrix.

if mismatched sizes occur the typified NA value will be there to prevent catastrophic crashing.

Rows and Columns are split into 2 libraries due to limitations on number of exports as well as ease of style (columns.shift(), rows.pop() )


pop(_matrix)
  do pop last Column off of matrix
  Parameters:
    _matrix: Matrix To Edit
  Returns: Array of Last Column, removing it from matrix

shift(_matrix)
  do shift the first Column off of matrix
  Parameters:
    _matrix: Matrix To Edit
  Returns: Array of First Column, removing it from matrix

get(_matrix, _clmnNum)
  retrieve specific Column of matrix
  Parameters:
    _matrix: Matrix To Edit
    _clmnNum: Column being Targeted
  Returns: Array of selected Column number, leaving in place

push(_matrix, _clmnNum, _item)
  add single item onto end of Column
  Parameters:
    _matrix: Matrix To Edit
    _clmnNum: Column being Targeted
    _item: Item to Push on Column
  Returns: shifted item from Column start

push(_matrix, _array)
  add single item onto end of matrix
  Parameters:
    _matrix: Matrix To Edit
    _array: Array to Push on Matrix
  Returns: Void

unshift(_matrix, _clmnNum, _item)
  slide single item into start of Column remove last
  Parameters:
    _matrix: Matrix To Edit
    _clmnNum: Column being Targeted
    _item: Item to Unshift on Column
  Returns: popped item from Column end

unshift(_matrix, _array)
  add single item into first Column of matrix
  Parameters:
    _matrix: Matrix To Edit
    _array: Array to unshift into Matrix
  Returns: Void

set(_matrix, _clmnNum, _array)
  replace an array to an existing Column
  Parameters:
    _matrix: Matrix To Edit
    _clmnNum: Column being Targeted
    _array: Array to place in Matrix
  Returns: Column that was replaced

insert(_matrix, _clmnNum, _array)
  insert an array to a new Column
  Parameters:
    _matrix: Matrix To Edit
    _clmnNum: Column being Targeted
    _array: Array to place in Matrix
  Returns: void

slideDown(_matrix, _array)
  add single item onto end of Column
  Parameters:
    _matrix: Matrix To Edit
    _array: Array to push to Matrix
  Returns: shifted first Column

slideUp(_matrix, _array)
  add single item onto end of Column
  Parameters:
    _matrix: Matrix To Edit
    _array: Array to unshift to Matrix
  Returns: poppeed last Column

pullOut(_matrix, _clmnNum)
  add single item onto end of Column
  Parameters:
    _matrix: Matrix To Edit
    _clmnNum: Column being Targeted
  Returns: removed selected Column

10 Nov 2022

Nota Keluaran

v2

Small update for zero sized matrixes

14 Mac 2023

Nota Keluaran

v3

Methods :)

9 Jun 2023

Nota Keluaran

v4

Added:
method sortby(_matrix, _rowNum)
  Namespace types: matrix<int>
  Parameters:
    _matrix (matrix<int>): Matrix To Sort
    _rowNum (int): Row to utilize for sorting
  Returns: sorted matrix