説明
bool settype(mixed &$var, string $type)
パラメータ
-
var
-
変換する変数。
-
type
-
type の値は以下の命令のいずれかです。
-
"boolean" または "bool"
-
"integer" または "int"
-
"float" または "double"
-
"string"
-
"array"
-
"object"
-
"null"
エラー / 例外
PHP 8.0.0 以降、type の値が
有効な型でない場合、ValueError をスローします。
PHP 8.0.0 より前のバージョンでは、E_WARNING が発生し、
false が返されていました。
var が
型付きプロパティ
へのリファレンスで、現在の
型付けモード
では変換後の値をそのプロパティに代入できない場合、
TypeError をスローします。
例
例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 です。
注意:
変換後の値は var に代入し直されるため、
通常の代入と同じルールが適用されます。
var が型付きプロパティへのリファレンスで、
自動変換モードが有効な場合、変換後の値は
可能であればプロパティの型に変換し直されます。
そのため、プロパティの型は変わらず、settype は
true を返します。
変換し直せない場合は、TypeError がスローされます。