---
name: "std::__debug::list"
section: "3cxx"
platform: "linux"
package: "libstdc++-12-doc"
version: "12.4.0-5"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/std::__debug::list/3cxx"
---

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

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 \>**, and list\< \_Tp, std::allocator\< \_Tp \> \>.

### 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

**void** **\_M\_swap** (\_Safe\_container &\_\_x) 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.