描述
如果给$tag参数传递给一个对象(假定该对象是从数据库检索到的标签行对象),它将被缓存。
如果给$tag传递一个整数的标签ID,则将从数据库中检索该标签(如果尚未缓存)并传回。
查看get_term()可以发现,这两个函数都将通过几个过滤器,最后根据$filter参数值进行净化。
参数
- $tag
-
(int|WP_Term|object) (必填) 标签ID或对象。
- $output
-
(string) (可选) 所需的返回类型。OBJECT、ARRAY_A或ARRAY_N中的一个,分别对应于WP_Term对象、关联数组或数字数组。
默认值: OBJECT
- $filter
-
(string) (可选) 如何净化标签字段。
默认值: 'raw'
返回
(WP_Term|array|WP_Error|null) 标签数据的类型由$output参数定义。如果$tag为空,返回WP_Error,如果它不存在,则为null。
源码
更新日志
版本 | 描述 |
---|---|
2.3.0 | 开始引入 |