Функция preg_replace

Функция preg_replace ищет в строке совпадения с регулярным выражением и заменяет их на указанную строку. Первым параметром принимает регулярное выражение для поиска, вторым - строку замены, третьим - исходную строку. Дополнительно можно указать лимит замен и переменную для подсчета замен.

Синтаксис

phppreg_replace(pattern, replacement, subject, [limit], [count]);

Пример

Заменим все цифры в строке на символ 'X':

php<?php
  $str = 'a1b2c3';
  $res = preg_replace('/\d/', 'X', $str);
  echo $res;
?>

Результат выполнения кода:

php'aXbXcX'

Пример

Заменим только первые 2 совпадения:

php<?php
  $str = 'a1b2c3';
  $res = preg_replace('/\d/', 'X', $str, 2);
  echo $res;
?>

Результат выполнения кода:

php'aXbXc3'

Пример

Использование обратных ссылок в замене:

php<?php
  $str = 'Hello World';
  $res = preg_replace('/(\w+)\s(\w+)/', '$2, $1', $str);
  echo $res;
?>

Результат выполнения кода:

php'World, Hello'

Пример

Подсчет количества выполненных замен:

php<?php
  $str = 'a1b2c3';
  $count = 0;
  $res = preg_replace('/\d/', 'X', $str, -1, $count);
  echo "Result: $res, Replacements: $count";
?>

Результат выполнения кода:

php'Result: aXbXcX, Replacements: 3'

Смотрите также

  • функцию preg_match,
    которая выполняет поиск по регулярному выражению
  • функцию preg_split,
    которая разбивает строку по регулярному выражению