Array class. More...
Public Types | |
typedef T | value_type |
The type of each element. More... | |
typedef T & | reference |
Type for a reference to an element. More... | |
typedef T const & | const_reference |
Type for a constant reference to an element. More... | |
typedef _ptr_array_iterator< T const > | const_iterator |
Type for a iterator for this container. More... | |
typedef _ptr_array_iterator< T > | iterator |
Type for a constant iterator for this container. More... | |
typedef T * | pointer |
Type for a pointer to an element. More... | |
typedef T const * | const_pointer |
Type for a constant pointer for an element. More... | |
typedef std::size_t | size_type |
Type for size information used in the array. More... | |
typedef std::ptrdiff_t | difference_type |
Type to represent the distance between two iterators. More... | |
typedef CloneAllocator | clone_allocator_type |
typedef std::reverse_iterator< iterator > | reverse_iterator |
Type for the clone allocator. More... | |
typedef std::reverse_iterator< const_iterator > | const_reverse_iterator |
Type for reverse iterator for this container. More... | |
typedef std::unique_ptr< value_type, clone_allocator_deleter< clone_allocator_type > > | _unique_ptr |
typedef Eina_Array * | native_handle_type |
Public Member Functions | |
ptr_array () | |
Default constructor. More... | |
ptr_array (Eina_Array *handle) | |
ptr_array (clone_allocator_type alloc) | |
ptr_array (size_type n, const_reference t) | |
Construct an array object with n copies of t . More... | |
template<typename InputIterator > | |
ptr_array (InputIterator i, InputIterator const &j, clone_allocator_type const &alloc=clone_allocator_type(), typename eina::enable_if<!eina::is_integral< InputIterator >::value >::type *=0) | |
Create an array with elements from the given range. More... | |
ptr_array (ptr_array< T, CloneAllocator > const &other) | |
Copy constructor. More... | |
ptr_array (ptr_array< T, CloneAllocator > &&other) | |
template<typename CloneAllocator1 > | |
ptr_array (ptr_array< T, CloneAllocator1 >const &other) | |
Creates a copy of a ptr_array with a different clone allocator. More... | |
~ptr_array () | |
Destructor. More... | |
ptr_array< T, CloneAllocator > & | operator= (ptr_array< T, CloneAllocator >const &other) |
Replace the current content with the content of another array. More... | |
ptr_array< T, CloneAllocator > & | operator= (ptr_array< T, CloneAllocator > &&other) |
void | clear () |
Remove all the elements of the array. | |
std::size_t | size () const |
Get the current size of the array. More... | |
bool | empty () const |
Check if the array is empty. More... | |
clone_allocator_type | get_clone_allocator () const |
Get the clone allocator of the array. More... | |
void | push_back (const_reference a) |
Add a copy of the given element at the end of the array. More... | |
void | push_back (pointer p) |
Add the object pointed by p as a element at the end of the array. More... | |
template<typename Deleter > | |
void | push_back (std::unique_ptr< T, Deleter > &p) |
Add the object pointed by p as a element at the end of the array. More... | |
void | pop_back () |
Remove the last element of the array. | |
iterator | insert (iterator i, value_type const &t) |
Insert a copy of the given element at the given position. More... | |
iterator | insert (iterator i, pointer pv) |
Insert the object pointed by pv as a element at the given position. More... | |
template<typename Deleter > | |
iterator | insert (iterator i, std::unique_ptr< value_type, Deleter > &p) |
Insert the object pointed by p as a element at the given position. More... | |
iterator | insert (iterator i, size_t n, value_type const &t) |
Insert n copies of t at the given position. More... | |
iterator | insert (iterator i, size_t n, pointer p) |
Insert the object pointed by p and n-1 copies of it as elements at the given position. More... | |
template<typename InputIterator > | |
iterator | insert (iterator p, InputIterator i, InputIterator j, typename eina::enable_if<!eina::is_integral< InputIterator >::value >::type *=0) |
Insert the elements between the given range at the given position. More... | |
iterator | erase (iterator q) |
Remove the element at the given position. More... | |
iterator | erase (iterator i, iterator j) |
Remove the elements between the given range. More... | |
template<typename InputIterator > | |
void | assign (InputIterator i, InputIterator j, typename eina::enable_if<!eina::is_integral< InputIterator >::value >::type *=0) |
Replace the content of the array by the elements in the given range. More... | |
void | assign (size_type n, value_type const &t) |
Replace the content of the array by n copies t . More... | |
value_type & | back () |
Get a reference to the last element. More... | |
value_type const & | back () const |
Get a constant reference to the last element. More... | |
value_type & | front () |
Get a reference to the first element. More... | |
value_type const & | front () const |
Get a constant reference to the first element. More... | |
const_reference | operator[] (size_type index) const |
Get a constant reference to the element at the given position. More... | |
reference | operator[] (size_type index) |
Get a reference to the element at the given position. More... | |
const_iterator | begin () const |
Get a constant iterator pointing to the first element of the array. More... | |
const_iterator | end () const |
Get a constant iterator to the position following the last element of the array. More... | |
iterator | begin () |
Get an iterator pointing to the first element of the array. More... | |
iterator | end () |
Get an iterator to the position following the last element of the array. More... | |
const_reverse_iterator | rbegin () const |
Get a constant reverse iterator pointing to the reverse begin of the array. More... | |
const_reverse_iterator | rend () const |
Get a constant reverse iterator pointing to the reverse end of the array. More... | |
reverse_iterator | rbegin () |
Get a reverse iterator pointing to the reverse begin of the array. More... | |
reverse_iterator | rend () |
Get a reverse iterator pointing to the reverse end of the array. More... | |
const_iterator | cbegin () const |
Get a constant iterator pointing to the first element of the array. More... | |
const_iterator | cend () const |
Get a constant iterator to the position following the last element of the array. More... | |
const_reverse_iterator | crbegin () const |
Get a constant reverse iterator pointing to the reverse begin of the array. More... | |
const_reverse_iterator | crend () const |
Get a constant reverse iterator pointing to the reverse end of the array. More... | |
eina::iterator< T > | ibegin () |
Get an eina::iterator pointing to the first element of the array. More... | |
eina::iterator< T > | iend () |
Get an eina::iterator to the position following the last element of the array. More... | |
eina::iterator< T const > | ibegin () const |
Get a constant eina::iterator pointing to the first element of the array. More... | |
eina::iterator< T const > | iend () const |
Get an constant eina::iterator to the position following the last element of the array. More... | |
eina::iterator< T const > | cibegin () const |
Get an eina::iterator pointing to the first element of the array. More... | |
eina::iterator< T const > | ciend () const |
Get an constant eina::iterator to the position following the last element of the array. More... | |
void | swap (ptr_array< T, CloneAllocator > &other) |
Swap content between two arrays. More... | |
size_type | max_size () const |
Get the maximum number of elements ptr_array can hold. More... | |
Eina_Array * | release_native_handle () |
Eina_Array * | native_handle () |
Get a handle for the wrapped Eina_Array. More... | |
Eina_Array const * | native_handle () const |
Get a constant handle for the wrapped Eina_Array. More... | |
eina::accessor< T const > | accessor () const |
Get a constant eina::accessor for the array. More... | |
eina::accessor< T > | accessor () |
Get a eina::accessor for the array. More... | |
Additional Inherited Members | |
![]() | |
typedef CloneAllocator | clone_allocator_type |
Type for the clone allocator. More... | |
![]() | |
_ptr_array_common_base (CloneAllocator clone_allocator) | |
Creates an array with the given clone allocator. | |
_ptr_array_common_base (Eina_Array *_array) | |
Create a new object from a handle to a native Eina_Array. More... | |
_ptr_array_common_base () | |
Default constructor. More... | |
CloneAllocator & | _get_clone_allocator () |
CloneAllocator const & | _get_clone_allocator () const |
void | _delete_clone (T const *p) |
T * | _new_clone (typename container_value_type< T >::type const &a) |
![]() | |
_ptr_array_impl | _impl |
Array class.
It provides an OOP interface to the Eina_Array
functions, and automatically take care of allocating and deallocating resources using the RAII programming idiom.
It also provides additional member functions to facilitate the access to the array content, much like a STL vector.
typedef T efl::eina::ptr_array< T, CloneAllocator >::value_type |
The type of each element.
typedef T& efl::eina::ptr_array< T, CloneAllocator >::reference |
Type for a reference to an element.
typedef T const& efl::eina::ptr_array< T, CloneAllocator >::const_reference |
Type for a constant reference to an element.
typedef _ptr_array_iterator<T const> efl::eina::ptr_array< T, CloneAllocator >::const_iterator |
Type for a iterator for this container.
typedef _ptr_array_iterator<T> efl::eina::ptr_array< T, CloneAllocator >::iterator |
Type for a constant iterator for this container.
typedef T* efl::eina::ptr_array< T, CloneAllocator >::pointer |
Type for a pointer to an element.
typedef T const* efl::eina::ptr_array< T, CloneAllocator >::const_pointer |
Type for a constant pointer for an element.
typedef std::size_t efl::eina::ptr_array< T, CloneAllocator >::size_type |
Type for size information used in the array.
typedef std::ptrdiff_t efl::eina::ptr_array< T, CloneAllocator >::difference_type |
Type to represent the distance between two iterators.
typedef std::reverse_iterator<iterator> efl::eina::ptr_array< T, CloneAllocator >::reverse_iterator |
Type for the clone allocator.
Type for reverse iterator for this container.
typedef std::reverse_iterator<const_iterator> efl::eina::ptr_array< T, CloneAllocator >::const_reverse_iterator |
Type for reverse iterator for this container.
|
inline |
Default constructor.
Create an empty array.
This constructor creates a ptr_array
object with no elements.
|
inline |
Construct an array object with n
copies of t
.
n | Number of elements. |
t | Value to be copied to each element. |
This constructor creates a ptr_array
with n
elements, each one as a copy of t
.
|
inline |
Create an array with elements from the given range.
i | Iterator to the initial position. The element pointed by this iterator will be copied. |
j | Iterator to the final position. The element pointed by this iterator will NOT be copied. |
alloc | Clone allocator to be used. |
This constructor creates a ptr_array
with copies of the elements between i
and j
in the same order.
j
) is not copied.
|
inline |
|
inline |
|
inline |
Destructor.
Release all allocated elements.
|
inline |
Replace the current content with the content of another array.
other | Another ptr_array of the same type. |
This assignment operator replaces the content of the array by a copy of the content of other
. The array size is adjusted accordingly and the newly copied elements keep their original order.
|
inline |
Get the current size of the array.
This member function returns the current number of elements inside the array.
Referenced by efl::eina::ptr_array< Eo, std::conditional< std::is_same< CloneAllocator, default_clone_allocator_placeholder >::value, eo_clone_allocator, CloneAllocator >::type >::empty(), efl::eina::ptr_array< Eo, std::conditional< std::is_same< CloneAllocator, default_clone_allocator_placeholder >::value, eo_clone_allocator, CloneAllocator >::type >::erase(), efl::eina::ptr_array< Eo, std::conditional< std::is_same< CloneAllocator, default_clone_allocator_placeholder >::value, eo_clone_allocator, CloneAllocator >::type >::insert(), and efl::eina::operator==().
|
inline |
Check if the array is empty.
true
if the array is empty, false
otherwise.This member function returns true
if the array does not contain any elements, otherwise it returns false
.
|
inline |
Get the clone allocator of the array.
|
inline |
Add a copy of the given element at the end of the array.
a | Element to be added at the end of the array. |
This member function allocates a new element, as a copy of a
, and inserts it at the end of the array.
Referenced by efl::eina::ptr_array< Eo, std::conditional< std::is_same< CloneAllocator, default_clone_allocator_placeholder >::value, eo_clone_allocator, CloneAllocator >::type >::ptr_array(), and efl::eina::ptr_array< Eo, std::conditional< std::is_same< CloneAllocator, default_clone_allocator_placeholder >::value, eo_clone_allocator, CloneAllocator >::type >::push_back().
|
inline |
Add the object pointed by p
as a element at the end of the array.
p | Pointer to a pre-allocated element to be inserted at the end of the array. |
This member function adds the object pointed by p
as a element at the end of the array. The array gains ownership of the pointer and nothing is copied.
|
inline |
Add the object pointed by p
as a element at the end of the array.
p | Reference to a unique_ptr pointing to a element to be inserted at the end of the array. |
This member function adds the object pointed by the given unique_ptr
as a element at the end of the array. The object ownership is transferred to the array and nothing is copied.
unique_ptr
and will release it upon element destruction.
|
inline |
Insert a copy of the given element at the given position.
i | Iterator pointing to the position where the new element will be inserted. |
t | Value to be copied to the new element. |
This member function inserts a copy of the element t
at the position i
. The new element comes right before the element originally pointed by i
.
At the end, a valid iterator pointing to the element just inserted is returned.
Referenced by efl::eina::ptr_array< Eo, std::conditional< std::is_same< CloneAllocator, default_clone_allocator_placeholder >::value, eo_clone_allocator, CloneAllocator >::type >::assign(), efl::eina::ptr_array< Eo, std::conditional< std::is_same< CloneAllocator, default_clone_allocator_placeholder >::value, eo_clone_allocator, CloneAllocator >::type >::insert(), efl::eina::ptr_array< Eo, std::conditional< std::is_same< CloneAllocator, default_clone_allocator_placeholder >::value, eo_clone_allocator, CloneAllocator >::type >::operator=(), and efl::eina::ptr_array< Eo, std::conditional< std::is_same< CloneAllocator, default_clone_allocator_placeholder >::value, eo_clone_allocator, CloneAllocator >::type >::ptr_array().
|
inline |
Insert the object pointed by pv
as a element at the given position.
i | Iterator pointing to the position where the new element will be inserted. |
pv | Pointer to a pre-allocated object to be inserted to the array. |
This member function adds the object pointed by pv
as a element at the given position. The new element comes right before the element originally pointed by i
. The array gains ownership of the pointer and nothing is copied.
At the end, a valid iterator pointing to the element just inserted is returned.
|
inline |
Insert the object pointed by p
as a element at the given position.
i | Iterator pointing to the position where the new element will be inserted. |
p | Reference to a unique_ptr pointing to the element to be inserted in the array. |
This member function adds the object pointed by p
as a element at the given position. The new element comes right before the element originally pointed by i
. The object ownership is transferred to the array and nothing is copied.
At the end, a valid iterator pointing to the element just inserted is returned.
unique_ptr
and will release it upon element destruction.
|
inline |
Insert n
copies of t
at the given position.
i | Iterator pointing to the position where the new elements will be inserted. |
n | Number of elements to be inserted. |
t | Value to be copied to each new inserted element. |
This member function inserts n
new elements at position i
in the array, each one as a copy of t
. The new elements come right before the element originally pointed by i
.
At the end, a valid iterator pointing to the first element inserted is returned.
|
inline |
Insert the object pointed by p
and n-1
copies of it as elements at the given position.
i | Iterator pointing to the position where the new elements will be inserted. |
n | Number of elements to be inserted. |
p | Pointer to a pre-allocated object to be inserted in the array. |
This member function inserts the object pointed by p
and n-1
copies of it as elements at the given position. The new elements come right before the element originally pointed by i
.
At the end, a valid iterator pointing to the first element inserted is returned.
|
inline |
Insert the elements between the given range at the given position.
p | Iterator pointing to the position where the new elements will be inserted. |
i | Iterator to the initial position. The element pointed by this iterator will be copied. |
j | Iterator to the final position. The element pointed by this iterator will NOT be copied. |
This member function inserts a copy of the elements between i
and j
at the position p
. The new elements come right before the element originally pointed by p
. Note that the element pointed by j
is not copied.
At the end, a valid iterator pointing to the first element inserted is returned.
|
inline |
Remove the element at the given position.
q | Iterator pointing to the element to be removed. |
This member function removes the element pointed by the iterator q
, reducing the array size by one. At the end, a valid iterator pointing to the element right after the removed one is returned.
|
inline |
Remove the elements between the given range.
i | Iterator pointing to the starting position to be removed. |
j | Iterator pointing to the ending position to be removed. The element pointed by this iterator is not removed. |
j
).This member function removes the elements between the iterators i
and j
, including the element pointed by i
but not the element pointed by .
|
inline |
Replace the content of the array by the elements in the given range.
i | Iterator pointing to the beginning of the elements to be copied. |
j | Iterator pointing to the end of the elements to be copied. Note that the element pointed by j will NOT be copied. |
This member function replaces the current elements by copies of the elements between the iterators i
and j
, including the element pointed by i
but not the one pointed by j
. The size of the array is adjusted accordingly and the newly copied elements remain in their original order.
|
inline |
Replace the content of the array by n
copies t
.
n | Number of elements. |
t | Value to be copied to each element. |
|
inline |
Get a reference to the last element.
|
inline |
Get a constant reference to the last element.
Version of back() for const-qualified objects. Returns a constant reference instead.
|
inline |
Get a reference to the first element.
|
inline |
Get a constant reference to the first element.
Version of front() for const-qualified objects. Returns a constant reference instead.
|
inline |
Get a constant reference to the element at the given position.
index | Position of the element in the array. |
index
.Version of operator[](size_type index) for const-qualified objects. Returns a constant reference instead.
|
inline |
Get a reference to the element at the given position.
index | Position of the element in the array. |
index
.
|
inline |
Get a constant iterator pointing to the first element of the array.
Version of begin() for const-qualified objects. Returns a constant iterator instead.
Referenced by efl::eina::ptr_array< Eo, std::conditional< std::is_same< CloneAllocator, default_clone_allocator_placeholder >::value, eo_clone_allocator, CloneAllocator >::type >::clear(), efl::eina::ptr_array< Eo, std::conditional< std::is_same< CloneAllocator, default_clone_allocator_placeholder >::value, eo_clone_allocator, CloneAllocator >::type >::operator=(), efl::eina::operator==(), and efl::eina::ptr_array< Eo, std::conditional< std::is_same< CloneAllocator, default_clone_allocator_placeholder >::value, eo_clone_allocator, CloneAllocator >::type >::ptr_array().
|
inline |
Get a constant iterator to the position following the last element of the array.
Version of end() for const-qualified objects. Returns a constant iterator instead.
Referenced by efl::eina::ptr_array< Eo, std::conditional< std::is_same< CloneAllocator, default_clone_allocator_placeholder >::value, eo_clone_allocator, CloneAllocator >::type >::assign(), efl::eina::ptr_array< Eo, std::conditional< std::is_same< CloneAllocator, default_clone_allocator_placeholder >::value, eo_clone_allocator, CloneAllocator >::type >::clear(), efl::eina::ptr_array< Eo, std::conditional< std::is_same< CloneAllocator, default_clone_allocator_placeholder >::value, eo_clone_allocator, CloneAllocator >::type >::operator=(), efl::eina::operator==(), and efl::eina::ptr_array< Eo, std::conditional< std::is_same< CloneAllocator, default_clone_allocator_placeholder >::value, eo_clone_allocator, CloneAllocator >::type >::ptr_array().
|
inline |
Get an iterator pointing to the first element of the array.
This member function returns an iterator pointing to the first element of the array. If the array is empty the returned iterator is the same as the one returned by end().
|
inline |
Get an iterator to the position following the last element of the array.
This member function returns an iterator to the position following the last element in the array. If the array is empty the returned iterator is the same as the one returned by begin().
|
inline |
Get a constant reverse iterator pointing to the reverse begin of the array.
Version of rbegin() for const-qualified objects. Returns a constant reverse iterator instead.
|
inline |
Get a constant reverse iterator pointing to the reverse end of the array.
Version of rend() for const-qualified objects. Returns a constant reverse iterator instead.
|
inline |
Get a reverse iterator pointing to the reverse begin of the array.
This member function returns a reverse iterator pointing to the last element of the array. If the array is empty the returned reverse iterator is the same as the one returned by rend().
|
inline |
Get a reverse iterator pointing to the reverse end of the array.
This member function returns a reverse iterator pointing to the position before the first element of the array. If the array is empty the returned iterator is the same as the one returned by rbegin().
|
inline |
Get a constant iterator pointing to the first element of the array.
This member function works like begin() const but is granted to return a constant iterator even for arrays that are not const-qualified.
|
inline |
Get a constant iterator to the position following the last element of the array.
This member function works like end() const but is granted to return a constant iterator even for arrays that are not const-qualified.
|
inline |
Get a constant reverse iterator pointing to the reverse begin of the array.
This member function works like rbegin() const but is granted to return a constant reverse iterator even for arrays that are not const-qualified.
|
inline |
Get a constant reverse iterator pointing to the reverse end of the array.
This member function works like rend() const but is granted to return a constant reverse iterator even for arrays that are not const-qualified.
|
inline |
Get an eina::iterator
pointing to the first element of the array.
eina::iterator
to the initial position of the array.This member function returns an eina::iterator
pointing to the first element of the array. If the array is empty the returned iterator is the same as the one returned by iend().
|
inline |
Get an eina::iterator
to the position following the last element of the array.
eina::iterator
to the final position of the array.This member function returns an eina::iterator
to the position following the last element in the array. If the array is empty the returned iterator is the same as the one returned by ibegin().
|
inline |
Get a constant eina::iterator
pointing to the first element of the array.
eina::iterator
to the initial position of the array.Version of ibegin() for const-qualified objects. Returns a constant eina::iterator
instead.
|
inline |
Get an constant eina::iterator
to the position following the last element of the array.
eina::iterator
to the final position of the array.Version of iend() for const-qualified objects. Returns a constant eina::iterator
instead.
|
inline |
Get an eina::iterator
pointing to the first element of the array.
eina::iterator
to the initial position of the array.This member function works like ibegin() const but is granted to return a constant iterator even for arrays that are not const-qualified.
|
inline |
Get an constant eina::iterator
to the position following the last element of the array.
eina::iterator
to the final position of the array.This member function works like iend() const but is granted to return a constant iterator even for arrays that are not const-qualified.
|
inline |
Swap content between two arrays.
other | Other ptr_array of the same type. |
Referenced by efl::eina::swap().
|
inline |
|
inline |
Get a handle for the wrapped Eina_Array.
This member function returns the native Eina_Array handle that is wrapped inside this object.
|
inline |
Get a constant handle for the wrapped Eina_Array.
Version of native_handle() for const-qualified objects. Returns a constant handle instead.
|
inline |
Get a constant eina::accessor for the array.
eina::accessor
to the array.Version of accessor() to const-qualified ptrarray
s. Returns a const-qualified eina::accessor
instead.
|
inline |
Get a eina::accessor for the array.
eina::accessor
to the array.