W3cubDocs

/WordPress

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–2019 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