std::formatter<std::stack>

From cppreference.com

Compiler support
Freestanding and hosted
Language
Standard library
Standard library headers
Named requirements
Feature test macros(C++20)
Language support library
Concepts library(C++20)
Diagnostics library
Memory management library
Metaprogramming library(C++11)
General utilities library
Containers library
Iterators library
Ranges library(C++20)
Algorithms library
Strings library
Text processing library
Numerics library
Date and time library
Input/output library
Filesystem library(C++17)
Concurrency support library(C++11)
Execution control library(C++26)
Technical specifications
Symbols index
External libraries

[edit]

Containers library

node-handle (C++17)
Sequence
array (C++11)
vector
vector<bool>
inplace_vector (C++26)
hive (C++26)
deque
forward_list (C++11)
list
Associative
set
multiset
map
multimap
Unordered associative
unordered_set (C++11)
unordered_multiset (C++11)
unordered_map (C++11)
unordered_multimap (C++11)
Adaptors
stack
queue
priority_queue
flat_set (C++23)
flat_multiset (C++23)
flat_map (C++23)
flat_multimap (C++23)
Views
span (C++20)
mdspan (C++23)
Tables
Iterator invalidation
Member function table
Non-member function table

[edit]

std::stack

Member functions
stack::stack
stack::~stack
stack::operator=
Element access
stack::top
Capacity
stack::empty
stack::size
Modifiers
stack::push
stack::push_range (C++23)
stack::emplace (C++11)
stack::pop
stack::swap (C++11)
Non-member functions
swap(std::stack) (C++11)
operator==operator!=operator<operator>operator<=operator>=operator<=> (C++20)
Helper classes
uses_allocator<std::stack> (C++11)
formatter<std::stack> (C++23)
Deduction guides(C++17)

[edit]

Defined in header`<stack>`
template<class CharT,class T,std::formattable<CharT> Container,class...U> struct formatter<std::stack<T, Container, U...>, CharT>;		(since C++23)

The template specialization ofstd::formatter for the container adaptor typestd::stack allows users to convert the underlying container to its textual representation as a collection of elements usingformatting functions.

The specialization is enabled ifstd::formattable<Container, CharT> istrue.

[edit]Member types

Name	Definition
`maybe-const-container`	`fmt-maybe-const` <Container, CharT> (exposition-only member type*)
`maybe-const-adaptor`	`maybe-const` < std::is_const_v<`maybe-const-container`>, std::stack<T, Container, U...>> (exposition-only member type*)

[edit]Data members

Name	Definition
`underlying_`	underlying formatter of typestd::formatter<ranges::ref_view<`maybe-const-container`>, CharT> (exposition-only member object*)

[edit]Member functions

parse	parses the format specifier as specified byrange-format-spec (public member function)
format	writes the range formatted output as specified byrange-format-spec (public member function)

std::formatter<std::stack>::parse

template<class ParseContext> constexprauto parse( ParseContext& ctx)-> ParseContext::iterator;

Equivalent toreturn underlying_ .parse(ctx);.

Return value

An iterator past the end of therange-format-spec of the underlying container.

std::formatter<std::stack>::format

template<class FormatContext> auto format(/maybe-const-adaptor/& r, FormatContext& ctx)const -> FormatContext::iterator;

Equivalent toreturn underlying_ .format(r.c, ctx);.

Return value

An iterator past the end of the output range.

[edit]Example

This section is incomplete
Reason: no example

[edit]See also

formatter (C++20)	defines formatting rules for a given type (class template)[edit]
range_formatter (C++23)	class template that helps implementingstd::formatter specializations for range types (class template)[edit]