delete_usermeta( int $user_id, string $meta_key, mixed $meta_value = '' ): bool

2229function delete_usermeta( $user_id, $meta_key, $meta_value = '' ) {2230	_deprecated_function( __FUNCTION__, '3.0.0', 'delete_user_meta()' );2231	global $wpdb;2232	if ( !is_numeric( $user_id ) )2233		return false;2234	$meta_key = preg_replace('|[^a-z0-9_]|i', '', $meta_key);2235 2236	if ( is_array($meta_value) || is_object($meta_value) )2237		$meta_value = serialize($meta_value);2238	$meta_value = trim( $meta_value );2239 2240	$cur = $wpdb->get_row( $wpdb->prepare("SELECT * FROM $wpdb->usermeta WHERE user_id = %d AND meta_key = %s", $user_id, $meta_key) );2241 2242	if ( $cur && $cur->umeta_id )2243		do_action( 'delete_usermeta', $cur->umeta_id, $user_id, $meta_key, $meta_value );2244 2245	if ( ! empty($meta_value) )2246		$wpdb->query( $wpdb->prepare("DELETE FROM $wpdb->usermeta WHERE user_id = %d AND meta_key = %s AND meta_value = %s", $user_id, $meta_key, $meta_value) );2247	else2248		$wpdb->query( $wpdb->prepare("DELETE FROM $wpdb->usermeta WHERE user_id = %d AND meta_key = %s", $user_id, $meta_key) );2249 2250	clean_user_cache( $user_id );2251	wp_cache_delete( $user_id, 'user_meta' );2252 2253	if ( $cur && $cur->umeta_id )2254		do_action( 'deleted_usermeta', $cur->umeta_id, $user_id, $meta_key, $meta_value );2255 2256	return true;2257}