WP_Filter_Sentinel{} │ final │ WP 7.1.0

Marker object used as a filter's default value when any user value — including null, false, or arbitrary objects — must remain distinguishable from the "no filter modified this" case.

Each instance is unique by identity. Compare returned values with === against the original sentinel to detect that no filter callback replaced it.

Filter callbacks that want to pass through without modifying the value should return the received value unchanged. Returning a freshly constructed WP_Filter_Sentinel is treated as a replacement, not as pass-through.

No Hooks.

Usage

$WP_Filter_Sentinel = new WP_Filter_Sentinel();
// use class methods

Methods

Changelog

WP_Filter_Sentinel{} WP Filter Sentinel{} code ^{WP 7.1}

final class WP_Filter_Sentinel {}