dynamic_format_arg_store< Context > Class Template Reference

\rst A dynamic version of fmt::format_arg_store. More...

#include </home/runner/work/allwpilib/allwpilib/wpiutil/src/main/native/thirdparty/fmtlib/include/fmt/args.h>

Public Member Functions
constexpr	dynamic_format_arg_store ()=default
template<typename T >
void	push_back (const T &arg)
	\rst Adds an argument into the dynamic store for later passing to a formatting function. More...
template<typename T >
void	push_back (std::reference_wrapper< T > arg)
template<typename T >
void	push_back (const detail::named_arg< char_type, T > &arg)
	Adds named argument into the dynamic store for later passing to a formatting function. More...
void	clear ()
	Erase all elements from the store. More...
void	reserve (size_t new_cap, size_t new_cap_named)
	\rst Reserves space to store at least new_cap arguments including new_cap_named* named arguments. More...

Friends
class	basic_format_args< Context >

Detailed Description

template<typename Context>
class dynamic_format_arg_store< Context >

\rst A dynamic version of fmt::format_arg_store.

It's equipped with a storage to potentially temporary objects which lifetimes could be shorter than the format arguments object.

It can be implicitly converted into ~fmtbasic_format_args for passing into type-erased formatting functions such as ~fmtvformat. \endrst

Constructor & Destructor Documentation

dynamic_format_arg_store()

template<typename Context >

constexpr dynamic_format_arg_store< Context >::dynamic_format_arg_store ( )

constexprdefault

Member Function Documentation

clear()

template<typename Context >

void dynamic_format_arg_store< Context >::clear ( )

inline

Erase all elements from the store.

push_back() [1/3]

template<typename Context >

template<typename T >

void dynamic_format_arg_store< Context >::push_back ( const detail::named_arg< char_type, T > &  arg )

inline

Adds named argument into the dynamic store for later passing to a formatting function.

std::reference_wrapper is supported to avoid copying of the argument. The name is always copied into the store.

push_back() [2/3]

template<typename Context >

template<typename T >

void dynamic_format_arg_store< Context >::push_back ( const T &  arg )

inline

\rst Adds an argument into the dynamic store for later passing to a formatting function.

Note that custom types and string types (but not string views) are copied into the store dynamically allocating memory if necessary.

Example**::

fmt::dynamic_format_arg_store<fmt::format_context> store; store.push_back(42); store.push_back("abc"); store.push_back(1.5f); std::string result = fmt::vformat("{} and {} and {}", store); \endrst

push_back() [3/3]

template<typename Context >

template<typename T >

void dynamic_format_arg_store< Context >::push_back ( std::reference_wrapper< T >  arg )

inline

\rst
Adds a reference to the argument into the dynamic store for later passing to
a formatting function.

  Example**::

  fmt::dynamic_format_arg_store<fmt::format_context> store;
  char band[] = "Rolling Stones";
  store.push_back(std::cref(band));
  band[9] = 'c'; // Changing str affects the output.
  std::string result = fmt::vformat("{}", store);

result == "Rolling Scones" \endrst

reserve()

template<typename Context >

void dynamic_format_arg_store< Context >::reserve ( size_t  new_cap, size_t  new_cap_named  )

inline

\rst Reserves space to store at least new_cap arguments including new_cap_named* named arguments.

\endrst

Friends And Related Function Documentation

basic_format_args< Context >

template<typename Context >

friend class basic_format_args< Context >

friend

---

The documentation for this class was generated from the following file:

• /home/runner/work/allwpilib/allwpilib/wpiutil/src/main/native/thirdparty/fmtlib/include/fmt/args.h