std::basic_string::replace

 

C++

Язык

Понятия (концепции)

Утилиты

Строки

Контейнеры

Алгоритмы

Итераторы

Работа с числами

Ввод / вывод

Локализация

Регулярные выражения (C++11)

Атомарные примитивы (C++11)

Потоки (C++11)

 

Строки

Байтовые строки с завершающим нулем

Однобайтовые строки

Многобайтовые строки

Широкие строки

Классы

basic_string

char_traits

 

std::basic_string

Функции-члены

basic_string::basic_string

basic_string::operator=

basic_string::assign

basic_string::get_allocator

Доступ к элементам

basic_string::at

basic_string::operator[]

basic_string::front (C++11)

basic_string::back (C++11)

basic_string::data

basic_string::c_str

Итераторы

basic_string::begin basic_string::cbegin (C++11)

basic_string::end basic_string::cend (C++11)

basic_string::rbegin basic_string::crbegin (C++11)

basic_string::rend basic_string::crend (C++11)

Вместимость

basic_string::empty

basic_string::size

basic_string::length

basic_string::max_size

basic_string::reserve

basic_string::capacity

basic_string::shrink_to_fit (C++11)

Операции

basic_string::clear

basic_string::insert

basic_string::erase

basic_string::push_back

basic_string::pop_back (C++11)

basic_string::append

basic_string::operator+=

basic_string::compare

basic_string::replace

basic_string::substr

basic_string::copy

basic_string::resize

basic_string::swap

Поиск

basic_string::find

basic_string::rfind

basic_string::find_first_of

basic_string::find_first_not_of

basic_string::find_last_of

basic_string::find_last_not_of

Константы

basic_string::npos

Функции, не являющиеся членами

operator+

operator== operator!= operator< operator> operator<= operator>=

swap(std::basic_string)

operator<< operator>>

getline

stoi stol stoll (C++11) (C++11) (C++11)

stoul stoull (C++11) (C++11)

stof stod stold (C++11) (C++11) (C++11)

to_string (C++11)

to_wstring (C++11)

Вспомогательные классы

hash<std::string> hash<std::wstring> hash<std::u32string> hash<std::u16string> (C++11)

 

basic_string& replace( size_type pos, size_type count,                        const basic_string& str ); basic_string& replace( const_iterator first, const_iterator last,                        const basic_string& str );	(1)
basic_string& replace( size_type pos, size_type count,                        const basic_string& str,                        size_type pos2, size_type count2 ); template< class InputIt > basic_string& replace( const_iterator first, const_iterator last,                        InputIt first2, InputIt last2 );	(2)
basic_string& replace( size_type pos, size_type count,                        const CharT* cstr, size_type count2 ); basic_string& replace( const_iterator first, const_iterator last,                        const CharT* cstr, size_type count2 );	(3)
basic_string& replace( size_type pos, size_type count,                        const CharT* cstr ); basic_string& replace( const_iterator first, const_iterator last,                        const CharT* cstr );	(4)
basic_string& replace( size_type pos, size_type count,                        size_type count2, CharT ch ); basic_string& replace( const_iterator first, const_iterator last,                        size_type count2, CharT ch );	(5)
basic_string& replace( const_iterator first, const_iterator last,                        std::initializer_list<CharT> ilist );	(6)	(начиная с C++11)

Заменяет часть строки, указанную диапазоном [pos, pos + count) или [first, last), на новую строку.

Новой строкой может быть:

1) строка str

2) подстрока [pos2, pos2 + count2) из str или символы в диапазоне [first2, last2)

3) первые count2 символов строки, на которую указывает cstr

4) строка с завершающим нулевым символом, на которую указывает cstr

5) count2 символов ch

6) символы в списке инициализации ilist

Параметры

pos	-	позиция начала подстроки, которая будет заменена
count	-	длина подстроки, которая будет заменена
first, last	-	диапазон символов, которые будут заменены
str	-	строка, используемая для замены
pos2	-	позиция начала подстроки, используемой для замены
count2	-	количество символов замены
cstr	-	указатель на строку символов, используемую для замены
ch	-	значение символа, используемого для замены
first2, last2	-	диапазон символов, используемых для замены
init	-	список инициализации с символами, используемыми для замены
Требования к типам
- InputIt должен соответствовать требованиям InputIterator.

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

*this

Исключения

std::out_of_range, если pos > length() или pos2 > str.length()

std::length_error, если результирующая строка будет превышать максимально возможную длину (std::string::npos - 1)

Пример

Запустить этот код

#include <iostream>
#include <string>
 
int main()
{
    std::string str("The quick brown fox jumps over the lazy dog.");
 
    str.replace(10, 5, "red"); // (4)
 
    str.replace(str.begin(), str.begin() + 3, 1, 'A'); // (5)
 
    std::cout << str << '\n';
}

Вывод:

A quick red fox jumps over the lazy dog.