WP_REST_Meta_Fields::is_meta_value_same_as_stored_value( string $meta_key, string $subtype, mixed $stored_value, mixed $user_value )
Checks if the user provided value is equivalent to a stored value for the given meta key.
Parameters
- $meta_key
-
(string) (Required) The meta key being checked.
- $subtype
-
(string) (Required) The object subtype.
- $stored_value
-
(mixed) (Required) The currently stored value retrieved from get_metadata().
- $user_value
-
(mixed) (Required) The value provided by the user.
Return
(bool)
Source
File: wp-includes/rest-api/fields/class-wp-rest-meta-fields.php
protected function is_meta_value_same_as_stored_value( $meta_key, $subtype, $stored_value, $user_value ) { $args = $this->get_registered_fields()[ $meta_key ]; $sanitized = sanitize_meta( $meta_key, $user_value, $this->get_meta_type(), $subtype ); if ( in_array( $args['type'], array( 'string', 'number', 'integer', 'boolean' ), true ) ) { // The return value of get_metadata will always be a string for scalar types. $sanitized = (string) $sanitized; } return $sanitized === $stored_value; }
Changelog
Version | Description |
---|---|
5.5.0 | Introduced. |
© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/classes/wp_rest_meta_fields/is_meta_value_same_as_stored_value