std::vector<T,Allocator>:: append_range

Insère des copies des éléments de la plage rg avant end() , dans l'ordre non inversé.

Si après l'opération la nouvelle size() est supérieure à l'ancienne capacity() , une réallocation a lieu, auquel cas tous les itérateurs (y compris l'itérateur end() ) et toutes les références aux éléments sont invalidés. Sinon, seul l'itérateur end() est invalidé.

Chaque itérateur dans rg est déréférencé exactement une fois.

Paramètres

Complexité

Si une réallocation se produit, linéaire dans le nombre d'éléments du vector résultant ; sinon, linéaire dans le nombre d'éléments insérés plus la distance jusqu'à la end() .

Exceptions

Si une exception est levée autrement que par le constructeur de copie, le constructeur de déplacement, l'opérateur d'affectation ou l'opérateur de déplacement de T ou par toute opération des InputIterator , il n'y a aucun effet. Si une exception est levée lors de l'insertion d'un seul élément à la fin et que T est CopyInsertable ou que std::is_nothrow_move_constructible_v <T> est true , il n'y a aucun effet. Sinon, si une exception est levée par le constructeur de déplacement d'un T non- CopyInsertable , les effets sont non spécifiés.

Notes

Exemple

#include <cassert>
#include <vector>
#include <list>
int main()
{
    auto head = std::vector{1, 2, 3, 4};
    const auto tail = std::list{-5, -6, -7};
#ifdef __cpp_lib_containers_ranges
    head.append_range(tail);
#else
    head.insert(head.end(), tail.cbegin(), tail.cend());
#endif
    assert((head == std::vector{1, 2, 3, 4, -5, -6, -7}));
}

Voir aussi