array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.settype.php', 1 => 'settype', 2 => 'Asigna un tipo a una variable', ), 'up' => array ( 0 => 'ref.var.php', 1 => 'Funciones de manejo de variables', ), 'prev' => array ( 0 => 'function.serialize.php', 1 => 'serialize', ), 'next' => array ( 0 => 'function.strval.php', 1 => 'strval', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/var/functions/settype.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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