search
PatreonTwitternpmGitHub

string.replace()

The string.replace() function replaces the first or all $substring occurrences in the string with $replacement.

// Modules.
@use 'string.replace.function';

// The `string.replace()` function.
@function replace($string, $occurrence, $substring, $replacement) {
  @each $value in $substring {
    $index: string.index($string, $value);
    @while not($index == null) {
      $string: string.insert(
        string.slice($string, 1, $index - 1) +
          string.slice(
            $string,
            $index + string.length($value),
            string.length($string)
          ),
        $replacement,
        $index
      );
      @if $occurrence == first {
        $index: null;
      }
      @if $occurrence == all or ($occurrence == first and not ($index == null))
      {
        $index: string.index($string, $value);
      }
    }
  }
  @return $string;
}
https://github.com/angular-package/sass/blob/main/string/_string.replace.function.scss

hashtag
Parameters

hashtag
$string

A string to replace first or all $substring in it by $replacement.

hashtag
$occurrence

First or all occurrences of $substring to replace in $string.

hashtag
$substring

A string or list of strings to replace by $replacement.

hashtag
$replacement

A string to replace $substring.

hashtag
Return

The return value is a string with a first/all replaced $substring by $replacement.

hashtag
Examples

Previousstring.replace-multiple()Nextstring.split()

Last updated