PHP | Función substr_replace()

La función substr_replace() es una función incorporada en PHP y se usa para reemplazar una parte de una string con otra string. El índice en la string original a partir de la cual se realizará el reemplazo debe pasarse como parámetro. Si se desea, también se puede especificar la longitud hasta la cual se debe realizar el reemplazo. Se puede proporcionar una array de strings como parámetro para esta función, en cuyo caso los reemplazos se producirán en cada string por turno.

Sintaxis:

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

Parámetros: esta función acepta cuatro parámetros, como se muestra en la sintaxis anterior, de los cuales los primeros tres son obligatorios y el último es opcional. Todos estos parámetros se describen a continuación:

• $string: este parámetro es obligatorio. Especifica la string de entrada en la que se realizará el reemplazo.
• $reemplazo: este parámetro también es obligatorio. Especifica la string que se insertará en $string.
• $start : este parámetro también es obligatorio. Especifica la posición desde la que debe iniciarse el reemplazo.
  • Si $start es un número positivo , el reemplazo comienza en la posición especificada en la string
  • Si $start es un número negativo , el reemplazo comienza en la posición especificada desde el final de la string
  • Si $start es 0, el reemplazo ocurre desde el primer carácter de la string
• $longitud: este parámetro es opcional. Especifica cuántos caracteres deben ser reemplazados. En caso de que no se especifique $longitud, el reemplazo se detiene al final de $string
  • Si $longitud es positiva , representa la longitud de la porción de $string que se va a reemplazar.
  • Si $longitud es negativa , representa el número de caracteres desde el final de $string antes de que se detenga el reemplazo.
  • Si $longitud es 0, se realiza la inserción en lugar del reemplazo.

Valor de retorno: se devuelve la string generada después del reemplazo. En el caso de una array de strings, se devuelve la array.

Ejemplos:

Input : $string = "Geeks for Geeks", $replacement = "GFG", $start = 0
Output : GFG

Input : $string = "Hello World", $replacement = "Hello", $start = 6
Output : Hello Hello

Los siguientes programas ilustran la función substr_replace():

Programa 1: En este programa usaremos la función substr_replace() sin ningún parámetro $longitud. Todos los caracteres desde $inicio hasta el final de $string serán reemplazados por $reemplazo.

<?php
  
echo substr_replace("Hello World", "GFG", 6);
  
?>

Producción

Hello GFG

Programa 2: En este programa usaremos la función substr_replace() con $longitud establecida en 0. En este caso, se producirá la inserción. No se realizará ningún reemplazo.

<?php
  
echo substr_replace("Contribute GFG", "to ", 11, 0);
  
?>

Producción

Contribute to GFG

Programa 3: En este programa usaremos la función substr_replace() con $longitud establecida en un valor positivo. En este caso, la string de $reemplazo reemplazará los caracteres de $string hasta $longitud desde $inicio.

<?php
  
echo substr_replace("alone", "ph", 0, 2);
  
?>

Producción

phone

Programa 4: En este programa usaremos la función substr_replace() con $longitud establecida en un valor negativo. En este caso, la string de $reemplazo reemplazará los caracteres de $string desde $inicio y se detendrá antes de la cantidad de caracteres de $longitud desde el final de la string.

<?php
  
echo substr_replace("alone", "ph", 0, -3);
  
?>

Producción

phone

Programa 5: En este programa usaremos la función substr_replace() sin ningún parámetro de $longitud y $start establecido en un valor negativo. El reemplazo comenzará en la posición especificada desde el final de la string.

<?php
  
echo substr_replace("alpha", "one", -3);
  
?>

Producción

alone

Referencia: http://php.net/manual/en/function.substr-replace.php