ord
(PHP 4, PHP 5, PHP 7, PHP 8)
ord — Konvertiert das erste Byte einer Zeichenkette in einen Wert zwischen 0 und 255
Beschreibung
$character
): int
Interpretiert den ASCII-Wert des ersten Bytes von
character
als vorzeichenlose Ganzzahl zwischen 0 und
255.
Liegt die Zeichenkette in einer Ein-Byte-Kodierung, wie ASCII, ISO-8859 oder Windows 1252, vor, ist dies gleichwertig zur Rückgabe der Position des Zeichens in der Zuordnungstabelle des Zeichensatzes. Allerdings ist zu beachten, dass diese Funktion keine Zeichenkettenkodierung kennt, und insbesondere niemals einen Unicode-Codepoint in einer Multibyte-Kodierung wie UTF-8 oder UTF-16 erkennt.
Die Funktion ist das Gegenstück zu chr().
Parameter-Liste
-
character
-
Ein Zeichen.
Rückgabewerte
Ein Integer zwischen 0 und 255.
Beispiele
Beispiel #1 ord()-Beispiel
<?php
$str = "\n";
if (ord($str) == 10) {
echo "Das erste Zeichen von \$str ist ein Zeilenvorschub.\n";
}
?>
Beispiel #2 Untersuchen der einzelnen Bytes einer UTF-8-Zeichenkette
<?php
declare(encoding='UTF-8');
$str = "🐘";
for ( $pos=0; $pos < strlen($str); $pos ++ ) {
$byte = substr($str, $pos);
echo 'Byte ' . $pos . ' von $str hat den Wert ' . ord($byte) . PHP_EOL;
}
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
Byte 0 von $str hat den Wert 240
Byte 1 von $str hat den Wert 159
Byte 2 von $str hat den Wert 144
Byte 3 von $str hat den Wert 152
Siehe auch
- chr() - Erzeugt eine Ein-Byte-Zeichenkette aus einer Zahl
- Eine » ASCII-Tabelle
- mb_ord() - Get Unicode code point of character
- IntlChar::ord() - Return Unicode code point value of character