chr

(PHP 4, PHP 5, PHP 7)

chrГенерирует односимвольную строку по заданному числу

Описание

chr ( int $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;
?>

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


🐘

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