PHP str_replace() Function

The str_replace() function replaces some characters with some other characters in a string.

This function works by the following rules:

  • If the string to be searched is an array, it returns an array
  • If the string to be searched is an array, find and replace is performed with every array element
  • If both find and replace are arrays, and replace has fewer elements than find, an empty string will be used as replace
  • If find is an array and replace is a string, the replace string will be used for every find value
    • mixed str_replace ( mixed $search , mixed $replace , mixed $subject [, int &$count ] )

    This function returns a string or an array with all occurrences of search in subject replaced with the given replace value.If you don't need fancy replacing rules (like regular expressions), you should always use this function instead of preg_replace().

    Example -

    Example #1 Basic str_replace() examples

    Example #2 Examples of potential str_replace() gotchas

    ParameterDescription
    searchRequired. Specifies the value to search
    replaceThe replacement value that replaces found search values. An array may be used to designate multiple replacements.
    subjectThe string or array being searched and replaced on, otherwise known as the haystack.If subject is an array, then the search and replace is performed with every entry of subject, and the return value is an array as well.
    countIf passed, this will be set to the number of replacements performed.

    This function returns a string or an array with the replaced values.