replaces a string with another string (bash function)

str_replace.bash

# replaces a string with another string
# @param string source string
# @param string search string
# @param string replacement string"
# usage: result="$(str_replace "foo bar" "foo" "hi")"

function str_replace()
{
    [ -z "$1" ] && return 1
    [ -z "$2" ] && return 1
    [ -z "$3" ] && return 1
    _strreplace_var_replace=$(printf "%s\\n" "$1" | sed -e "s/${2}/${3}/g")
    printf "%s\\n" "${_strreplace_var_replace}"
}