Пространства имён
Варианты
Действия

std::basic_string::append

Материал из cppreference.com
< cpp‎ | string‎ | basic string
 
 
 
std::basic_string
 
basic_string& append( size_type count, const CharT& ch );
(1)
basic_string& append( const basic_string& str );
(2)
basic_string& append( const basic_string& str,

                      size_type pos,

                      size_type count );
(3)
basic_string& append( const CharT* s,
                      size_type count );
(4)
basic_string& append( const CharT* s );
(5)
template< class InputIt >
basic_string& append( InputIt first, InputIt last );
(6)
basic_string& append( std::initializer_list<CharT> ilist );
(7) (начиная с C++11)

Добавляет символы в конец строки.

1) Добавляет count символов ch

2) Добавляет строку str

3) Добавляет подстроку [pos, pos+count) из str. Если запрошенная подстрока выходит за границы конца строки, или если count == npos, диапазоном добавляемой подстроки будет [pos, size()). Если pos >= str.size(), будет сгенерировано исключение std::out_of_range

4) Добавляет первые count символов из символьной строки, на которую указывает s. s может содержать нулевые символы.

5) Добавляет строку с завершающим нулем, на которую указывает s. Длина строки определяется по первому вхождению нулевого символа.

6) Добавляет символы в диапазоне [first, last)

7) Добавляет символы из списка инициализации ilist

Содержание

[править] Параметры

count количество символов для добавления
ch символ для добавления
first, last диапазон символов для добавления
str строка для добавления
s указатель на добавляемую строку символов
init список инициализации с символами для добавления
Требования к типам
-
InputIt должен соответствовать требованиям InputIterator.

[править] Возвращаемое значение

*this

[править] Сложность

1) линейная по count

2) линейная по размеру str

3-4) линейная по count

5) линейная по размеру s

6) линейная по расстоянию между first и last

7) линейная по размеру init

[править] Пример

[править] См. также

добавляет символы в конец строки
(public функция-член) [править]