array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.chr.php', 1 => 'chr', 2 => 'Генерирует однобайтовую строку из числа', ), 'up' => array ( 0 => 'ref.strings.php', 1 => 'Функции для работы со строками', ), 'prev' => array ( 0 => 'function.chop.php', 1 => 'chop', ), 'next' => array ( 0 => 'function.chunk-split.php', 1 => 'chunk_split', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/strings/functions/chr.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

chr

(PHP 4, PHP 5, PHP 7, PHP 8)

chr — Генерирует однобайтовую строку из числа

Описание

chr(int $codepoint): string

Функция возвращает строку из одного символа, который определяется путём интерпретации кодовой точки codepoint как целого беззнакового числа.

Функцией создают односимвольную строку в однобайтовой кодировке наподобие 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 */
echo $str, PHP_EOL;

/* Часто полезнее такой код */
$str = sprintf("Эта строка заканчивается символом escape: %c", 27);
echo $str, PHP_EOL;

?>

Пример #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, PHP_EOL;

?>

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


🐘

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