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