basic_memory_buffer< T, SIZE, Allocator > Class Template Reference

#include <format.h>

Inheritance diagram for basic_memory_buffer< T, SIZE, Allocator >:

Public Types
using	const_reference = const T &
using	value_type = T
Public Types inherited from detail::buffer< T >
using	const_reference = const T &
using	value_type = T

Public Member Functions
template<typename ContiguousRange >
void	append (const ContiguousRange &range)
	basic_memory_buffer (const Allocator &alloc=Allocator())
	basic_memory_buffer (basic_memory_buffer &&other) FMT_NOEXCEPT
Allocator	get_allocator () const
basic_memory_buffer &	operator= (basic_memory_buffer &&other) FMT_NOEXCEPT
void	reserve (size_t new_capacity)
void	resize (size_t count)
	~basic_memory_buffer ()
Public Member Functions inherited from detail::buffer< T >
template<typename U >
void	append (const U *begin, const U *end)
T *	begin () FMT_NOEXCEPT
const T *	begin () const FMT_NOEXCEPT
	buffer (const buffer &)=delete
size_t	capacity () const FMT_NOEXCEPT
void	clear ()
T *	data () FMT_NOEXCEPT
const T *	data () const FMT_NOEXCEPT
T *	end () FMT_NOEXCEPT
const T *	end () const FMT_NOEXCEPT
void	operator= (const buffer &)=delete
template<typename I >
T &	operator[] (I index)
template<typename I >
const T &	operator[] (I index) const
void	push_back (const T &value)
size_t	size () const FMT_NOEXCEPT
void	try_reserve (size_t new_capacity)
void	try_resize (size_t count)

Protected Member Functions
void	grow (size_t size) final FMT_OVERRIDE
Protected Member Functions inherited from detail::buffer< T >
	buffer (size_t sz) FMT_NOEXCEPT
	buffer (T *p=nullptr, size_t sz=0, size_t cap=0) FMT_NOEXCEPT
void	set (T *buf_data, size_t buf_capacity) FMT_NOEXCEPT
	~buffer ()=default

Private Member Functions
void	deallocate ()
void	move (basic_memory_buffer &other)

Private Attributes
Allocator	alloc_
T	store_ [SIZE]

Detailed Description

template<typename T, size_t SIZE = inline_buffer_size, typename Allocator = std::allocator<T>>
class basic_memory_buffer< T, SIZE, Allocator >

A dynamically growing memory buffer for trivially copyable/constructible types with the first SIZE elements stored in the object itself.

You can use one of the following type aliases for common character types:

+-------------—+---------------------------—+ | Type | Definition | +================+==============================+ | memory_buffer | basic_memory_buffer<char> | +-------------—+---------------------------—+ | wmemory_buffer | basic_memory_buffer<wchar_t> | +-------------—+---------------------------—+

Example**::

fmt::memory_buffer out; format_to(out, "The answer is {}.", 42);

This will append the following output to the out object:

.. code-block:: none

The answer is 42.

The output can be converted to an std::string with to_string(out).

Definition at line 654 of file format.h.

Member Typedef Documentation

template<typename T, size_t SIZE = inline_buffer_size, typename Allocator = std::allocator<T>>

using basic_memory_buffer< T, SIZE, Allocator >::const_reference = const T&

Definition at line 672 of file format.h.

template<typename T, size_t SIZE = inline_buffer_size, typename Allocator = std::allocator<T>>

using basic_memory_buffer< T, SIZE, Allocator >::value_type = T

Definition at line 671 of file format.h.

Constructor & Destructor Documentation

template<typename T, size_t SIZE = inline_buffer_size, typename Allocator = std::allocator<T>>

basic_memory_buffer< T, SIZE, Allocator >::basic_memory_buffer ( const Allocator &  alloc = Allocator() )

inlineexplicit

Definition at line 674 of file format.h.

template<typename T, size_t SIZE = inline_buffer_size, typename Allocator = std::allocator<T>>

basic_memory_buffer< T, SIZE, Allocator >::~basic_memory_buffer ( )

inline

Definition at line 678 of file format.h.

template<typename T, size_t SIZE = inline_buffer_size, typename Allocator = std::allocator<T>>

basic_memory_buffer< T, SIZE, Allocator >::basic_memory_buffer ( basic_memory_buffer< T, SIZE, Allocator > &&  other )

inline

Constructs a :class:fmt::basic_memory_buffer object moving the content of the other object to it.

Definition at line 706 of file format.h.

Member Function Documentation

template<typename T, size_t SIZE = inline_buffer_size, typename Allocator = std::allocator<T>>

template<typename ContiguousRange >

void basic_memory_buffer< T, SIZE, Allocator >::append ( const ContiguousRange &  range )

inline

Definition at line 735 of file format.h.

template<typename T, size_t SIZE = inline_buffer_size, typename Allocator = std::allocator<T>>

void basic_memory_buffer< T, SIZE, Allocator >::deallocate ( )

inlineprivate

Definition at line 662 of file format.h.

template<typename T, size_t SIZE = inline_buffer_size, typename Allocator = std::allocator<T>>

Allocator basic_memory_buffer< T, SIZE, Allocator >::get_allocator ( ) const

inline

Definition at line 721 of file format.h.

template<typename T , size_t SIZE, typename Allocator >

void basic_memory_buffer< T, SIZE, Allocator >::grow ( size_t  capacity )

finalprotectedvirtual

Increases the buffer capacity to hold at least capacity elements.

Implements detail::buffer< T >.

Definition at line 741 of file format.h.

template<typename T, size_t SIZE = inline_buffer_size, typename Allocator = std::allocator<T>>

void basic_memory_buffer< T, SIZE, Allocator >::move ( basic_memory_buffer< T, SIZE, Allocator > &  other )

inlineprivate

Definition at line 682 of file format.h.

template<typename T, size_t SIZE = inline_buffer_size, typename Allocator = std::allocator<T>>

basic_memory_buffer& basic_memory_buffer< T, SIZE, Allocator >::operator= ( basic_memory_buffer< T, SIZE, Allocator > &&  other )

inline

Moves the content of the other basic_memory_buffer object to this one.

Definition at line 713 of file format.h.

template<typename T, size_t SIZE = inline_buffer_size, typename Allocator = std::allocator<T>>

void basic_memory_buffer< T, SIZE, Allocator >::reserve ( size_t  new_capacity )

inline

Increases the buffer capacity to new_capacity.

Definition at line 730 of file format.h.

template<typename T, size_t SIZE = inline_buffer_size, typename Allocator = std::allocator<T>>

void basic_memory_buffer< T, SIZE, Allocator >::resize ( size_t  count )

inline

Resizes the buffer to contain count elements. If T is a POD type new elements may not be initialized.

Definition at line 727 of file format.h.

Member Data Documentation

template<typename T, size_t SIZE = inline_buffer_size, typename Allocator = std::allocator<T>>

Allocator basic_memory_buffer< T, SIZE, Allocator >::alloc_

private

Definition at line 659 of file format.h.

template<typename T, size_t SIZE = inline_buffer_size, typename Allocator = std::allocator<T>>

T basic_memory_buffer< T, SIZE, Allocator >::store_[SIZE]

private

Definition at line 656 of file format.h.

---

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

• format.h