StringReplace

Заменяет в строке все найденные подстроки на заданную последовательность символов.

int  StringReplace(
   string&         str,              // строка, в которой будет осуществляться замена
   const string    find,             // искомая подстрока
   const string    replacement       // подстрока, которая будет вставлена в найденные места
   );

Параметры

str

[in][out] Строка, в которой необходимо произвести замены.

find

[in] Искомая подстрока для замены.

replacement

[in] Подстрока, которая будет вставлена вместо найденной.

Возвращаемое значение

Количество произведенных замен в случае успеха, в случае ошибки -1. Для получения кода ошибки нужно вызвать функцию GetLastError().

Примечание

Если функция успешно отработала, но замены не произведены (не найдена заменяемая подстрока), то возвращается 0.

Причиной ошибки могут быть неверные параметры str или find (пустая или неинициализировання строка, см. StringInit() ). Кроме того, ошибка возникнет, если для завершения замен недостаточно памяти.

Пример:

  string text="The quick brown fox jumped over the lazy dog.";
  int replaced=StringReplace(text,"quick","slow");
  replaced+=StringReplace(text,"brown","black");
  replaced+=StringReplace(text,"fox","bear");
  Print("Replaced: ", replaced,". Result=",text);

//  Результат
//  Replaced: 3. Result=The slow black bear jumped over the lazy dog.
//

Смотри также

StringSetCharacter(), StringSubstr()

StringLenStringSetCharacter