substr_replace()

string substr_replace ( string $string, string $replace, int $start [ , int $length ] )

Description

substr_replace() replaces a copy of string delimited by the start and (optionally) length parameter with the string given in replacement

※ available F/W version : all

Parameters

$string - the input string
$replace - the replacement string
$start - If $start is positive, the replacing will begin at the $start’th offset.
If $start is negative, the replacing will begin at the $start’th character from the end of $string.
$length
If it is positive, it represents the length of the portion of string which is to be replaced.
If it is negative, it represents the number of characters from the end of $string at which to stop replacing.
If it is omitted, then it will default to strlen($string); i.e. end the replacing at the end of $string. If $length is zero then this function will have effect of inserting $replacement into $string at the given $start offset.

Return values

Returns the result string

Example

<?php
$str = "Hello PHPoC!";
$ret = substr_replace($str, "Hi", 0, 5); echo "$ret\r\n";    // OUTPUT: Hi PHPoC!
$ret = substr_replace($str, "Hi", -12, 5); echo "$ret\r\n";  // OUTPUT: Hi PHPoC!
$ret = substr_replace($str, "Hi", 0, -7); echo "$ret\r\n";   // OUTPUT: Hi PHPoC!
$ret = substr_replace($str, "Hi", 6); echo "$ret\r\n";       // OUTPUT: Hello Hi

$str = "";
$ret = substr_replace($str, "Hi", 6); echo "$ret\r\n";       // OUTPUT: Hi
?>

Remarks

This function is identical to the PHP group’s substr() function but it doesn’t support array.

< substr()

system() >