get_metadata() WP 1.0
Retrieve metadata for the specified object.
If the meta field exists, a single value is returned if $single is true, or an array of values if it's false.
If the meta field does not exist, the result depends on get_metadata_default(). By default, an empty string is returned if $single is true, or an empty array if it's false.
1 time = 0.00013s = fast | 50000 times = 1.0s = very fast
No Hooks.
Return
Mixed. Single metadata value, or array of values. False if there's a problem with the parameters passed to the function.
Usage
get_metadata( $meta_type, $object_id, $meta_key, $single );
- $meta_type(string) (required)
- Type of object metadata is for. Accepts 'post', 'comment', 'term', 'user', or any other object type with an associated meta table.
- $object_id(int) (required)
- ID of the object metadata is for.
- $meta_key(string)
- Metadata key. If not specified, retrieve all metadata for the specified object.
Default: '' - $single(true/false)
- If true, return only the first value of the specified meta_key. This parameter has no effect if meta_key is not specified.
Default: false
Notes
- See: get_metadata_raw()
- See: get_metadata_default()
Changelog
Since 2.9.0 | Introduced. |
Code of get_metadata() get metadata WP 5.6
function get_metadata( $meta_type, $object_id, $meta_key = '', $single = false ) {
$value = get_metadata_raw( $meta_type, $object_id, $meta_key, $single );
if ( ! is_null( $value ) ) {
return $value;
}
return get_metadata_default( $meta_type, $object_id, $meta_key, $single );
}Related Functions
From tag: Metadatas (any)
- add_comment_meta()
- add_metadata()
- add_post_meta()
- add_term_meta()
- add_user_meta()
- delete_comment_meta()
- delete_metadata()
- delete_post_meta()
- delete_term_meta()
- delete_user_meta()
- get_comment_meta()