Code Monkey home page Code Monkey logo

args-to-arr's Introduction

args-to-arr

CircleCI npm codecov jsDelivr dependencies dev dependencies packagephobia bundlephobia types Known Vulnerabilities license

Converts arguments or any other array-like object into an array starting from specific index.

Inspired by how Typescript handles ...rest arguments.

Install

npm i args-to-arr

CDN

jsDelivr

<script src="https://cdn.jsdelivr.net/npm/args-to-arr@latest/dist/args-to-arr.umd.js"></script>

for production

<script src="https://cdn.jsdelivr.net/npm/args-to-arr@latest/dist/args-to-arr.umd.min.js"></script>

more options...

unpkg

<script src="https://unpkg.com/args-to-arr@latest/dist/args-to-arr.umd.js"></script>

for production

<script src="https://unpkg.com/args-to-arr@latest/dist/args-to-arr.umd.min.js"></script>

more options...

Usage

Node.js

const toArray = require("args-to-arr");
const array = toArray(arrayLike, start);

Browser

After adding the script tag, toArray function will be available globally.

const array = toArray(arrayLike, start);

Reference

example

import toArray from "args-to-arr";

function anything(firstArg) {

  // convert arguments to array
  // starting from argument 1
  // it won't include firstArg
  const args = toArray(arguments, 1);

  // do something with the array

}

syntax

toArray<T>(arr: ArrayLike<T>, start: number = 0): T[];

return

type: Array

It returns a new array based on the provided parameters.

arr

type: Array | ArrayLike

Array or Array-like object to be converted to a new array.

start

type: number default: 0

Index number for array convertion to start from. If not provided or it equals null or undefined it will default to 0.

Providing a negative start index will cause the function to start iterating X items from the end of the array, see the following example.

example

const array = toArray([1, 2, 3, 4], -2);
console.log(array);
[ 3, 4 ]

If the provided negative start index exceeds the size of the array, it will fill the begining of the resulting array with empty values.

example

const array = toArray([1, 2], -4);
console.log(array);
[ <2 empty items>, 1, 2 ]

License

MIT © Manuel Fernández

args-to-arr's People

Contributors

dependabot-preview[bot] avatar dependabot[bot] avatar greenkeeper[bot] avatar manferlo81 avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.