WP_HTML_EXCERPT(): безопасное извлечение текста из HTML-строк

# WP_HTML_EXCERPT()

Функция WP_HTML_EXCERPT() позволяет безопасно извлекать не более первых $count символов из HTML-строки.

## Что это такое?

Эта функция обрабатывает строки в кодировке UTF-8 и безопасно извлекает префикс. Также она учитывает HTML-теги и сущности. Например, символ & будет считаться как 4 символа, а < — как 3.

### Как это работает?

Функция использует wp_strip_all_tags(), чтобы удалить все HTML-теги из строки. 

Вот краткое время выполнения:
- 1 раз — 0.0000191 сек (очень быстро)
- 50000 раз — 0.10 сек (почти мгновенно)

> **Примечание:** Эта функция не имеет хуков.

## Возвращаемое значение

Функция возвращает строку — отрывок с текстом.

## Как использовать?

Пример использования функции:

```php
wp_html_excerpt( $str, $count, $more );

Параметры:

• $str (string) (обязательный) — строка, из которой нужно извлекать отрывок.
• $count (int) (обязательный) — максимальное количество символов для извлечения.
• $more (string) — что добавить, если текст нужно обрезать. По умолчанию: пустая строка.

Изменения в функции

Эта функция была представлена в версии 2.5.0.

Пример кода функции

Вот как выглядит код функции wp_html_excerpt():

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 );

// Удаляем часть сущности в конце.
$excerpt = preg_replace( '/&[^;s]{0,6}$/', '', $excerpt );

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

return $excerpt;

}

Связанные функции

Функция wp_html_excerpt() часто используется вместе с другими вспомогательными функциями в WordPress. Вот некоторые из них:

• array_is_list()
• array_key_first()
• array_key_last()
• wp_die()
• wp_redirect()

Вы можете использовать эти функции для выполнения различных задач в WordPress. Они помогут вам эффективно управлять массивами, обрабатывать данные и многое другое.

Заключение

Функция WP_HTML_EXCERPT() — это полезный инструмент для извлечения отрывков текста из HTML-строк. Она проста в использовании и помогает избежать проблем с HTML-тегами. Теперь вы можете безопасно получать короткие версии ваших текстов!