---
layout: page
title: "JavaScript array_unshift function"
comments: true
sharing: true
footer: true
alias:
- /functions/view/array_unshift:347
- /functions/view/array_unshift
- /functions/view/347
- /functions/array_unshift:347
- /functions/347
---
<!-- Generated by Rakefile:build -->
A JavaScript equivalent of PHP's array_unshift

{% codeblock array/array_unshift.js lang:js https://raw.github.com/kvz/phpjs/master/functions/array/array_unshift.js raw on github %}
function array_unshift (array) {
  // From: http://phpjs.org/functions
  // +   original by: Kevin van Zonneveld (http://kevin.vanzonneveld.net)
  // +   improved by: Martijn Wieringa
  // +   improved by: jmweb
  // %        note 1: Currently does not handle objects
  // *     example 1: array_unshift(['van', 'Zonneveld'], 'Kevin');
  // *     returns 1: 3
  var i = arguments.length;

  while (--i !== 0) {
    arguments[0].unshift(arguments[i]);
  }

  return arguments[0].length;
}
{% endcodeblock %}

 - [Raw function on GitHub](https://github.com/kvz/phpjs/blob/master/functions/array/array_unshift.js)

Please note that php.js uses JavaScript objects as substitutes for PHP arrays, they are 
the closest match to this hashtable-like data structure. 

Please also note that php.js offers community built functions and goes by the 
[McDonald's Theory](https://medium.com/what-i-learned-building/9216e1c9da7d). We'll put online 
functions that are far from perfect, in the hopes to spark better contributions. 
Do you have one? Then please just: 

 - [Edit on GitHub](https://github.com/kvz/phpjs/edit/master/functions/array/array_unshift.js)

### Example 1
This code
{% codeblock lang:js example %}
array_unshift(['van', 'Zonneveld'], 'Kevin');
{% endcodeblock %}

Should return
{% codeblock lang:js returns %}
3
{% endcodeblock %}


### Other PHP functions in the array extension
{% render_partial _includes/custom/array.html %}