PHP substr_replace() Function

## PHP Basic

PHP HOME PHP Intro PHP Install PHP Syntax PHP Variables PHP Echo / Print PHP Data Types PHP String Functions PHP Constants PHP Operators PHP If...Else...Elseif PHP Switch PHP While Loops PHP For Loops PHP Functions PHP Arrays PHP Sorting Arrays PHP Superglobals

## PHP Forms

PHP Form Handling PHP Form Validation PHP Form Required PHP Form URL/E-mail PHP Form Complete

## PHP Advanced

PHP Arrays Multi PHP Date PHP Include PHP File PHP File Upload PHP Cookies PHP Sessions PHP E-mail PHP Secure E-mail PHP Error PHP Exception PHP Filter

## PHP Database

PHP MySQL Intro PHP MySQL Connect PHP CREATE DB/Table PHP INSERT INTO PHP SELECT PHP WHERE PHP ORDER BY PHP UPDATE PHP DELETE PHP ODBC

## PHP XML

XML Expat Parser XML DOM XML SimpleXML

## PHP and AJAX

AJAX Intro AJAX PHP AJAX Database AJAX XML AJAX Live Search AJAX RSS Reader AJAX Poll

## PHP Reference

PHP Array PHP Calendar PHP Date PHP Directory PHP Error PHP Filesystem PHP Filter PHP FTP PHP HTTP PHP Libxml PHP Mail PHP Math PHP Misc PHP MySQLi PHP SimpleXML PHP String PHP XML PHP Zip PHP Timezones

## PHP Quiz

PHP Quiz PHP Certificate

# PHP substr_replace() Function

PHP String Reference

## Example

Replace "Hello" with "world":

<?php
echo substr_replace("Hello","world",0);
?>
Run example »

## Definition and Usage

The substr_replace() function replaces a part of a string with another string.

Note: If the start parameter is a negative number and length is less than or equal to start, length becomes 0.

Note: This function is binary-safe.

## Syntax

substr_replace(string,replacement,start,length)

Parameter | Description
--- | ---
string | Required. Specifies the string to check
replacement | Required. Specifies the string to insert

start

Required. Specifies where to start replacing in the string

- A positive number - Start replacing at the specified position in the string
- Negative number - Start replacing at the specified position from the end of the string
- 0 - Start replacing at the first character in the string

length

Optional. Specifies how many characters should be replaced. Default is the same length as the string.

- A positive number - The length of string to be replaced
- A negative number - How many characters should be left at end of string after replacing
- 0 - Insert instead of replace

## Technical Details

Return Value: | Returns the replaced string. If the string is an array then the array is returned
PHP Version: | 4+
Changelog: | As of PHP 4.3.3, all parameters now accept arrays

## More Examples

## Example 1

Start replacing at the 6th position in the string (replace "world" with "earth"):

<?php
echo substr_replace("Hello world","earth",6);
?>
Run example »

## Example 2

Start replacing at the 5th position from the end of the string (replace "world" with "earth"):

<?php
echo substr_replace("Hello world","earth",-5);
?>
Run example »

## Example 3

Insert "Hello" at the beginning of "world":

<?php
echo substr_replace("world","Hello ",0,0);
?>
Run example »

## Example 4

Replace multiple strings at once. Replace "AAA" in each string with "BBB":

<?php
$replace = array("1: AAA","2: AAA","3: AAA");
echo implode("<br>",substr_replace($replace,'BBB',3,3));
?>
Run example »

PHP String Reference

## Your suggestion:

Your E-mail (optional):

Page address:

Description:

Close [X]

## Thank You For Helping Us!

Your message has been sent to W3Schools.

Close [X]
Search w3schools.com:

## WEB HOSTING

Best Web Hosting UK Reseller Hosting Wow! $5 SSD Hosting

## WEB BUILDING

Download XML Editor
FREE Website BUILDER FREE Website Creator

## WEB RESOURCES

Web Statistics Web Validation

## SHARE THIS PAGE