Метод toUnicodeString класса ByteString

Метод toUnicodeString класса ByteString преобразует текущий объект бинарной строки в объект класса UnicodeString. Метод не принимает параметров и возвращает новый экземпляр UnicodeString, содержащий те же байты, но интерпретируемые как текст в кодировке UTF-8. Если исходные данные не являются валидной UTF-8 строкой, может быть выброшено исключение или произведена замена некорректных последовательностей в зависимости от настроек.

Синтаксис

public function toUnicodeString(): UnicodeString

Пример

Давайте создадим объект ByteString из бинарных данных и преобразуем его в UnicodeString, а затем выведем результат:

<?php
	namespace App\Controller;
	
	use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
	use Symfony\Component\HttpFoundation\Response;
	use Symfony\Component\Uid\ByteString;
	use Symfony\Component\Uid\UnicodeString;
	
	class ArticleController extends AbstractController
	{
		public function index(): Response
		{
			$bytes = new ByteString('abcde');
			$unicode = $bytes->toUnicodeString();
			
			return new Response($unicode->toString());
		}
	}
?>

Результат выполнения кода:

"abcde"

Пример

Давайте преобразуем бинарную строку, содержащую символы в кодировке UTF-8, и проверим длину полученной Unicode-строки:

<?php
	namespace App\Controller;
	
	use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
	use Symfony\Component\HttpFoundation\Response;
	use Symfony\Component\Uid\ByteString;
	
	class ArticleController extends AbstractController
	{
		public function index(): Response
		{
			$bytes = new ByteString('hello');
			$unicode = $bytes->toUnicodeString();
			
			return new Response((string) $unicode->length());
		}
	}
?>

Результат выполнения кода:

"5"

Смотрите также

класс UnicodeString,
который представляет Unicode-строку
метод toString,
который возвращает строковое представление ByteString
метод fromRandom,
который создаёт ByteString из случайных байтов
класс ByteString,
который представляет бинарную строку