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

{% codeblock array/array_replace.js lang:js https://raw.github.com/kvz/phpjs/master/functions/array/array_replace.js raw on github %}
function array_replace (arr) {
  // +   original by: Brett Zamir (http://brett-zamir.me)
  // *     example 1: array_replace(["orange", "banana", "apple", "raspberry"], {0 : "pineapple", 4 : "cherry"}, {0:"grape"});
  // *     returns 1: {0: 'grape', 1: 'banana', 2: 'apple', 3: 'raspberry', 4: 'cherry'}

  var retObj = {},
    i = 0,
    p = '',
    argl = arguments.length;

  if (argl < 2) {
    throw new Error('There should be at least 2 arguments passed to array_replace()');
  }

  // Although docs state that the arguments are passed in by reference, it seems they are not altered, but rather the copy that is returned (just guessing), so we make a copy here, instead of acting on arr itself
  for (p in arr) {
    retObj[p] = arr[p];
  }

  for (i = 1; i < argl; i++) {
    for (p in arguments[i]) {
      retObj[p] = arguments[i][p];
    }
  }
  return retObj;
}
{% endcodeblock %}

 - [Raw function on GitHub](https://github.com/kvz/phpjs/blob/master/functions/array/array_replace.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_replace.js)

### Example 1
This code
{% codeblock lang:js example %}
array_replace(["orange", "banana", "apple", "raspberry"], {0 : "pineapple", 4 : "cherry"}, {0:"grape"});
{% endcodeblock %}

Should return
{% codeblock lang:js returns %}
{0: 'grape', 1: 'banana', 2: 'apple', 3: 'raspberry', 4: 'cherry'}
{% endcodeblock %}


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