array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.chr.php', 1 => 'chr', 2 => 'Erzeugt eine Ein-Byte-Zeichenkette aus einer Zahl', ), 'up' => array ( 0 => 'ref.strings.php', 1 => 'String-Funktionen', ), 'prev' => array ( 0 => 'function.chop.php', 1 => 'chop', ), 'next' => array ( 0 => 'function.chunk-split.php', 1 => 'chunk_split', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', '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 — Erzeugt eine Ein-Byte-Zeichenkette aus einer Zahl

Beschreibung

chr(int $codepoint): string

Gibt eine einstellige Zeichenkette zurück, die das angegebene Zeichen enthält, wobei codepoint als vorzeichenlose Ganzzahl interpretiert wird.

Diese Funktion kann verwendet werden, um eine einstellige Zeichenkette in einer Ein-Byte-Kodierung wie ASCII, ISO-8859 oder Windows 1252 zu erzeugen, indem die Position des gewünschten Zeichens in der Zuordnungstabelle der Kodierung übergeben wird. Allerdings ist zu beachten, dass diese Funktion keine Zeichenkettenkodierung kennt, und insbesondere kein Unicode-Codepoint übergeben werden kann, um eine Zeichenkette in einer Multibyte-Kodierung wie UTF-8 oder UTF-16 zu erzeugen.

Die Funktion ist das Gegenstück zu ord().

Parameter-Liste

codepoint

Ein Integer zwischen 0 und 255.

Werte außerhalb des gültigen Bereichs (0..255) werden bitweise mit 255 und-verknüpft, was gleichwertig zu folgendem Algorithmus ist:

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

Rückgabewerte

Eine einstellige Zeichenkette, die das angegebene Byte enthält.

Changelog

Version Beschreibung
7.4.0 Die Funktion akzeptiert nicht unterstütze codepoints nicht mehr stillschweigend und setzt diese auf 0.

Beispiele

Beispiel #1 chr()-Beispiel

<?php
// Es wird angenommen, dass die Zeichenkette als ASCII oder ASCII-kompatible
// Kodierung verwendet wird

$str = "Diese Zeichenkette endet mit einem Escape-Zeichen: ";
$str .= chr(27); /* fügt das Escape-Zeichen an das Ende von $str an */
echo $str, PHP_EOL;

/* Die häufig praktischere Lösung: */
$str = sprintf("Diese Zeichenkette endet mit einem Escape-Zeichen: %c", 27);
echo $str, PHP_EOL;
?>

Beispiel #2 Überlauf-Verhalten

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

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

aA

Beispiel #3 Erstellen einer UTF-8-Zeichenkette aus einzelnen Bytes

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

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:


🐘

Siehe auch