chr
(PHP 4, PHP 5, PHP 7)
chr — Генерирует односимвольную строку по заданному числу
Описание
$codepoint
) : string
Возвращает строку из одного символа, код которого задан аргументом
codepoint, который интерпретируется как
беззнаковое целое (unsigned integer).
Может использоваться для создания строки из одного символа однобайтовой кодировки, например, такой как ASCII, ISO-8859 или Windows 1252, путем указания позиции этого символа в таблице кодировки. Данная функция не подходит для генерации односимвольной строки в многобайтовых кодировках, таких как UTF-8 или UTF-16.
Эта функция дополняет функцию ord().
Список параметров
-
codepoint -
Целое число от 0 до 255.
Значения за пределом диапазона (0..255) должны быть побитово сложены (побитовое И) с 255, что соответствует такому алгоритму:
while ($bytevalue < 0) {
$bytevalue += 256;
}
$bytevalue %= 256;
Возвращаемые значения
Строка из одного символа, содержащая заданный байт.
Список изменений
| Версия | Описание |
|---|---|
| 7.4.0 |
Функция больше не принимает неподдерживаемые значения codepoint
и преобразует их в 0.
|
Примеры
Пример #1 Пример использования chr()
<?php
// Предполагается, что строка будет использовака как ASCII или ASCII-совместимая
$str = "Эта строка заканчивается на escape: ";
$str .= chr(27); /* добавляет символ escape в конец $str */
/* Но обычно лучше использовать такую конструкцию */
$str = sprintf("Эта строка заканчивается на escape: %c", 27);
?>
Пример #2 Поведение при переполнении
<?php
echo chr(-159), chr(833), PHP_EOL;
?>
Результат выполнения данного примера:
aA
Пример #3 Создание строки UTF-8 из индивидуальных байтов
<?php
$str = chr(240) . chr(159) . chr(144) . chr(152);
echo $str;
?>
Результат выполнения данного примера:
🐘