PHP Typumwandlung: String in Int, intval() und (int)

Um einen Wert in einen anderen Typ umzuwandeln, schreibst du den Typ in Klammern davor: (int) "42" ergibt die Ganzzahl 42. Die Funktionsform intval("42") macht dasselbe. Ein Cast schlägt nie fehl: Text, der keine Zahl ist, wird zu 0, und ein String, der mit Ziffern beginnt, behält nur diese Ziffern.

<?php
$input = "42";

var_dump((int) $input);
var_dump(intval($input));
var_dump((int) "12abc");   // leading digits only
var_dump((int) "abc");     // not a number at all
var_dump((float) "3.14");
var_dump((string) 99);
var_dump((bool) "0");

PHP kennt die Casts (int), (float), (string), (bool), (array) und (object). Zu jedem gibt es auch eine Funktion: intval(), floatval(), strval(), boolval().

String in Int: was (int) und intval() liefern

PHP liest Ziffern vom Anfang des Strings, nachdem führender Leerraum übersprungen wurde, und hört beim ersten Zeichen auf, das nicht zu einer Zahl passt. Exponentenschreibweise zählt als Zahl, ein Präfix 0x nicht.

<?php
$samples = ["42", "  42", "-17", "12.7", "1e3", "12abc", "abc", "", "0x1A", "012"];

foreach ($samples as $s) {
    printf("%-8s => %d\n", var_export($s, true), (int) $s);
}

Beachte, dass "12.7" zu 12 wird: Ein Cast nach int schneidet die Nachkommastellen ab, er rundet nicht. Weder (int) noch intval() gibt hier eine Warnung aus, egal welche Eingabe.

intval() mit Basis

intval($value, $base) liest den String in einem anderen Zahlensystem. Mit Basis 0 schaut PHP auf das Präfix: 0x für Hex, 0b für Binär, eine führende 0 für Oktal.

<?php
var_dump(intval("ff", 16));
var_dump(intval("101", 2));
var_dump(intval("777", 8));
var_dump(intval("0x1A", 0));
var_dump(intval("0b101", 0));
var_dump(intval("012", 0));    // octal because of the leading 0
var_dump(intval("012"));       // base 10 by default

// Converting the other way
echo dechex(255), " ", decbin(5), " ", base_convert("ff", 16, 2), "\n";

Float in Int: Abschneiden, nicht Runden

(int) verwirft alles nach dem Dezimalpunkt, in Richtung null. Runde vorher, wenn du die nächste ganze Zahl willst, und achte auf die Klammern:

<?php
var_dump((int) 12.99);
var_dump((int) -12.99);
var_dump((int) round(12.5));

// Precedence: the cast applies to (0.1 + 0.7) before * 10
var_dump((int) (0.1 + 0.7) * 10);
var_dump((int) ((0.1 + 0.7) * 10));
var_dump((int) round((0.1 + 0.7) * 10));

Das letzte Paar ist die klassische Float-Falle: (0.1 + 0.7) * 10 wird als 7.999999... gespeichert, also ergibt Abschneiden 7. Vorher zu runden ergibt 8. Die Seite zu Mathe behandelt round, floor und ceil.

Casts nach bool, string und array

Bei bool werden nur eine Handvoll Werte zu false: 0, 0.0, "", "0", null und []. Alles andere ist true, auch "0.0", " " und "false".

Bei string wird true zu "1", während false und null beide zu "" werden. Floats verlieren ein abschließendes .0, und sehr große oder sehr kleine Floats verwenden die Exponentenschreibweise.

<?php
foreach (["0", "0.0", " ", "false", [], [0], 0.0, -1, null] as $v) {
    printf("%-10s => %s\n", json_encode($v), var_export((bool) $v, true));
}

echo "---\n";
var_dump((string) true, (string) false, (string) null);
var_dump((string) 3.0, (string) 0.1, (string) 1e25);

echo "---\n";
var_dump((array) "a");     // a scalar becomes a one-element array
var_dump((array) null);    // null becomes an empty array

Ein Array in einen String umzuwandeln verbindet es nicht. Das hier gibt Tags: Array aus:

<?php
$tags = ["php", "web"];
echo "Tags: " . $tags;

und PHP hängt eine Warnung an:

Warning: Array to string conversion in /home/index.php on line 3

Verwende implode(", ", $array) oder json_encode($array), um aus einem Array Text zu machen.

Jeder Cast im Überblick

Wähle einen Wert, um zu sehen, was intval, (bool), strval, is_numeric und gettype dafür liefern. Jede Zelle wurde von PHP 8.3 berechnet.

Point at or tap a cell to read it as PHP.

$x	intval	bool	strval	is_numeric	gettype
"10"	10	true	'10'	true	'string'
"1abc"	1	true	'1abc'	false	'string'
"abc"	0	true	'abc'	false	'string'
""	0	false	''	false	'string'
" "	0	true	' '	false	'string'
"0"	0	false	'0'	true	'string'
"0.0"	0	true	'0.0'	true	'string'
"1e1"	10	true	'1e1'	true	'string'
"010"	10	true	'010'	true	'string'
1.5	1	true	'1.5'	true	'double'
true	1	true	'1'	false	'boolean'
false	0	false	''	false	'boolean'
null	0	false	''	false	'NULL'
[]	0	false	"Array" + warning	false	'array'
[1, 2]	1	true	"Array" + warning	false	'array'

Every cell computed by PHP 8.3.19.

Numerische Strings und automatische Umwandlung

Ein numerischer String ist ein String, der wie eine Zahl aussieht: "12", "-3.5", "1e3", mit optionalem Leerraum drumherum. PHP wandelt diese in Rechnungen automatisch um, und is_numeric() sagt dir, ob ein String dazuzählt.

<?php
foreach (["12", "12.5", "1e3", " 12", "12 ", "12abc", "0x1A", ""] as $s) {
    printf("%-8s is_numeric: %s\n", var_export($s, true), var_export(is_numeric($s), true));
}

echo "---\n";
var_dump("5" * "4");     // both numeric: int
var_dump("5" + 1.5);     // float
var_dump(10 . "");       // int to string with concatenation

"12abc" + 1 ergibt immer noch 13, aber PHP 8 gibt Warning: A non-numeric value encountered aus, und "abc" + 1 wirft einen TypeError. Caste oder prüfe Nutzereingaben, bevor du damit rechnest.

settype() und gettype()

settype() ändert den Typ einer Variable direkt, und gettype() meldet ihn. get_debug_type() liefert die kürzeren Namen, die du in Fehlermeldungen siehst (int, float, string).

<?php
$value = "42";
echo gettype($value), "\n";

settype($value, "integer");
var_dump($value);
echo gettype($value), " / ", get_debug_type($value), "\n";

$price = "19.90";
settype($price, "float");
var_dump($price);

Die meisten verwenden stattdessen einen Cast ($value = (int) $value;), weil er kürzer ist und sich genauso liest.

Eingaben prüfen, statt sie zu casten

(int) sagt nie nein, also wird (int) "abc" still zu 0 und (int) "5 apples" zu 5. Für Formulareingaben verwendest du filter_var mit FILTER_VALIDATE_INT: Es liefert die Ganzzahl oder false.

<?php
foreach (["42", " 42 ", "42abc", "4.2", "042", "-7", "abc"] as $input) {
    $n = filter_var($input, FILTER_VALIDATE_INT);
    printf("%-8s => %s\n", var_export($input, true), $n === false ? "rejected" : $n);
}

Vergleiche das Ergebnis mit === false, denn 0 ist eine gültige Ganzzahl, und == false würde sie ablehnen. Die Seite zu filter_var zeigt Wertebereiche und andere Validatoren.