Function replaceFirst

replaceFirst(
    text?: null | string,
    search?: null | string | RegExp,
    replace?: null | string,
): undefined | null | string
Returns the string that replaced the first occurrence in the given text
Parameters
- Optionaltext: null | string
  the text to inspect
- Optionalsearch: null | string | RegExp
  the string or regex to match
- Optionalreplace: null | string
  the expected replacement string
Returns undefined | null | string
the string that replaced the first occurrence in the given text
Author
David Hsing
Example
```
replaceFirst(undefined, undefined, undefined);    // undefined
replaceFirst('foobar-foobar', 'foobar', undefined);    // 'foobar-foobar'
replaceFirst('foobar-foobar', 'foobar', 'hello');    // 'hello-foobar'
```