Заменяет все вхождения одной подстроки на другую в заданной строке, если такие имеются.
Возвращает новую строку, исходная строка не изменяется.
StrReplace(
str: string|any,
oldSubStr: string|any,
newSubStr: string|any,
): string
str
— Исходная строка.oldSubStr
— Подстрока, которую надо заменить.newSubStr
— Подстрока, которой заменяют старую подстроку.
Внимание
Строковые аргументы могут принимать значения, не являющиеся строками. В этом случае они будут автоматически приведены к строке. Это может привести к неожиданному поведению.
Если аргумент oldSubStr
равен пустой строке, замены произведено не будет.
Если аргумент oldSubStr
не содержится в исходной строке, замены произведено не будет.
Примеры
var str1 = 'first_name=Jhon,last_name=Kennedy';
alert(StrReplace(str1, '_name', 'Name'));
// -> firstName=Jhon,lastName=Kennedy
var str2 = 'some string value';
alert(StrReplace(str2, 'not matching', 'any'));
// -> 'some string value'
var str3 = 'some string value';
alert(StrReplace(str3, '', 'any'));
// -> 'some string value'
var str4 = 'value is undefined';
alert(StrReplace(str4, undefined, 'any'));
// -> 'value is any'
var str5 = 'value is undefined';
alert(StrReplace(str5, null, 'any'));
// -> 'value is undefined'