_wp_scrub_utf8_fallback() │ WP 6.9.0

Fallback mechanism for replacing invalid spans of UTF-8 bytes.

Example:

'Pi�a' === _wp_scrub_utf8_fallback( "Pi\xF1a" ); // “ñ” is 0xF1 in Windows-1252.

Внутренняя функция — эта функция рассчитана на использование самим ядром. Не рекомендуется использовать эту функцию в своем коде.

Хуков нет.

Возвращает

string. Input string with spans of invalid bytes swapped with the replacement character.

Использование

_wp_scrub_utf8_fallback( $bytes ): string;

$bytes(строка) (обязательный): UTF-8 encoded string which might contain spans of invalid bytes.

Заметки

Смотрите: wp_scrub_utf8()

Список изменений

С версии 6.9.0

Введена.

Код `_wp_scrub_utf8_fallback() wp scrub utf8 fallback` ^{WP 7.1.3}

wp-includes/compat-utf8.php

function _wp_scrub_utf8_fallback( string $bytes ): string {
	$bytes_length   = strlen( $bytes );
	$next_byte_at   = 0;
	$was_at         = 0;
	$invalid_length = 0;
	$scrubbed       = '';

	while ( $next_byte_at <= $bytes_length ) {
		_wp_scan_utf8( $bytes, $next_byte_at, $invalid_length );

		if ( $next_byte_at >= $bytes_length ) {
			if ( 0 === $was_at ) {
				return $bytes;
			}

			return $scrubbed . substr( $bytes, $was_at, $next_byte_at - $was_at - $invalid_length );
		}

		$scrubbed .= substr( $bytes, $was_at, $next_byte_at - $was_at );
		$scrubbed .= "\u{FFFD}";

		$next_byte_at += $invalid_length;
		$was_at        = $next_byte_at;
	}

	return $scrubbed;
}