settype

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

settypeAffecte un type à une variable

Description

settype(mixed &$var, string $type): bool

Force le type de la variable var en type.

Liste de paramètres

var

La variable à convertir.

type

Les valeurs possibles pour le paramètre type sont :

  • "boolean" ou "bool"
  • "integer" ou "int"
  • "float" ou "double"
  • "string"
  • "array"
  • "object"
  • "null"

Valeurs de retour

Cette fonction retourne true en cas de succès ou false si une erreur survient.

Erreurs / Exceptions

Lance une ValueError si la valeur de type n'est pas un type valide, à partir de PHP 8.0.0. Antérieur à PHP 8.0.0, une alerte E_WARNING était émise et false était retourné.

Historique

Version Description
8.0.0 Lance désormais une ValueError lorsqu'un type invalide est passé au paramètre type. Antérieur à cette version, une alerte E_WARNING était émise et la fonction retournait false.

Exemples

Exemple #1 Exemple avec settype()

<?php
$foo
= "5bar"; // chaîne
$bar = true; // booléen

settype($foo, "integer"); // $foo vaut maintenant 5 (integer)
settype($bar, "string"); // $bar vaut maintenant "1" (string)

var_dump($foo, $bar);
?>

Notes

Note:

La valeur maximale des entiers est la valeur contenue dans la variable PHP_INT_MAX.

Voir aussi