1.0.1 • Published 5 years ago

common-algorithms v1.0.1

Weekly downloads
3
License
ISC
Repository
github
Last release
5 years ago

Common algorithms

CircleCI Coverage Status

A small module that contains the most common sorting and searching algorithms.

Installation

npm install --save common-algorithms

Contents

AlgorithmsTypeO (time)Θ (time)Ω (time)O (space)
Selection SortSortn2n2n21
Insertion SortSortn2n2n1
Quick SortSortn2n * log2(n)n * log2(n)log2(n)
Merge SortSortn * log2(n)n * log2(n)n * log2(n)n
Heap SortSortn * log2(n)n * log2(n)n * log2(n)1
Shell SortSortn * log2(n)2n * log2(n)2n * log2(n)1
Shuffle (Fisher–Yates)Sortnnn1
Binary SearchSearchlog2(n)log2(n)11

Usage

Using require()

const algorithms = require('common-algorithms')

Using ES6 Import/Export

import * as algorithms from 'common-algorithms'

Exports

The module exports the following object:

{
  search: {
    binarySearch <Function>,
  },
  sort: {
    heapSort <Function>,
    insertionSort <Function>,
    mergeSort <Function>,
    quickSort <Function>,
    selectionSort <Function>,
    shellSort <Function>,
    shuffle <Function>,
  },
}

Custom comparator

A custom comparator can be given as a parameter.

Example 1:

const { quickSort } = require('common-algorithms').sort

const arr = [12, 0, -23, 4, 6, 14, 102, -5];

quickSort(arr, (a, b) => {
  if (a < b) return 1;
  if (a > b) return -1;
  return 0
});

Example 2:

const { quickSort } = require('common-algorithms').sort

function SomeObj(value) {
  this.value = value;
}
        
const arr = [new SomeObj(5), new SomeObj(-5), new SomeObj(-22), new SomeObj(108), new SomeObj(37)];

quickSort(arr, (a, b) => {
  if (a.value < b.value) return -1;
  if (a.value > b.value) return 1;
  return 0;
});