=====swap=====
Syntax:

<code>
    #include <list>
    void swap( list& from );
</code>

The swap() function exchanges the elements of the current list with those of
from. This function operates in [[/complexity|constant time]].

For example, the following code uses the swap() function to exchange the values
of two lists:

<code>
    list<string> l1;
    l1.push_back("I'm in l1!");

    list<string> l2;
    l2.push_back("And I'm in l2!");

    l1.swap(l2);

    cout << "The first element in l1 is " << l1.front() << endl;
    cout << "The first element in l2 is " << l2.front() << endl;
</code>

The above code displays:

<code terminal>
    The first element in l1 is And I'm in l2!
    The first element in l2 is I'm in l1!
</code>


Related Topics: [[splice]]