update_usermeta( int $user_id, string $meta_key, mixed $meta_value ): bool

2332function update_usermeta( $user_id, $meta_key, $meta_value ) {2333	_deprecated_function( __FUNCTION__, '3.0.0', 'update_user_meta()' );2334	global $wpdb;2335	if ( !is_numeric( $user_id ) )2336		return false;2337	$meta_key = preg_replace('|[^a-z0-9_]|i', '', $meta_key);2338 2339	/** @todo Might need fix because usermeta data is assumed to be already escaped */2340	if ( is_string($meta_value) )2341		$meta_value = stripslashes($meta_value);2342	$meta_value = maybe_serialize($meta_value);2343 2344	if (empty($meta_value)) {2345		return delete_usermeta($user_id, $meta_key);2346	}2347 2348	$cur = $wpdb->get_row( $wpdb->prepare("SELECT * FROM $wpdb->usermeta WHERE user_id = %d AND meta_key = %s", $user_id, $meta_key) );2349 2350	if ( $cur )2351		do_action( 'update_usermeta', $cur->umeta_id, $user_id, $meta_key, $meta_value );2352 2353	if ( !$cur )2354		$wpdb->insert($wpdb->usermeta, compact('user_id', 'meta_key', 'meta_value') );2355	elseif ( $cur->meta_value != $meta_value )2356		$wpdb->update($wpdb->usermeta, compact('meta_value'), compact('user_id', 'meta_key') );2357	else2358		return false;2359 2360	clean_user_cache( $user_id );2361	wp_cache_delete( $user_id, 'user_meta' );2362 2363	if ( !$cur )2364		do_action( 'added_usermeta', $wpdb->insert_id, $user_id, $meta_key, $meta_value );2365	else2366		do_action( 'updated_usermeta', $cur->umeta_id, $user_id, $meta_key, $meta_value );2367 2368	return true;2369}