settype

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

settype — Asigna un tipo a una variable

Descripción

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

Fuerza el tipo de la variable var a type.

Parámetros

var

La variable a convertir.

type

Los valores posibles para el argumento type son:

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

Valores devueltos

Esta función retorna true en caso de éxito o false si ocurre un error.

Errores/Excepciones

Lanza una excepción ValueError si el valor de type no es un tipo válido, a partir de PHP 8.0.0. Antes de PHP 8.0.0, se emitía un E_WARNING y se devolvía false.

Historial de cambios

Versión Descripción
8.0.0 Ahora lanza una excepción ValueError cuando se pasa un tipo no válido a type. Anteriormente, se emitía un E_WARNING y la función devolvía false.

Ejemplos

Ejemplo #1 Ejemplo con settype()

<?php
$foo = "5bar"; // string
$bar = true; // bool

settype($foo, "integer"); // $foo vale ahora 5 (integer)
settype($bar, "string"); // $bar vale ahora "1" (string)

var_dump($foo, $bar);
?>

Notas

Nota:

El valor máximo de los enteros es el valor contenido en la variable PHP_INT_MAX.

Ver también