Fungsi preg_filter

Fungsi preg_filter melakukan pencarian dan penggantian dalam string atau array string dengan ekspresi reguler. Berbeda dengan preg_replace, fungsi ini hanya mengembalikan elemen-elemen yang ditemukan kecocokan. Parameter pertama menerima ekspresi reguler, parameter kedua - string pengganti, parameter ketiga - string atau array yang akan diproses. Pada parameter keempat yang opsional, dapat ditetapkan jumlah maksimum penggantian di setiap elemen (secara default -1, yang berarti "tanpa batas"). Pada parameter kelima yang opsional, ditentukan variabel yang akan mencatat jumlah penggantian yang dilakukan.

Sintaksis

phppreg_filter(pattern, replacement, subject, [limit = -1], [count]);

Contoh

Mari ganti semua digit dalam string dengan karakter 'X':

php<?php
  $res = preg_filter('/\d/', 'X', 'a1b2c3');
  var_dump($res);
?>

Hasil eksekusi kode:

php'aXbXcX'

Contoh

Mari proses array string, mengganti digit dengan '#':

php<?php
  $res = preg_filter('/\d/', '#', ['a1', 'b2', 'c', 'd4']);
  var_dump($res);
?>

Hasil eksekusi kode:

php['a#', 'b#', 'd#']

Contoh

Mari demonstrasikan perbedaan dengan preg_replace:

php<?php
  $input = ['a1', 'b2', 'c', 'd4'];
  $res_filter = preg_filter('/\d/', '#', $input);
  $res_replace = preg_replace('/\d/', '#', $input);
  echo "Filter result: ";
  var_dump($res_filter);
  echo "Replace result: ";
  var_dump($res_replace);
?>

Hasil eksekusi kode:

phpFilter result: ['a#', 'b#', 'd#']
Replace result: ['a#', 'b#', 'c', 'd#']

Lihat juga

  • fungsi preg_replace,
    yang melakukan penggantian dengan ekspresi reguler
  • fungsi preg_match,
    yang memeriksa kecocokan dengan ekspresi reguler