list Class Members

Reference

Constructors

list

Constructs a list of a specific size or with elements of a specific value or with a specific allocator or as a copy of some other list.

Typedefs

allocator_type

A type that represents the allocator class for a list object.

const_iterator

A type that provides a bidirectional iterator that can read a const element in a list.

const_pointer

A type that provides a pointer to a const element in a list.

const_reference

A type that provides a reference to a const element stored in a list for reading and performing const operations.

const_reverse_iterator

A type that provides a bidirectional iterator that can read any const element in a list.

difference_type

A type that provides the difference between two iterators that refer to elements within the same list.

iterator

A type that provides a bidirectional iterator that can read or modify any element in a list.

pointer

A type that provides a pointer to an element in a list.

reference

A type that provides a reference to a const element stored in a list for reading and performing const operations.

reverse_iterator

A type that provides a bidirectional iterator that can read or modify an element in a reversed list.

size_type

A type that counts the number of elements in a list.

value_type

A type that represents the data type stored in a list.

Member Functions

assign

Erases elements from a list and copies a new set of elements to the target list.

back

Returns a reference to the last element of a list.

begin

Returns an iterator addressing the first element in a list.

list::cbegin

Returns a const iterator addressing the first element in a list.

list::cend

Returns a const iterator that addresses the location succeeding the last element in a list.

list::clear

Erases all the elements of a list.

list::crbegin

Returns a const iterator addressing the first element in a reversed list.

list::crend

Returns a const iterator that addresses the location succeeding the last element in a reversed list.

list::emplace

Inserts an element constructed in place into a list at a specified position.

list::emplace_back

Adds an element constructed in place to the end of a list.

list::emplace_front

Adds an element constructed in place to the beginning of a list.

empty

Tests if a list is empty.

end

Returns an iterator that addresses the location succeeding the last element in a list.

erase

Removes an element or a range of elements in a list from specified positions.

front

Returns a reference to the first element in a list.

get_allocator

Returns a copy of the allocator object used to construct a list.

insert

Inserts an element or a number of elements or a range of elements into a list at a specified position.

max_size

Returns the maximum length of a list.

merge

Removes the elements from the argument list, inserts them into the target list, and orders the new, combined set of elements in ascending order or in some other specified order.

pop_back

Deletes the element at the end of a list.

pop_front

Deletes the element at the beginning of a list.

push_back

Adds an element to the end of a list.

push_front

Adds an element to the beginning of a list.

rbegin

Returns an iterator addressing the first element in a reversed list.

remove

Erases elements in a list that match a specified value.

remove_if

Erases elements from the list for which a specified predicate is satisfied.

rend

Returns an iterator that addresses the location succeeding the last element in a reversed list.

resize

Specifies a new size for a list.

reverse

Reverses the order in which the elements occur in a list.

size

Returns the number of elements in a list.

sort

Arranges the elements of a list in ascending order or with respect to some other order relation.

splice

Removes elements from the argument list and inserts them into the target list.

swap

Exchanges the elements of two lists.

unique

Removes adjacent duplicate elements or adjacent elements that satisfy some other binary predicate from the list.

Operators

list::operator=

Replaces the elements of the list with a copy of another list.

See Also

Reference

list Class

Thread Safety in the Standard C++ Library

Standard Template Library