array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.settype.php', 1 => 'settype', 2 => 'Define o tipo de uma variável', ), 'up' => array ( 0 => 'ref.var.php', 1 => 'Funções para Manipulação de variáveis', ), 'prev' => array ( 0 => 'function.serialize.php', 1 => 'serialize', ), 'next' => array ( 0 => 'function.strval.php', 1 => 'strval', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', '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 — Define o tipo de uma variável

Descrição

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

Define o tipo da variável var para type.

Parâmetros

var

A variável a ser convertida.

type

Os valores possíveis para type são:

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

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Erros/Exceções

Lança um ValueError se o valor de type não for um tipo válido, a partir do PHP 8.0.0. Antes do PHP 8.0.0, um E_WARNING era emitido e a função retornava false.

Registro de Alterações

Versão Descrição
8.0.0 Agora lança um ValueError quando um tipo inválido é passado ao parâmetro type. Anteriormente, um E_WARNING era emitido e a função retornava false.

Exemplos

Exemplo #1 Exemplo da função settype()

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

settype($foo, "integer"); // $foo é agora 5 (integer)
settype($bar, "string"); // $bar é agora "1" (string)

var_dump($foo, $bar);
?>

Notas

Nota:

O valor máximo para "int" é PHP_INT_MAX.

Veja Também