substr_replace() function PHP

substr_replace() function berguna untuk mengubah sebagian string (substring) berdasarkan posisi character di dalamnya.

Syntax

mixed substr_replace(mixed $string, mixed $replacement, mixed $start, mixed $length)

Parameter

Parameter Penjelasan
string Parameter ini wajib ada. String yang ingin diproses.
replacement Parameter ini wajib ada. String yang akan mengubah sebagian string (parameter string).
start Parameter ini wajib ada. Posisi awal sebagian string yang ingin diubah. Parameter ini memiliki beberapa pilihan, yaitu:

  • Positif. Posisi awal dihitung mulai dari awal string ke akhir string dengan character paling awal string adalah 0, setelahnya adalah 1 dan seterusnya sampai akhir string.
  • Negatif. Posisi awal dihitung mulai dari akhir string ke awal string dengan character paling akhir adalah -1, character sebelumnya adalah -2 dan seterusnya sampai awal string.
length Parameter ini pilihan. Panjang sebagian string yang ingin diubah mulai dari parameter start. Parameter ini memiliki beberapa pilihan, yaitu:

  • Default. Jika parameter ini dikosongkan maka sebagian string yang diubah adalah mulai dari parameter start sampai akhir string.
  • Positif. Panjang string yang diubah adalah mulai dari parameter start sampai sepanjang parameter length ini.
  • Negatif. Panjang string yang diubah adalah mulai dari parameter start sampai akhir string yang sudah dikurangi sebanyak angka negatif parameter length ini.
  • 0. Parameter replacement akan ditambahkan pada posisi ini tanpa mengubah character apapun yang ada di dalam string.

Catatan

substr_replace() function mengubah sebagian string (parameter string) mulai dari posisi parameter start sampai sepanjang parameter length.

Jika parameter string adalah string maka substr_replace() function akan menghasilkan string.

Jika parameter string adalah array maka substr_replace() function akan menghasilkan array.

Jika parameter string adalah array maka substr_replace() function akan menjalankan parameter replacement dan parameter start terhadap setiap elemen array.

Contoh

Berikut ini adalah contoh penggunaan substr_replace() function:

Code PHP 1:

<?php
echo substr_replace("0123456789", "abc", 2);
?>

Hasil running code di atas bila dilihat melalui page source browser akan tampak sebagai berikut ini:

01abc

Pada contoh di atas, substr_replace() function mengubah sebagian string [0123456789] mulai dari posisi [2] sampai habis dengan [abc].

Berikut ini adalah contoh substr_replace() function menggunakan parameter start dengan nilai negatif:

Code PHP 2:

<?php
echo substr_replace("0123456789", "abc", -3);
?>

Hasil running code di atas bila dilihat melalui page source browser akan tampak sebagai berikut ini:

0123456abc

Parameter start -3 artinya bagian string yang diganti adalah mulai dari posisi ke 3 dari kanan.

Berikut ini adalah contoh substr_replace() function menggunakan parameter length dengan nilai 0:

Code PHP 3:

<?php
echo substr_replace("0123456789", "abc", 2, 0);
?>

Hasil running code di atas bila dilihat melalui page source browser akan tampak sebagai berikut ini:

01abc23456789

Menggunakan parameter length dengan nilai 0 artinya adalah tidak ada character yang akan dihapus. Sebaliknya, substr_replace() function hanya akan menambahkan string yang ada di parameter replacement.

Berikut ini adalah contoh substr_replace() function menggunakan parameter length dengan nilai positif:

Code PHP 4:

<?php
echo substr_replace("0123456789", "abc", 2, 2);
?>

Hasil running code di atas bila dilihat melalui page source browser akan tampak sebagai berikut ini:

01abc456789

Berikut ini adalah contoh substr_replace() function menggunakan parameter string yang berupa array:

Code PHP 5:

<?php
$replace = array("abc", "def", "ghi");

$a = substr_replace($replace,'x',1);

print_r($a);
?>

Hasil running code di atas bila dilihat melalui page source browser akan tampak sebagai berikut ini:

Array
(
    [0] => ax
    [1] => dx
    [2] => gx
)

Lihat function lainnya:

  • str_replace() – Mengubah sebagian string (substring) dengan string yang dikehendaki (case sensitive).

Leave a Reply

Your email address will not be published. Required fields are marked *

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>