常用函数-get_post_meta()

说明

该函数返回指定文章中含有指定关键字自定义字段的值。参见 update_post_meta(), delete_post_meta() 和 add_post_meta() 。

用法

<?php $meta_values = get_post_meta($post_id, $key, $single); ?> 

示例

缺省用法

<?php $key_1_values = get_post_meta(76, 'key_1'); ?>  

其他示例

仅检索给定关键字的第一个值：

<?php $key_1_value = get_post_meta(76, 'key_1', true); ?>  

更详细的示例参见 post_meta 函数示例页面。

参数

$post_id

（整数）（必需）希望从中得到数据的文章的编号。用$post->ID获取文章编号。

默认值：None

$key

（字符）（必需）字符，字符中含有希望的meta值的名称。

默认值：None

$single

（布尔值）（可选）如果默认值设为true，函数返回单个字符形式的结果。如果为false或为设置，则函数返回自定义字段的数组。

默认值：false

返回的值

• 若$single设为false或空，函数返回一个包含指定关键字的所有值的数组
• 若$single设为true，函数返回指定关键字的第一个值（不是数组）

无论$single值是什么，如果没有指定关键字，函数将返回空的字符。

相关资源

add_post_meta(), delete_post_meta(), update_post_meta(), get_post_custom(), get_post_custom_values(), get_post_custom_keys()

分类：中文手册