---
name: "std::__debug::list"
section: "3"
platform: "linux"
package: "gcc"
version: "16.2.1+r23+gd564253eb6c8-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/std::__debug::list"
---

# std::\_\_debug::list(3)

Class std::list with safety/checking/debug instrumentation.

## NAME

std::\_\_debug::list\< \_Tp, \_Allocator \> - Class std::list with safety/checking/debug instrumentation.

## SYNOPSIS

\#include \<list\>

Inherits **\_\_gnu\_debug::\_Safe\_container\< \_SafeContainer, \_Alloc, \_SafeBase, \_IsCxx11AllocatorAware \>**.

### Public Types

typedef \_Allocator **allocator\_type**\
 typedef **\_\_gnu\_debug::\_Safe\_iterator**\< \_Base\_const\_iterator, list \> **const\_iterator**\
 typedef \_Base::const\_pointer **const\_pointer**\
 typedef \_Base::const\_reference **const\_reference**\
 typedef **std::reverse\_iterator**\< const\_iterator \> **const\_reverse\_iterator**\
 typedef \_Base::difference\_type **difference\_type**\
 typedef **\_\_gnu\_debug::\_Safe\_iterator**\< \_Base\_iterator, list \> **iterator**\
 typedef \_Base::pointer **pointer**\
 typedef \_Base::reference **reference**\
 typedef **std::reverse\_iterator**\< iterator \> **reverse\_iterator**\
 typedef \_Base::size\_type **size\_type**\
 typedef \_Tp **value\_type**\

### Public Member Functions

**list** (\_Base\_ref \_\_x)\
 template\<class \_InputIterator, typename = std::\_RequireInputIter\<\_InputIterator\>\> **list** (\_InputIterator \_\_first, \_InputIterator \_\_last, const \_Allocator &\_\_a=\_Allocator())\
 **list** (const \_Allocator &\_\_a) noexcept\
 **list** (const list &)=default\
 **list** (const list &\_\_x, const \_\_type\_identity\_t\< allocator\_type \> &\_\_a)\
 **list** (**initializer\_list**\< value\_type \> \_\_l, const allocator\_type &\_\_a=allocator\_type())\
 **list** (list &&)=default\
 **list** (list &&\_\_x, const \_\_type\_identity\_t\< allocator\_type \> &\_\_a) noexcept(**std::is\_nothrow\_constructible**\< \_Base, \_Base, const allocator\_type & \>::value)\
 **list** (size\_type \_\_n, const \_\_type\_identity\_t\< \_Tp \> &\_\_value, const \_Allocator &\_\_a=\_Allocator())\
 **list** (size\_type \_\_n, const allocator\_type &\_\_a=allocator\_type())\
 const \_Base & **\_M\_base** () const noexcept\
 \_Base & **\_M\_base** () noexcept\
 template\<class \_InputIterator, typename = std::\_RequireInputIter\<\_InputIterator\>\> void **assign** (\_InputIterator \_\_first, \_InputIterator \_\_last)\
 void **assign** (**initializer\_list**\< value\_type \> \_\_l)\
 void **assign** (size\_type \_\_n, const \_Tp &\_\_t)\
 const\_reference **back** () const noexcept\
 reference **back** () noexcept\
 const\_iterator **begin** () const noexcept\
 iterator **begin** () noexcept\
 const\_iterator **cbegin** () const noexcept\
 const\_iterator **cend** () const noexcept\
 void **clear** () noexcept\
 const\_reverse\_iterator **crbegin** () const noexcept\
 const\_reverse\_iterator **crend** () const noexcept\
 template\<typename... \_Args\> iterator **emplace** (const\_iterator \_\_position, \_Args &&... \_\_args)\
 const\_iterator **end** () const noexcept\
 iterator **end** () noexcept\
 iterator **erase** (const\_iterator \_\_first, const\_iterator \_\_last) noexcept\
 iterator **erase** (const\_iterator \_\_position) noexcept\
 const\_reference **front** () const noexcept\
 reference **front** () noexcept\
 iterator **insert** (const\_iterator \_\_p, **initializer\_list**\< value\_type \> \_\_l)\
 template\<class \_InputIterator, typename = std::\_RequireInputIter\<\_InputIterator\>\> iterator **insert** (const\_iterator \_\_position, \_InputIterator \_\_first, \_InputIterator \_\_last)\
 iterator **insert** (const\_iterator \_\_position, \_Tp &&\_\_x)\
 iterator **insert** (const\_iterator \_\_position, const \_Tp &\_\_x)\
 iterator **insert** (const\_iterator \_\_position, size\_type \_\_n, const \_Tp &\_\_x)\
 void **merge** (list &&\_\_x)\
 template\<class \_Compare\> void **merge** (list &&\_\_x, \_Compare \_\_comp)\
 void **merge** (list &\_\_x)\
 template\<typename \_Compare\> void **merge** (list &\_\_x, \_Compare \_\_comp)\
 list & **operator=** (const list &)=default\
 list & **operator=** (**initializer\_list**\< value\_type \> \_\_l)\
 list & **operator=** (list &&)=default\
 void **pop\_back** () noexcept\
 void **pop\_front** () noexcept\
 const\_reverse\_iterator **rbegin** () const noexcept\
 reverse\_iterator **rbegin** () noexcept\
 \_\_remove\_return\_type **remove** (const \_Tp &\_\_value)\
 template\<class \_Predicate\> \_\_remove\_return\_type **remove\_if** (\_Predicate \_\_pred)\
 const\_reverse\_iterator **rend** () const noexcept\
 reverse\_iterator **rend** () noexcept\
 void **resize** (size\_type \_\_sz)\
 void **resize** (size\_type \_\_sz, const \_Tp &\_\_c)\
 void **sort** ()\
 template\<typename \_StrictWeakOrdering\> void **sort** (\_StrictWeakOrdering \_\_pred)\
 void **splice** (const\_iterator \_\_position, list &&\_\_x) noexcept\
 void **splice** (const\_iterator \_\_position, list &&\_\_x, const\_iterator \_\_first, const\_iterator \_\_last) noexcept\
 void **splice** (const\_iterator \_\_position, list &&\_\_x, const\_iterator \_\_i) noexcept\
 void **splice** (const\_iterator \_\_position, list &\_\_x) noexcept\
 void **splice** (const\_iterator \_\_position, list &\_\_x, const\_iterator \_\_first, const\_iterator \_\_last) noexcept\
 void **splice** (const\_iterator \_\_position, list &\_\_x, const\_iterator \_\_i) noexcept\
 void **swap** (list &\_\_x) noexcept(/\***conditional** \*/)\
 \_\_remove\_return\_type **unique** ()\
 template\<class \_BinaryPredicate\> \_\_remove\_return\_type **unique** (\_BinaryPredicate \_\_binary\_pred)\

### Protected Member Functions

constexpr void **\_M\_swap** (const \_Safe\_container &\_\_x) const noexcept\

### Friends

template\<typename \_ItT, typename \_SeqT, typename \_CatT\> class **::\_\_gnu\_debug::\_Safe\_iterator**\

## Detailed Description

### template\<typename \_Tp, typename \_Allocator = std::allocator\<\_Tp\>\>

class std::\_\_debug::list\< \_Tp, \_Allocator \>"Class std::list with safety/checking/debug instrumentation.

## Author

Generated automatically by Doxygen for libstdc++ from the source code.