从html字符串中安全地提取不超过前$ count个字符。

原型

wp_html_excerpt( string $str, int $count, string $more = null )

描述

UTF-8,标签和实体安全前缀提取。里面的实体不会被算作一个字符。例如

参数

$str (string) (Required) 字符串以获取摘录。

$count (int) (Required) 要采取的最大字符数。

$more (string) (Optional)  如果$ str需要修剪,可以追加什么。默认为空字符串。

返回值

(string)  摘录。

源文件

路径:wp-includes/formatting.php

<?php
...
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;
}
...
?>

其他

英文文档:https://developer.wordpress.org/reference/functions/wp_html_excerpt/