wp_add_trashed_suffix_to_post_name_for_post() WordPress Function

function wp_add_trashed_suffix_to_post_name_for_post( $post ) {
	global $wpdb;

	$post = get_post( $post );

	if ( '__trashed' === substr( $post->post_name, -9 ) ) {
		return $post->post_name;
	}
	add_post_meta( $post->ID, '_wp_desired_post_slug', $post->post_name );
	$post_name = _truncate_post_slug( $post->post_name, 191 ) . '__trashed';
	$wpdb->update( $wpdb->posts, array( 'post_name' => $post_name ), array( 'ID' => $post->ID ) );
	clean_post_cache( $post->ID );
	return $post_name;
}
Uses	Description
wp-includes/post.php:clean_post_cache()	Will clean the post in the cache.
wp-includes/post.php:_truncate_post_slug()	Truncate a post slug.
wp-includes/post.php:add_post_meta()	Adds a meta field to the given post.
wp-includes/post.php:get_post()	Retrieves post data given a post ID or post object.
wp-includes/wp-db.php:wpdb::update()	Updates a row in the table.
Used By	Description
wp-includes/post.php:wp_add_trashed_suffix_to_post_name_for_trashed_posts()	Adds a suffix if any trashed posts have a given slug.
wp-includes/post.php:wp_insert_post()	Insert or update a post.