Synopsis

ply is a collection of wrappers around Function.prototype.apply.

![stability 5 - locked
](http://nodejs.org/api/documentation.html#documentation_stability_index)  


  

Why?

It's trivial to implement, but in order to keep code DRY (and avoid silly mistakes) it makes sense to define this function only once per project. This library is the logical consequence of that.

Install

Node.js

$3

``sh
npm install ply
`

$3

`sh
git clone https://github.com/pluma/ply.git
cd ply
npm install
make
`

Browser

$3

`sh
component install pluma/ply
`

Learn more about component.

$3

`sh
bower install ply
`

Learn more about bower.

$3

Download the latest minified CommonJS release and add it to your project.

Learn more about CommonJS modules.

$3

Download the latest minified AMD release and add it to your project.

Learn more about AMD modules.

$3

Download the latest minified standalone release and add it to your project.

`html

`

This makes the ply module available in the global namespace.

Basic usage example

`javascript
var mcall = require('ply').mcall;

mcall(console, 'log', 'Hello', 'World'); // 'Hello' 'World'
`

API

apply(fn:Function, self:Object, args:Array)

Equivalent to the following:

`javascript
fn.apply(self, args);
`

call(fn:Function, self:Object, args...)

Equivalent to the following:

`javascript
fn.call(self, args...);
`

fapply(fn:Function, args:Array)

Equivalent to the following:

`javascript
fn.apply(this, args);
`

fcall(fn:Function, args...)

Equivalent to the following:

`javascript
fn.call(this, args...);
`

mapply(obj:Object, name:String, args:Array)

Equivalent to the following:

`javascript
obj[name].apply(obj, args);
`

mcall(obj:Object, name:String, args...)

Equivalent to the following:

`javascript
obj[name].call(obj, args...);
``

Unlicense

This is free and unencumbered public domain software. For more information, see http://unlicense.org/ or the accompanying UNLICENSE file.