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

# intval

(PHP 4, PHP 5, PHP 7)

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

### Description

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

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 suivants 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(42, 8); // 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

- boolval() - Récupère la valeur booléenne d'une variable
- floatval() - Convertit une chaîne en nombre à virgule flottante
- strval() - Récupère la valeur d'une variable, au format chaîne
- settype() - Affecte un type à une variable
- is_numeric() - Détermine si une variable est un type numérique
- Définition du type
- Nombres de grande taille BCMath