
Khối chức năng PREG_FILTER tìm kiếm và thay thế bằng biểu thức chính quy.
Lưu ý: Chức năng này là Binary-Safe. Điều này có nghĩa là các ký tự UTF8 không thể được xử lý trực tiếp.
Ngoài việc khối chức năng PREG_FILTER chỉ trả về chuỗi ký tự (có thể đã chuyển đổi) khi có sự tương ứng, nó giống hệt với khối chức năng PREG_REPLACE.
Biểu thức dưới dạng chuỗi ký tự mà tìm kiếm. Có một số bộ chỉnh sửa PCRE có sẵn.
Chuỗi ký tự để thay thế. Nó có thể chứa các tham chiếu dưới dạng \n hoặc $n, trong đó sau này được ưu tiên. Mỗi tham chiếu này sẽ được thay thế bằng văn bản mà mẫu tìm kiếm thứ n đã bắt được. n có thể có giá trị từ 0 đến 99. \0 hoặc $0 tham chiếu đến văn bản mà mẫu tìm kiếm hoàn chỉnh khớp. Để lấy số của mẫu tìm kiếm con bắt được, các dấu ngoặc mở được đếm từ trái sang phải bắt đầu từ 1. Để sử dụng một dấu gạch chéo ngược trong thay thế, nó phải được nhân đôi "\\".
Nếu bạn muốn làm việc với một thay thế trong đó một số khác tiếp theo ngay sau tham chiếu (điều này có nghĩa là ngay sau khi khớp với mẫu tìm kiếm, một số sẽ đến), bạn không thể sử dụng cách viết \1 cho tham chiếu của mình. Ví dụ, \11 sẽ làm nhầm lẫn chức năng vì nó không biết bạn muốn tham chiếu \1 theo sau bởi số 1 hoặc chỉ tham chiếu \11. Trong trường hợp này, giải pháp là sử dụng ${1}1. Điều này tạo ra một tham chiếu riêng biệt $1 và số 1 vẫn là ký tự.
Nếu bạn sử dụng bộ chỉnh sửa cũ e, chức năng này sẽ che khuất một vài ký tự (đặc biệt là ', ", \ và NULL) trong các chuỗi ký tự mà tham chiếu sẽ thay thế. Điều này được thực hiện để đảm bảo không có lỗi cú pháp khi sử dụng tham chiếu chứa dấu ngoặc đơn hoặc kép. Hãy chắc chắn rằng bạn biết về cú pháp chuỗi ký tự để biết chính xác chuỗi ký tự được đánh giá như thế nào.
Đầu vào định nghĩa chuỗi ký tự để tìm kiếm.
Số lượng thay thế tối đa cho mỗi mẫu tìm kiếm trong mỗi subject. Giá trị mặc định: -1 hoặc NULL (không giới hạn).
Nếu tìm thấy sự khớp (có thể đã chuyển đổi), chuỗi ký tự mới Q sẽ được trả về, nếu không, SUBJECT sẽ được trả về không thay đổi hoặc NULL, nếu xảy ra lỗi.
Đầu ra trả về số lượng thay thế đã thực hiện.