(PHP 4, PHP 5, PHP 7)
chr — Генерирует односимвольную строку по заданному числу
$bytevalue
) : string
Возвращает строку из одного символа, код которого задан аргументом
bytevalue, который интерпретируется как
беззнаковое целое (unsigned integer).
Может использоваться для создания строки из одного символа однобайтовой кодировки, например, такой как ASCII, ISO-8859 или Windows 1252, путем указания позиции этого символа в таблице кодировки. Данная функция не подходит для генерации односимвольной строки в многобайтовых кодировках, таких как UTF-8 или UTF-16.
Эта функция дополняет функцию ord().
bytevalueЦелое число от 0 до 255.
Значения за пределом диапазона (0..255) должны быть побитово сложены (побитовое И) с 255, что соответствует такому алгоритму:
while ($bytevalue < 0) {
$bytevalue += 256;
}
$bytevalue %= 256;
Строка из одного символа, содержащая заданный байт.
Пример #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
declare(encoding='UTF-8');
$str = chr(240) . chr(159) . chr(144) . chr(152);
echo $str;
?>
Результат выполнения данного примера: