Fonctions de gestion des variables
PHP Manual

intval

(PHP 4, PHP 5)

intval Retourne la valeur numérique entière équivalente d'une variable

Description

int intval ( mixed $var [, int $base = 10 ] )

intval() retourne la valeur numérique entière (entier) de la variable var, en convertissant la valeur dans la base spécifiée (par défaut en base 10). intval() ne doit pas être utilisée sur des objets ; si c'est le cas, une erreur de niveau E_NOTICE sera émise et la fonction retournera 1.

Liste de paramètres

var

La valeur scalaire à être convertie en entier

base

La base pour la conversion

Note:

Si la paramètre base vaut 0, la base utilisée est déterminée par le format du paramètre var :

  • si la chaîne inclue un préfixe "0x" (ou "0X"), la base prise sera 16 (hex) ; sinon,
  • si la chaîne commence par "0", la base prise sera 8 (octal); sinon,
  • la base prise sera 10 (décimal).

Valeurs de retour

Une valeur de type entier de var en cas de succès ou 0 en cas d'échec. Les tableaux vides retournent 0, les tableaux non vides retournent 1.

La valeur maximale dépend du système. Les systèmes à 32 bits ont une valeur entière signée maximale de -2147483648 à 2147483647. Alors, par exemple, sur un système semblable, intval('1000000000000') retournera 2147483647. La valeur entière signée maximale pour un système à 64 bits est 9223372036854775807.

Les chaînes de caractères retournent la plupart du temps 0, cela dépend des caractères à l'extrême gauche de la chaîne. La règle courante du transtypage d'entier s'applique.

Exemples

Exemple #1 Exemples avec intval()

Les exemples suivant sont basés sur un système à 32 bits.

<?php
echo intval(42);                      // 42
echo intval(4.2);                     // 4
echo intval('42');                    // 42
echo intval('+42');                   // 42
echo intval('-42');                   // -42
echo intval(042);                     // 34
echo intval('042');                   // 42
echo intval(1e10);                    // 1410065408
echo intval('1e10');                  // 1
echo intval(0x1A);                    // 26
echo intval(42000000);                // 42000000
echo intval(420000000000000000000);   // 0
echo intval('420000000000000000000'); // 2147483647
echo intval(428);                   // 42
echo intval('42'8);                 // 34
echo intval(array());                 // 0
echo intval(array('foo''bar'));     // 1
?>

Notes

Note:

Le paramètre base n'a aucun effet à moins que le paramètre var soit une chaîne de caractères.

Historique

Version Description
5.1.0 Lance une alerte de type E_NOTICE et retourne 1 lorsqu'un objet est passé au paramètre var.

Voir aussi


Fonctions de gestion des variables
PHP Manual