std::list::insert

<metanoindex/>

 

C++

Suporte ao Compilador

Freestanding and hosted

Linguagem

Headers da Biblioteca Standard

Requerimentos nomeados

Feature test macros (C++20)

Biblioteca de suporte de língua

Biblioteca de conceitos (C++20)

Biblioteca de diagnósticos

Biblioteca de utilitários em geral

Biblioteca de strings

Biblioteca de containers

Ranges library (C++20)

Biblioteca de iteradores

Biblioteca de algorítmos

Biblioteca numérica

Biblioteca de localizações

Biblioteca de input/output

Biblioteca de sistema de arquivo (C++17)

Biblioteca de expressões regulares (C++11)

Biblioteca de operações atômicas (C++11)

Biblioteca de suporte de thread (C++11)

Especificações Técnicas

Índice de symbolos

Bibliotecas externas

 

Recipientes biblioteca

array (C++11)

vector

deque

forward_list (C++11)

list

set

multiset

map

multimap

unordered_set (C++11)

unordered_multiset (C++11)

unordered_map (C++11)

unordered_multimap (C++11)

stack

queue

priority_queue

 

std::list

Funções de membro Original: Member functions The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

list::list

list::~list

list::operator=

list::assign

list::get_allocator

acesso. Elemento Original: Element access The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

list::front

list::back

Iteradores Original: Iterators The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

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

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

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

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

Capacidade Original: Capacity The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

list::empty

list::size

list::max_size

Modificadores Original: Modifiers The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

list::clear

list::insert

list::emplace (C++11)

list::erase

list::push_front

list::emplace_front (C++11)

list::pop_front

list::push_back

list::emplace_back (C++11)

list::pop_back

list::resize

list::swap

Operações Original: Operations The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

list::merge

list::splice

list::remove list::remove_if

list::reverse

list::unique

list::sort

 

<tbody> </tbody>

iterator insert( iterator pos, const T& value ); iterator insert( const_iterator pos, const T& value );	(1)	(até C++11) (desde C++11)
iterator insert( const_iterator pos, T&& value );	(2)	(desde C++11)
void insert( iterator pos, size_type count, const T& value ); iterator insert( const_iterator pos, size_type count, const T& value );	(3)	(até C++11) (desde C++11)
template< class InputIt > void insert( iterator pos, InputIt first, InputIt last); template< class InputIt > iterator insert( const_iterator pos, InputIt first, InputIt last );	(4)	(até C++11) (desde C++11)
iterator insert( const_iterator pos, std::initializer_list<T> ilist );	(5)	(desde C++11)

Insere elementos a posição especificada no recipiente.

Original:

Inserts elements to specified position in the container.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

1-2)

insere value antes do elemento apontado por pos

Original:

inserts value before the element pointed to by pos

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

3)

count insere cópias do value antes do elemento apontado por pos

Original:

inserts count copies of the value before the element pointed to by pos

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

4)

insere elementos de [first, last) faixa antes do elemento apontado por pos

Original:

inserts elements from range [first, last) before the element pointed to by pos

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

5)

insere elementos da lista de inicializador ilist.

Original:

inserts elements from initializer list ilist.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

No iterators or references are invalidated.

Parâmetros

pos	-	elemento antes que o conteúdo será inserido Original: element before which the content will be inserted The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
value	-	elemento de valor para inserir Original: element value to insert The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
first, last	-	o intervalo de elementos a inserir, não pode ser iteradores no recipiente para o qual é chamado de inserção Original: the range of elements to insert, can't be iterators into container for which insert is called The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
ilist	-	inicializador lista para inserir os valores de Original: initializer list to insert the values from The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
Type requirements
- InputIt must meet the requirements of InputIterator.

Valor de retorno

1-2)

iterador apontando para o value inserido

Original:

iterator pointing to the inserted value

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

3)

iterador apontando para o primeiro elemento inserido, ou se pos count==0.

Original:

iterator pointing to the first element inserted, or pos if count==0.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

4)

iterador apontando para o primeiro elemento inserido, ou se pos first==last.

Original:

iterator pointing to the first element inserted, or pos if first==last.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

5)

iterador apontando para o primeiro elemento inserido, ou se pos ilist está vazia.

Original:

iterator pointing to the first element inserted, or pos if ilist is empty.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Complexidade

1-2) Constant.

3) Linear in count

4) Linear in std::distance(first, last)

5) Linear in ilist.size()

Veja também

emplace (C++11)	constructs element in-place (função pública membro)
push_front	insere elementos no início Original: inserts elements to the beginning The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (função pública membro)
push_back	adiciona elementos ao fim Original: adds elements to the end The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (função pública membro)