std::forward_list<T,Allocator>::pop_front

From cppreference.com

 
C++
 
Containers library
Sequence
(C++11)
(C++11)
Associative
Unordered associative
(C++11)
(C++11)
(C++11)
(C++11)
Adaptors
Views
(C++20)
 
std::forward_list
Member functions
Element access
Iterators
Capacity
Modifiers
forward_list::pop_front
Operations
Non-member functions
(C++20)(C++20)
(until C++20)(until C++20)(until C++20)(until C++20)(until C++20)(C++20)
Deduction guides(C++17)
 
void pop_front();
 (since C++11)

Removes the first element of the container. If there are no elements in the container, the behavior is undefined.

References and iterators to the erased element are invalidated.

Parameters

(none)

Return value

(none)

Complexity

Constant.

Exceptions

Does not throw.

Example

Run this code
#include <forward_list>
#include <iostream>
 
int main()
{
    std::forward_list<char> chars{'A', 'B', 'C', 'D'};
 
    for (; !chars.empty(); chars.pop_front())
    {
        std::cout << "chars.front(): '" << chars.front() << "'\n";
    }
}

Output: 

chars.front(): 'A'
chars.front(): 'B'
chars.front(): 'C'
chars.front(): 'D'

See also

(C++11)
 inserts an element to the beginning
(public member function)
(C++11)
 access the first element
(public member function)
Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/container/forward_list/pop_front&oldid=50505"