1. module gulp-replace
   1. function gulp-replace (search, replacement, options)

module gulp-replace

function gulp-replace (search, replacement, options)

• description and source-code

  gulp-replace = function (search, replacement, options) {
    return new Transform({
      objectMode: true,
      transform: function(file, enc, callback) {
        if (file.isNull()) {
          return callback(null, file);
        }
  
        function doReplace() {
          if (file.isStream()) {
            file.contents = file.contents.pipe(rs(search, replacement));
            return callback(null, file);
          }
  
          if (file.isBuffer()) {
            if (search instanceof RegExp) {
              file.contents = new Buffer(String(file.contents).replace(search, replacement));
            }
            else {
              var chunks = String(file.contents).split(search);
  
              var result;
              if (typeof replacement === 'function') {
                // Start with the first chunk already in the result
                // Replacements will be added thereafter
                // This is done to avoid checking the value of i in the loop
                result = [ chunks[0] ];
  
                // The replacement function should be called once for each match
                for (var i = 1; i < chunks.length; i++) {
                  // Add the replacement value
                  result.push(replacement(search));
  
                  // Add the next chunk
                  result.push(chunks[i]);
                }
  
                result = result.join('');
              }
              else {
                result = chunks.join(replacement);
              }
  
              file.contents = new Buffer(result);
            }
            return callback(null, file);
          }
  
          callback(null, file);
        }
  
        if (options && options.skipBinary) {
          istextorbinary.isText(file.path, file.contents, function(err, result) {
            if (err) {
              return callback(err, file);
            }
  
            if (!result) {
              callback(null, file);
            } else {
              doReplace();
            }
          });
  
          return;
        }
  
        doReplace();
      }
    });
  }

• example usage

  n/a