#include <juce_HeapBlock.h>
Public Types | |
using | Type = ElementType |
Public Member Functions | |
HeapBlock ()=default | |
template<typename SizeType, std::enable_if_t< std::is_convertible_v< SizeType, int >, int > = 0> | |
HeapBlock (SizeType numElements) | |
template<typename SizeType, std::enable_if_t< std::is_convertible_v< SizeType, int >, int > = 0> | |
HeapBlock (SizeType numElements, bool initialiseToZero) | |
~HeapBlock () | |
HeapBlock (HeapBlock &&other) noexcept | |
HeapBlock & | operator= (HeapBlock &&other) noexcept |
template<class OtherElementType, bool otherThrowOnFailure, typename = AllowConversion<OtherElementType>> | |
HeapBlock (HeapBlock< OtherElementType, otherThrowOnFailure > &&other) noexcept | |
template<class OtherElementType, bool otherThrowOnFailure, typename = AllowConversion<OtherElementType>> | |
HeapBlock & | operator= (HeapBlock< OtherElementType, otherThrowOnFailure > &&other) noexcept |
operator ElementType * () const noexcept | |
ElementType * | get () const noexcept |
ElementType * | getData () const noexcept |
operator void * () const noexcept | |
operator const void * () const noexcept | |
ElementType * | operator-> () const noexcept |
template<typename IndexType> | |
ElementType & | operator[] (IndexType index) const noexcept |
template<typename IndexType> | |
ElementType * | operator+ (IndexType index) const noexcept |
bool | operator== (const ElementType *otherPointer) const noexcept |
bool | operator!= (const ElementType *otherPointer) const noexcept |
template<typename SizeType> | |
void | malloc (SizeType newNumElements, size_t elementSize=sizeof(ElementType)) |
template<typename SizeType> | |
void | calloc (SizeType newNumElements, const size_t elementSize=sizeof(ElementType)) |
template<typename SizeType> | |
void | allocate (SizeType newNumElements, bool initialiseToZero) |
template<typename SizeType> | |
void | realloc (SizeType newNumElements, size_t elementSize=sizeof(ElementType)) |
void | free () noexcept |
template<bool otherBlockThrows> | |
void | swapWith (HeapBlock< ElementType, otherBlockThrows > &other) noexcept |
template<typename SizeType> | |
void | clear (SizeType numElements) noexcept |
Very simple container class to hold a pointer to some data on the heap.
When you need to allocate some heap storage for something, always try to use this class instead of allocating the memory directly using malloc/free.
A HeapBlock<char> object can be treated in pretty much exactly the same way as an char*, but as long as you allocate it on the stack or as a class member, it's almost impossible for it to leak memory.
It also makes your code much more concise and readable than doing the same thing using direct allocations,
E.g. instead of this:
..you could just write this:
The class is extremely lightweight, containing only a pointer to the data, and exposes malloc/realloc/calloc/free methods that do the same jobs as their less object-oriented counterparts. Despite adding safety, you probably won't sacrifice any performance by using this in place of normal pointers.
The throwOnFailure template parameter can be set to true if you'd like the class to throw a std::bad_alloc exception when an allocation fails. If this is false, then a failed allocation will just leave the heapblock with a null pointer (assuming that the system's malloc() function doesn't throw).
Definition at line 86 of file juce_HeapBlock.h.
using juce::HeapBlock< ElementType, throwOnFailure >::Type = ElementType |
This typedef can be used to get the type of the heapblock's elements.
Definition at line 317 of file juce_HeapBlock.h.
|
default |
|
inlineexplicit |
Creates a HeapBlock containing a number of elements.
The contents of the block are undefined, as it will have been created by a malloc call.
If you want an array of zero values, you can use the calloc() method or the other constructor that takes an InitialisationState parameter.
Definition at line 111 of file juce_HeapBlock.h.
|
inline |
Creates a HeapBlock containing a number of elements.
The initialiseToZero parameter determines whether the new memory should be cleared, or left uninitialised.
Definition at line 122 of file juce_HeapBlock.h.
|
inline |
Destructor. This will free the data, if any has been allocated.
Definition at line 131 of file juce_HeapBlock.h.
|
inlinenoexcept |
Move constructor
Definition at line 137 of file juce_HeapBlock.h.
|
inlinenoexcept |
Converting move constructor. Only enabled if this is a HeapBlock<Base*> and the other object is a HeapBlock<Derived*>, where std::is_base_of_v<Base, Derived> == true.
Definition at line 155 of file juce_HeapBlock.h.
|
inline |
Allocates a specified amount of memory and optionally clears it. This does the same job as either malloc() or calloc(), depending on the initialiseToZero parameter.
Definition at line 270 of file juce_HeapBlock.h.
Referenced by juce::AudioBuffer< float >::setSize().
|
inline |
Allocates a specified amount of memory and clears it. This does the same job as the malloc() method, but clears the memory that it allocates.
Definition at line 259 of file juce_HeapBlock.h.
Referenced by juce::SystemStats::getStackBacktrace().
|
inlinenoexcept |
This fills the block with zeros, up to the number of elements specified. Since the block has no way of knowing its own size, you must make sure that the number of elements you specify doesn't exceed the allocated size.
Definition at line 311 of file juce_HeapBlock.h.
|
inlinenoexcept |
Frees any currently-allocated data. This will free the data and reset this object to be a null pointer.
Definition at line 291 of file juce_HeapBlock.h.
Referenced by juce::HeapBlock< char, true >::operator=().
|
inlinenoexcept |
Returns a raw pointer to the allocated data. This may be a null pointer if the data hasn't yet been allocated, or if it has been freed by calling the free() method.
Definition at line 185 of file juce_HeapBlock.h.
Referenced by juce::AudioFormatReader::searchForLevel(), and juce::AudioBuffer< float >::setSize().
|
inlinenoexcept |
Returns a raw pointer to the allocated data. This may be a null pointer if the data hasn't yet been allocated, or if it has been freed by calling the free() method.
Definition at line 191 of file juce_HeapBlock.h.
|
inline |
Allocates a specified amount of memory.
This uses the normal malloc to allocate an amount of memory for this object. Any previously allocated memory will be freed by this method.
The number of bytes allocated will be (newNumElements * elementSize). Normally you wouldn't need to specify the second parameter, but it can be handy if you need to allocate a size in bytes rather than in terms of the number of elements.
The data that is allocated will be freed when this object is deleted, or when you call free() or any of the allocation methods.
Definition at line 249 of file juce_HeapBlock.h.
|
inlinenoexcept |
Returns a void pointer to the allocated data. This may be a null pointer if the data hasn't yet been allocated, or if it has been freed by calling the free() method.
Definition at line 203 of file juce_HeapBlock.h.
|
inlinenoexcept |
Returns a raw pointer to the allocated data. This may be a null pointer if the data hasn't yet been allocated, or if it has been freed by calling the free() method.
Definition at line 179 of file juce_HeapBlock.h.
|
inlinenoexcept |
Returns a void pointer to the allocated data. This may be a null pointer if the data hasn't yet been allocated, or if it has been freed by calling the free() method.
Definition at line 197 of file juce_HeapBlock.h.
|
inlinenoexcept |
Compares the pointer with another pointer. This can be handy for checking whether this is a null pointer.
Definition at line 233 of file juce_HeapBlock.h.
|
inlinenoexcept |
Returns a pointer to a data element at an offset from the start of the array. This is the same as doing pointer arithmetic on the raw pointer itself.
Definition at line 222 of file juce_HeapBlock.h.
|
inlinenoexcept |
Lets you use indirect calls to the first element in the array. Obviously this will cause problems if the array hasn't been initialised, because it'll be referencing a null pointer.
Definition at line 209 of file juce_HeapBlock.h.
|
inlinenoexcept |
Move assignment operator
Definition at line 144 of file juce_HeapBlock.h.
|
inlinenoexcept |
Converting move assignment operator. Only enabled if this is a HeapBlock<Base*> and the other object is a HeapBlock<Derived*>, where std::is_base_of_v<Base, Derived> == true.
Definition at line 166 of file juce_HeapBlock.h.
|
inlinenoexcept |
Compares the pointer with another pointer. This can be handy for checking whether this is a null pointer.
Definition at line 228 of file juce_HeapBlock.h.
|
inlinenoexcept |
Returns a reference to one of the data elements. Obviously there's no bounds-checking here, as this object is just a dumb pointer and has no idea of the size it currently has allocated.
Definition at line 216 of file juce_HeapBlock.h.
|
inline |
Re-allocates a specified amount of memory.
The semantics of this method are the same as malloc() and calloc(), but it uses realloc() to keep as much of the existing data as possible.
Definition at line 283 of file juce_HeapBlock.h.
|
inlinenoexcept |
Swaps this object's data with the data of another HeapBlock. The two objects simply exchange their data pointers.
Definition at line 301 of file juce_HeapBlock.h.