Type Casting PHP: String ke Int, intval(), dan (int)

Untuk mengubah sebuah nilai ke tipe lain, tulis tipenya dalam tanda kurung di depan nilai itu: (int) "42" menghasilkan integer 42. Bentuk fungsinya, intval("42"), melakukan hal yang sama. Casting tidak pernah gagal: teks yang bukan angka menjadi 0, dan string yang diawali digit hanya menyimpan digit-digit itu.

<?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");

Cast yang dimiliki PHP adalah (int), (float), (string), (bool), (array), dan (object). Masing-masing juga punya versi fungsi: intval(), floatval(), strval(), boolval().

String ke int: apa yang dikembalikan (int) dan intval()

PHP membaca digit dari awal string, setelah melewati whitespace di depannya, dan berhenti di karakter pertama yang tidak cocok dengan sebuah angka. Notasi eksponen dihitung sebagai angka, awalan 0x tidak.

<?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);
}

Perhatikan bahwa "12.7" menjadi 12: casting ke int memotong bagian pecahannya, bukan membulatkannya. Baik (int) maupun intval() tidak mencetak warning di sini, apa pun input-nya.

intval() dengan basis bilangan

intval($value, $base) membaca string dalam sistem bilangan lain. Dengan basis 0, PHP melihat awalannya: 0x untuk heksadesimal, 0b untuk biner, 0 di depan untuk oktal. Kamu bisa memeriksa setiap hasil di bawah ini dengan konverter basis bilangan.

<?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 ke int: dipotong, bukan dibulatkan

(int) membuang semua angka setelah titik desimal, ke arah nol. Bulatkan dulu kalau kamu ingin bilangan bulat terdekat, dan perhatikan tanda kurungnya:

<?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));

Pasangan terakhir adalah jebakan float yang klasik: (0.1 + 0.7) * 10 disimpan sebagai 7.999999..., jadi memotongnya menghasilkan 7. Membulatkannya dulu menghasilkan 8. Halaman math membahas round, floor, dan ceil.

Casting ke bool, string, dan array

Ke bool, hanya sedikit nilai yang menjadi false: 0, 0.0, "", "0", null, dan []. Semua yang lain bernilai true, termasuk "0.0", " ", dan "false".

Ke string, true menjadi "1", sedangkan false dan null sama-sama menjadi "". Float membuang .0 di akhir, dan float yang sangat besar atau sangat kecil memakai notasi eksponen.

<?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

Casting array ke string tidak menggabungkan isinya. Kode ini mencetak Tags: Array:

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

dan PHP menambahkan warning:

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

Pakai implode(", ", $array) atau json_encode($array) untuk mengubah array menjadi teks.

Semua cast dalam satu pandangan

Pilih sebuah nilai untuk melihat apa yang dikembalikan intval, (bool), strval, is_numeric, dan gettype untuknya. Setiap sel dihitung oleh PHP 8.3.

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.

String numerik dan konversi otomatis

String numerik adalah string yang terlihat seperti angka: "12", "-3.5", "1e3", dengan whitespace opsional di sekitarnya. PHP mengubahnya secara otomatis dalam aritmetika, dan is_numeric() memberi tahu apakah sebuah string memenuhi syarat itu.

<?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 tetap menghasilkan 13, tetapi PHP 8 mencetak Warning: A non-numeric value encountered, dan "abc" + 1 melempar TypeError. Lakukan cast atau validasi sebelum menghitung dengan input pengguna.

settype() dan gettype()

settype() mengubah tipe sebuah variabel secara langsung dan gettype() melaporkannya. get_debug_type() mengembalikan nama yang lebih pendek seperti yang kamu lihat di pesan error (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);

Kebanyakan kode memakai cast ($value = (int) $value;) sebagai gantinya, karena lebih singkat dan maksudnya sama.

Validasi input alih-alih melakukan cast

(int) tidak pernah menolak, jadi (int) "abc" diam-diam menjadi 0 dan (int) "5 apples" menjadi 5. Untuk input formulir, pakai filter_var dengan FILTER_VALIDATE_INT: fungsi ini mengembalikan integer atau 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);
}

Bandingkan hasilnya dengan === false, karena 0 adalah integer yang sah dan == false akan menolaknya. Halaman filter_var menunjukkan rentang dan validator lainnya.