替换目标字符串指定次数的PHP字符串函数

如何利用php的str_replace只替换目标字符串的内容一次，而不是全部替换。

mixed preg_replace ( mixed pattern, mixed replacement, mixed subject [, int limit] )

在subject 中搜索 pattern 模式的匹配项并替换为 replacement。如果指定了 limit，则仅替换 limit 个匹配，如果省略 limit 或者其值为 -1，则所有的匹配项都会被替换。

因为preg_replace的第四个参数可以实现替换次数的限制，所以这个问题这样处理很方便。但是在查看php.net上关于str_replace的函数评论后，从中居然也可以挑出几个有代表性的函数来。

str_replace_once
思路首先是找到待替换的关键词的位置，然后利用substr_replace函数直接替换之。

PLAIN TEXTCODE:
<?php
function str_replace_once($needle, $replace, $haystack) {
    // Looks for the first occurence of $needle in $haystack
    // and replaces it with $replace.
    $pos = strpos($haystack, $needle);
    if ($pos === false) {
        // Nothing found
        return $haystack;
    }
    return substr_replace($haystack, $replace, $pos, strlen($needle));
}
?>

str_replace_limit
还是利用preg_replace，只不过它的参数更象preg_replace了，而且对某些特殊字符做了转义处理，通用性更好。

function str_replace_limit($search, $replace, $subject, $limit=-1) {
    // constructing mask(s)...
    if (is_array($search)) {
        foreach ($search as $k=>$v) {
            $search[$k] = '`' . preg_quote($search[$k],'`') . '`';
        }
    }
    else {
        $search = '`' . preg_quote($search,'`') . '`';
    }
    // replacement
    return preg_replace($search, $replace, $subject, $limit);
}