post_custom( string $key = '' )

Retrieve post custom meta data field.

Parameters

$key

(string) (Optional) Meta data key name.

Default value: ''

Return

(false|string|array) Array of values or single value, if only one element exists. False will be returned if key does not exist.

Source

File: wp-includes/post-template.php 

function post_custom( $key = '' ) {
	$custom = get_post_custom();

	if ( !isset( $custom[$key] ) )
		return false;
	elseif ( 1 == count($custom[$key]) )
		return $custom[$key][0];
	else
		return $custom[$key];
}

Expand Source Code View on GitHub

Related

Uses

Uses
Uses Description
wp-includes/post.php: get_post_custom()

Retrieve post meta fields, based on post ID.

Changelog

Changelog
Version Description
WP-1.5.0 Introduced.