array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.chr.php', 1 => 'chr', 2 => 'Gera uma string de um byte a partir de um número', ), 'up' => array ( 0 => 'ref.strings.php', 1 => 'Funções de String', ), 'prev' => array ( 0 => 'function.chop.php', 1 => 'chop', ), 'next' => array ( 0 => 'function.chunk-split.php', 1 => 'chunk_split', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', '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 — Gera uma string de um byte a partir de um número

Descrição

chr(int $codepoint): string

Retorna uma string de um caractere contendo o caractere especificado pela interpretação do parâmetro codepoint como um inteiro sem sinal.

Esta função pode ser usada para criar uma string de um caracteres em uma codificação de 1-byte como ASCII, ISO-8859, ou Windows 1252, passando-se a posição do caractere desejado na tabela de mapeamento da codificação. Entretanto, observe que esta função não tem ciência de codificação de strings e, em particular, não pode receber um valor de ponto de código Unicode para gerar uma string em uma codificação multi-byte como UTF-8 ou UTF-16.

Esta função é complementar à função ord().

Parâmetros

codepoint

Um inteiro entre 0 e 255.

Valores fora do intervalo válido (0..255) sofrerão operação binária AND com o valor 255, o que é equivalente ao algoritmo a seguir:

while ($bytevalue < 0) {
$bytevalue += 256;
}
$bytevalue %= 256;

Valor Retornado

Uma string de um caractere contendo o byte especificado.

Registro de Alterações

Versão Descrição
7.4.0 A função não mais aceita silenciosamente códigos não suportados no parâmetro codepoint, convertendo-os para 0.

Exemplos

Exemplo #1 Exemplo de chr()

<?php
// Assume que a string será usada como codificação ASCII ou compatível

$str = "A string termina com ESC: ";
$str .= chr(27); /* adiciona um caractere ESC ao final de $str */
echo $str, PHP_EOL;

/* Frequentemente isto é mais útil: */
$str = sprintf("A string termina com ESC: %c", 27);
echo $str, PHP_EOL;
?>

Exemplo #2 Comportamento com parâmetro fora dos limites

<?php
echo chr(-159), chr(833), PHP_EOL;
?>

O exemplo acima produzirá:

aA

Exemplo #3 Construindo uma string UTF-8 a partir de bytes individuais

<?php
$str = chr(240) . chr(159) . chr(144) . chr(152);
echo $str, PHP_EOL;
?>

O exemplo acima produzirá:


🐘

Veja Também