wp_get_post_revision( int|WP_Post $post, string $output = OBJECT, string $filter = 'raw' )

Gets a post revision.

Parameters

$post

(Required) Post ID or post object.

$output

(Optional) The required return type. One of OBJECT, ARRAY_A, or ARRAY_N, which correspond to a WP_Post object, an associative array, or a numeric array, respectively.

Default value: OBJECT

$filter

(Optional) sanitization filter. See sanitize_post(). Default 'raw'.

Default value: 'raw'

Return

(WP_Post|array|null) WP_Post (or array) on success, or null on failure.

Source

File: wp-includes/revision.php

function wp_get_post_revision(&$post, $output = OBJECT, $filter = 'raw') {
	if ( !$revision = get_post( $post, OBJECT, $filter ) )
		return $revision;
	if ( 'revision' !== $revision->post_type )
		return null;

	if ( $output == OBJECT ) {
		return $revision;
	} elseif ( $output == ARRAY_A ) {
		$_revision = get_object_vars($revision);
		return $_revision;
	} elseif ( $output == ARRAY_N ) {
		$_revision = array_values(get_object_vars($revision));
		return $_revision;
	}

	return $revision;
}

Expand Source Code View on GitHub

Uses

Uses
Uses	Description
wp-includes/post.php: get_post()	Retrieves post data given a post ID or post object.

Used By

Used By
Used By	Description
wp-includes/class-wp-xmlrpc-server.php: wp_xmlrpc_server::wp_restoreRevision()	Restores a post revision.
wp-includes/revision.php: wp_is_post_revision()	Determines if the specified post is a revision.
wp-includes/revision.php: wp_is_post_autosave()	Determines if the specified post is an autosave.
wp-includes/revision.php: wp_restore_post_revision()	Restores a post to the specified revision.
wp-includes/revision.php: wp_delete_post_revision()	Deletes a revision.

Changelog

Changelog
Version	Description
2.6.0	Introduced.