#async-replace

Run replace on a string and update it asynchronous.

usage

async-replace have the same api as the callback-version of String.prototype.replace but instead of returning the changed data another callback is called, making it possible to do asynchronous stuff in the callback.

This may sound more complicated than it is, so let's look at an example.

1function replacer(match, p1, p2, p3, offset, string){
2    // p1 is nondigits, p2 digits, and p3 non-alphanumerics
3    return [p1, p2, p3].join(' - ');
4};
5newString = "abc12345#$*%".replace(/([^\d]*)(\d*)([^\w]*)/, replacer);

Above is an example of using String.prototype.replace with a callback. The above could then be written in async-replace like this

1function replacer(match, p1, p2, p3, offset, string, done){
2    // p1 is nondigits, p2 digits, and p3 non-alphanumerics
3    setTimeout(function() {
4        done(null, [p1, p2, p3].join(' - '));
5    }, 100);
6};
7asyncReplace("abc12345#$*%", /([^\d]*)(\d*)([^\w]*)/, replacer, function(err, result) {
8    console.log(result); // will print 'abc - 12345 - #$*%';
9});