get_tag( int|WP_Term|object $tag, string $output = OBJECT, string $filter = ‘raw’ )

通过标记ID或标记对象检索post标记。
Retrieve post tag by tag ID or tag object.

目录锚点：#说明#参数#返回#源码

说明（Description）

如果向$tag参数传递一个对象，则假定该对象是检索数据库的标记行对象。它将缓存标记数据。

如果将标记ID的整数传递给$tag，则将从数据库中检索该标记（如果尚未缓存），并将其传回。

如果查看get_term（），那么这两种类型都将通过几个过滤器，最后根据$filter参数值进行清理。

参数（Parameters）

返回（Return）

（WP|Term|array|WP_Error|null）由$output参数定义的类型中的标记数据。WP_Error如果$tag为空，如果不存在则为空。

源码（Source）

/**
 * Retrieve post tag by tag ID or tag object.
 *
 * If you pass the $tag parameter an object, which is assumed to be the tag row
 * object retrieved the database. It will cache the tag data.
 *
 * If you pass $tag an integer of the tag ID, then that tag will
 * be retrieved from the database, if it isn't already cached, and pass it back.
 *
 * If you look at get_term(), then both types will be passed through several
 * filters and finally sanitized based on the $filter parameter value.
 *
 * @since 2.3.0
 *
 * @param int|object $tag
 * @param string $output Optional. Constant OBJECT, ARRAY_A, or ARRAY_N
 * @param string $filter Optional. Default is raw or no WordPress defined filter will applied.
 * @return object|array|WP_Error|null Tag data in type defined by $output parameter. WP_Error if $tag is empty, null if it does not exist.
 */
function get_tag( $tag, $output = OBJECT, $filter = 'raw' ) {
	return get_term( $tag, 'post_tag', $output, $filter );
}

/* Cache */