wpseek.com
WordPress开发者和主题制作者的搜索引擎

wp_html_excerpt › WordPress Function

Since2.5.0

已弃用n/a

› wp_html_excerpt ( $str, $count, $more = null )

参数: (3)	(string) $str String to get the excerpt from. Required: Yes (int) $count Maximum number of characters to take. Required: Yes (string) $more Optional. What to append if $str needs to be trimmed. Defaults to empty string. Required: No 默认: null
返回:	(string) The excerpt.
定义在:	wp-includes/formatting.php , line 5537
文档:	developer.wordpress.org / wp_html_excerpt

Safely extracts not more than the first $count characters from HTML string.

UTF-8, tags and entities safe prefix extraction. Entities inside will NOT be counted as one character. For example & will be counted as 4, < as 3, etc.

源码

function wp_html_excerpt( $str, $count, $more = null ) {
	if ( null === $more ) {
		$more = '';
	}

	$str     = wp_strip_all_tags( $str, true );
	$excerpt = mb_substr( $str, 0, $count );

	// Remove part of an entity at the end.
	$excerpt = preg_replace( '/&[^;\s]{0,6}$/', '', $excerpt );

	if ( $str !== $excerpt ) {
		$excerpt = trim( $excerpt ) . $more;
	}

	return $excerpt;
}