Функция ENT2NCR() в WordPress: описание, использование, примеры

# Функция ENT2NCR() в WordPress

Функция ENT2NCR() используется в WordPress для преобразования именованных сущностей (например, ’) в численные сущности (например, ’).

- **Время выполнения:** 1 раз — 0.000001 сек (очень быстро) | 50000 раз — 0.53 сек (также быстро)
- **Версия PHP:** 7.2.5, **Версия WordPress:** 4.9.8

## Хуки функции

- pre_ent2ncr: Хук, который применяется перед преобразованием сущностей.

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

Строка. Это текст с преобразованными сущностями.

## Использование функции

Чтобы использовать функцию, вы можете вызвать её следующим образом:

```php
ent2ncr( $text );

Параметры

• $text (строка, обязательный) — текст, в котором будут преобразованы сущности.

Примеры использования

Простой пример

echo ent2ncr( "C’est la fête!" );
// Вывод: C’est la fête!

На экране мы получим следующее:
C'est la fête!

Вы можете добавить собственные примеры ниже.

Журнал изменений

С версии 1.5.1

Функция была введена в этой версии.

Код функции ENT2NCR()

function ent2ncr( $text ) {
    /**
     * Фильтрует текст перед преобразованием именованных сущностей в численные.
     *
     * Строка не должна быть null, чтобы фильтр был применён.
     *
     * @since 3.3.0
     *
     * @param string|null $converted_text Текст для преобразования. По умолчанию null.
     * @param string      $text          Текст до преобразования сущностей.
     */
    $filtered = apply_filters( 'pre_ent2ncr', null, $text );
    if ( null !== $filtered ) {
        return $filtered;
    }

    $to_ncr = array(
        '"'     => '"',
        '&'      => '&',
        '<'       => '<',
        '>'       => '>',
        // Другие сущности ...
        '’'    => '’',
        '“'    => '“',
        // ...
    );

    return str_replace( array_keys( $to_ncr ), array_values( $to_ncr ), $text );
}

Похожие функции

Если вы хотите ознакомиться с другими функциями форматирования в WordPress, вот некоторые из них:

• absint()
• add_magic_quotes()
• antispambot()
• backslashit()
• wptexturize()

Эти функции могут вам помочь в разных аспектах работы с текстом в WordPress.