PHP Manual»Fonctions sur les chaînes de caractères»ord

ord

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

ord — Convertit le premier octet d'une chaîne en une valeur entre 0 et 255

Description

function ord(string $character): int

Interprète la valeur binaire du premier octet de character en tant qu'un int non signé entre 0 et 255.

Si la string est dans un encodage sur un octet tel que ASCII, ISO-8859, ou Windows 1252, ceci est équivalent à retourner la position d'un caractère dans la table de correspondance de l'encodage. Cependant, il est à noter que cette fonction n'est pas conscient d'aucun encodage de string, et en particulier n'identifiera jamais une valeur de point de code Unicode dans un encodage multioctet tel que UTF-8 ou UTF-16.

Cette fonction complète chr().

Liste de paramètres

character: Un caractère.

Valeurs de retour

Un int entre 0 et 255.

Historique

Version	Description
8.5.0	Passer une chaîne qui n'est pas un seul octet a été rendu obsolète.

Exemples

Exemple #1 Exemple avec ord()

<?php
$str = "\n";
if (ord($str) == 10) {
  echo "Le premier caractère de \$str est une nouvelle ligne\n";
}
?>

Exemple #2 Examiner les octets individuels d'une chaîne UTF-8

<?php
$str = "🐘";
for ( $pos=0; $pos < strlen($str); $pos ++ ) {
 $byte = substr($str, $pos);
 echo 'Octet ' . $pos . ' de $str a comme valeur ' . ord($byte) . PHP_EOL;
}
?>

L'exemple ci-dessus va afficher :

Octet 0 de $str a comme valeur 240
Octet 1 de $str a comme valeur 159
Octet 2 de $str a comme valeur 144
Octet 3 de $str a comme valeur 152

Voir aussi

chr() - Générer une chaîne d'un octet à partir d'un nombre
» Table ASCII
mb_ord() - Récupère le point de code Unicode d'un caractère
IntlChar::ord() - Renvoie la valeur du point de code Unicode d'un caractère