Added implementation for @stdlib/string/base/replace-after

lib/node_modules/@stdlib/string/base/package.json

@@ -56,6 +56,8 @@
     "utility",
     "utils",
     "util",
-    "base"
+    "base",
+    "replace"
   ]
 }
+

lib/node_modules/@stdlib/string/base/replace-after/README.md

@@ -0,0 +1,249 @@
+<!--
+
+@license Apache-2.0
+
+Copyright (c) 2023 The Stdlib Authors.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+-->
+
+# replaceAfter
+
+> Replace the substring after the first occurrence of a specified search string.
+
+<!-- Section to include introductory text. Make sure to keep an empty line after the intro `section` element and another before the `/section` close. -->
+
+<section class="intro">
+
+</section>
+
+<!-- /.intro -->
+
+<!-- Package usage documentation. -->
+
+<section class="usage">
+
+## Usage
+
+```javascript
+var replaceAfter = require( '@stdlib/string/base/replace-after' );
+```
+
+#### replaceAfter( str, replacement, search\[, fromIndex] )
+
+Replaces the substring after the first occurrence of a specified search string.
+
+```javascript
+var str = 'beep boop';
+var replacement = 'foo';
+var out = replaceAfter( str, replacement, 'o' );
+// returns 'beep bofoo'
+
+out = replaceAfter( str, replacement, ' ' );
+// returns 'beep foo'
+```
+
+By default, the search starts at the beginning of the string. To start searching from a different index, provide a `fromIndex` argument:
+
+```javascript
+var str = 'boop baz boop';
+var replacement = 'foo';
+var out = replaceAfter( str, replacement, 'o', 3 );
+// returns 'boop baz bofoo'
+```
+
+</section>
+
+<!-- /.usage -->
+
+<!-- Package usage notes. Make sure to keep an empty line after the `section` element and another before the `/section` close. -->
+
+<section class="notes">
+
+## Notes
+
+-   If a substring is not present in a provided string, the function returns an empty string.
+-   If provided an empty substring, the function returns the input string.
+-   If `fromIndex` is less than `0` or greater than `str.length`, the search starts at index `0` and `str.length`, respectively.
+
+</section>
+
+<!-- /.notes -->
+
+<!-- Package usage examples. -->
+
+<section class="examples">
+
+## Examples
+
+<!-- eslint no-undef: "error" -->
+
+```javascript
+var replaceAfter = require( '@stdlib/string/base/replace-after' );
+
+var str = 'To be, or not to be, that is the question.';
+var replacement = 'foo';
+var out = replaceAfter( str, replacement, ', ' );
+// returns 'To be, foo'
+
+out = replaceAfter( str, replacement, 'to be' );
+// returns 'To be, or not to befoo'
+
+out = replaceAfter( str, replacement, 'question.' );
+// returns 'To be, or not to be, that is the question.foo'
+
+out = replaceAfter( str, replacement, 'xyz' );
+// returns ''
+
+out = replaceAfter( str, replacement, '' );
+// returns 'foo'
+```
+
+</section>
+
+<!-- /.examples -->
+
+<!-- Section for describing a command-line interface. -->
+
+* * *
+
+<section class="cli">
+
+## CLI
+
+<!-- CLI usage documentation. -->
+
+<section class="usage">
+
+### Usage
+
+```text
+Usage: replace-after [options] --search=<string> --replacement=<string> [<string>]
+
+Options:
+
+  -h,    --help                Print this message.
+  -V,    --version             Print the package version.
+         --search string       Search string.
+         --replacement string  Replacement string.
+         --from-index int      Start index. Default: 0.
+         --split sep           Delimiter for stdin data. Default: '/\\r?\\n/'.
+```
+
+</section>
+
+<!-- /.usage -->
+
+<!-- CLI usage notes. Make sure to keep an empty line after the `section` element and another before the `/section` close. -->
+
+<section class="notes">
+
+### Notes
+
+-   If the split separator is a [regular expression][mdn-regexp], ensure that the `split` option is either properly escaped or enclosed in quotes.
+
+    ```bash
+    # Not escaped...
+    $ echo -n $'foo\nbar\nbaz' | replace-after --search a --replacement b --split /\r?\n/
+
+    # Escaped...
+    $ echo -n $'foo\nbar\nbaz' | replace-after --search a --replacement b --split /\\r?\\n/
+    ```
+
+-   The implementation ignores trailing delimiters.
+
+</section>
+
+<!-- /.notes -->
+
+<!-- CLI usage examples. -->
+
+<section class="examples">
+
+### Examples
+
+```bash
+$ replace-after abcdefg --search d --replacement pqr
+abcdpqr
+```
+
+To use as a [standard stream][standard-streams],
+
+```bash
+$ echo -n $'bar\nbaz' | replace-after --search b --replacement pqr
+bpqr
+bpqr
+```
+
+By default, when used as a [standard stream][standard-streams], the implementation assumes newline-delimited data. To specify an alternative delimiter, set the `split` option.
+
+```bash
+$ echo -n 'bar\tbaz' | replace-after --search b --replacement pqr --split '\t'
+bpqr
+bpqr
+```
+
+</section>
+
+<!-- /.examples -->
+
+</section>
+
+<!-- /.cli -->
+
+<!-- Section to include cited references. If references are included, add a horizontal rule *before* the section. Make sure to keep an empty line after the `section` element and another before the `/section` close. -->
+
+<section class="references">
+
+</section>
+
+<!-- /.references -->
+
+<!-- Section for related `stdlib` packages. Do not manually edit this section, as it is automatically populated. -->
+
+<section class="related">
+
+* * *
+
+## See Also
+
+-   <span class="package-name">[`@stdlib/string/substring-before`][@stdlib/string/substring-before]</span><span class="delimiter">: </span><span class="description">return the part of a string before a specified substring.</span>
+-   <span class="package-name">[`@stdlib/string/substring-before-last`][@stdlib/string/substring-before-last]</span><span class="delimiter">: </span><span class="description">return the part of a string before the last occurrence of a specified substring.</span>
+-   <span class="package-name">[`@stdlib/string/replace-after-last`][@stdlib/string/substring-after-last]</span><span class="delimiter">: </span><span class="description">return the part of a string after the last occurrence of a specified substring.</span>
+
+</section>
+
+<!-- /.related -->
+
+<!-- Section for all links. Make sure to keep an empty line after the `section` element and another before the `/section` close. -->
+
+<section class="links">
+
+[standard-streams]: https://en.wikipedia.org/wiki/Standard_streams
+
+[mdn-regexp]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions
+
+<!-- <related-links> -->
+
+[@stdlib/string/substring-before]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/string/substring-before
+
+[@stdlib/string/substring-before-last]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/string/substring-before-last
+
+[@stdlib/string/substring-after-last]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/string/replace-after-last
+
+<!-- </related-links> -->
+
+</section>
+
+<!-- /.links -->

lib/node_modules/@stdlib/string/base/replace-after/package.json

@@ -0,0 +1,72 @@
+{
+    "name": "@stdlib/string/base/replace-after",
+    "version": "0.0.0",
+    "description": "Replace the substring after the first occurrence of a specified search string.",
+    "license": "Apache-2.0",
+    "author": {
+      "name": "The Stdlib Authors",
+      "url": "https://github.com/stdlib-js/stdlib/graphs/contributors"
+    },
+    "contributors": [
+      {
+        "name": "The Stdlib Authors",
+        "url": "https://github.com/stdlib-js/stdlib/graphs/contributors"
+      }
+    ],
+    "bin": {
+      "substring-after": "./bin/cli"
+    },
+    "main": "./lib",
+    "directories": {
+      "benchmark": "./benchmark",
+      "doc": "./docs",
+      "example": "./examples",
+      "lib": "./lib",
+      "test": "./test"
+    },
+    "types": "./docs/types",
+    "scripts": {},
+    "homepage": "https://github.com/stdlib-js/stdlib",
+    "repository": {
+      "type": "git",
+      "url": "git://github.com/stdlib-js/stdlib.git"
+    },
+    "bugs": {
+      "url": "https://github.com/stdlib-js/stdlib/issues"
+    },
+    "dependencies": {},
+    "devDependencies": {},
+    "engines": {
+      "node": ">=0.10.0",
+      "npm": ">2.7.0"
+    },
+    "os": [
+      "aix",
+      "darwin",
+      "freebsd",
+      "linux",
+      "macos",
+      "openbsd",
+      "sunos",
+      "win32",
+      "windows"
+    ],
+    "keywords": [
+      "stdlib",
+      "stdstring",
+      "utilities",
+      "utility",
+      "utils",
+      "util",
+      "string",
+      "str",
+      "check",
+      "search",
+      "replacement",
+      "substring",
+      "substr",
+      "after",
+      "match"
+    ]
+  }
+