Requires the Hack Standard Library to be installed.
Facebook Engineer?

This function is available as Regex\replace() in Facebook's www repository.

Returns $haystack with any substring matching $pattern replaced by $replacement

namespace HH\Lib\Regex;

function replace(
  string $haystack,
  Pattern<Match> $pattern,
  string $replacement,
  int $offset = 0,
): string;

If $offset is given, replacements are made only starting from $offset.

Throws Invariant[Violation]Exception if $offset is not within plus/minus the length of $haystack.


  • string $haystack
  • Pattern<Match> $pattern
  • string $replacement
  • int $offset = 0


  • string