|  | var toString = require('./toString'); | 
|  |  | 
|  | /** | 
|  | * Replaces matches for `pattern` in `string` with `replacement`. | 
|  | * | 
|  | * **Note:** This method is based on | 
|  | * [`String#replace`](https://mdn.io/String/replace). | 
|  | * | 
|  | * @static | 
|  | * @memberOf _ | 
|  | * @since 4.0.0 | 
|  | * @category String | 
|  | * @param {string} [string=''] The string to modify. | 
|  | * @param {RegExp|string} pattern The pattern to replace. | 
|  | * @param {Function|string} replacement The match replacement. | 
|  | * @returns {string} Returns the modified string. | 
|  | * @example | 
|  | * | 
|  | * _.replace('Hi Fred', 'Fred', 'Barney'); | 
|  | * // => 'Hi Barney' | 
|  | */ | 
|  | function replace() { | 
|  | var args = arguments, | 
|  | string = toString(args[0]); | 
|  |  | 
|  | return args.length < 3 ? string : string.replace(args[1], args[2]); | 
|  | } | 
|  |  | 
|  | module.exports = replace; |