esphome::RAMAllocator< T > Class Template Reference

An STL allocator that uses SPI or internal RAM. More...

#include <helpers.h>

Public Types
enum	Flags { NONE = 0 , ALLOC_EXTERNAL = 1 << 0 , ALLOC_INTERNAL = 1 << 1 , ALLOW_FAILURE = 1 << 2 }
using	value_type = T

Public Member Functions
	RAMAllocator ()=default
	RAMAllocator (uint8_t flags)
template<class U >
constexpr	RAMAllocator (const RAMAllocator< U > &other)
T *	allocate (size_t n)
T *	allocate (size_t n, size_t manual_size)
T *	reallocate (T *p, size_t n)
T *	reallocate (T *p, size_t n, size_t manual_size)
void	deallocate (T *p, size_t n)
size_t	get_free_heap_size () const
	Return the total heap space available via this allocator.
size_t	get_max_free_block_size () const
	Return the maximum size block this allocator could allocate.

Detailed Description

template<class T>
class esphome::RAMAllocator< T >

An STL allocator that uses SPI or internal RAM.

Returns nullptr in case no memory is available.

By setting flags, it can be configured to:

• perform external allocation falling back to main memory if SPI RAM is full or unavailable
• perform external allocation only
• perform internal allocation only

Definition at line 1067 of file helpers.h.

Member Typedef Documentation

value_type

template<class T >

using esphome::RAMAllocator< T >::value_type = T

Definition at line 1069 of file helpers.h.

Member Enumeration Documentation

Flags

template<class T >

enum esphome::RAMAllocator::Flags

Enumerator
NONE
ALLOC_EXTERNAL
ALLOC_INTERNAL
ALLOW_FAILURE

Definition at line 1071 of file helpers.h.

Constructor & Destructor Documentation

RAMAllocator() [1/3]

template<class T >

esphome::RAMAllocator< T >::RAMAllocator ( )

default

RAMAllocator() [2/3]

template<class T >

esphome::RAMAllocator< T >::RAMAllocator ( uint8_t flags )

inline

Definition at line 1079 of file helpers.h.

RAMAllocator() [3/3]

template<class T >

template<class U >

esphome::RAMAllocator< T >::RAMAllocator ( const RAMAllocator< U > & other )

inlineconstexpr

Definition at line 1085 of file helpers.h.

Member Function Documentation

allocate() [1/2]

template<class T >

T * esphome::RAMAllocator< T >::allocate ( size_t n )

inline

Definition at line 1087 of file helpers.h.

allocate() [2/2]

template<class T >

T * esphome::RAMAllocator< T >::allocate ( size_t n, size_t manual_size )

inline

Definition at line 1089 of file helpers.h.

deallocate()

template<class T >

void esphome::RAMAllocator< T >::deallocate ( T * p, size_t n )

inline

Definition at line 1125 of file helpers.h.

get_free_heap_size()

template<class T >

size_t esphome::RAMAllocator< T >::get_free_heap_size ( ) const

inline

Return the total heap space available via this allocator.

Definition at line 1132 of file helpers.h.

get_max_free_block_size()

template<class T >

size_t esphome::RAMAllocator< T >::get_max_free_block_size ( ) const

inline

Return the maximum size block this allocator could allocate.

This may be an approximation on some platforms

Definition at line 1153 of file helpers.h.

reallocate() [1/2]

template<class T >

T * esphome::RAMAllocator< T >::reallocate ( T * p, size_t n )

inline

Definition at line 1106 of file helpers.h.

reallocate() [2/2]

template<class T >

T * esphome::RAMAllocator< T >::reallocate ( T * p, size_t n, size_t manual_size )

inline

Definition at line 1108 of file helpers.h.

---

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

• esphome/core/helpers.h