settype

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

settype — 変数の型をセットする

説明

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

変数 var の型を type にセットします。

パラメータ

var

変換する変数。

type

type の値は以下の命令のいずれかです。

  • "boolean" または "bool"
  • "integer" または "int"
  • "float" または "double"
  • "string"
  • "array"
  • "object"
  • "null"

戻り値

成功した場合に true を、失敗した場合に false を返します。

エラー / 例外

PHP 8.0.0 以降、type の値が 有効な型でない場合、ValueError をスローします。 PHP 8.0.0 より前のバージョンでは、E_WARNING が発生し、 false が返されていました。

変更履歴

バージョン 説明
8.0.0 無効な型が type に渡された場合、 ValueError をスローするようになりました。 これより前のバージョンでは、E_WARNING が発生し、 関数は false を返していました。

例

例1 settype() の例

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

settype($foo, "integer"); // ここでは、$foo は 5です (整数)
settype($bar, "string"); // ここでは、$bar は "1" です (文字列)

var_dump($foo, $bar);
?>

注意

注意:

"int" の最大値は PHP_INT_MAX です。

参考