class WP_Filter_Sentinel {}

In this article

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.

Description

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.

Source

final class WP_Filter_Sentinel {}

Changelog

VersionDescription
7.1.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.