#include <stl_vector.h>
Inheritance diagram for _GLIBCXX_STD::vector< _Tp, _Alloc >:
Public Types | |
typedef _Tp | value_type |
typedef _Alloc::pointer | pointer |
typedef _Alloc::const_pointer | const_pointer |
typedef _Alloc::reference | reference |
typedef _Alloc::const_reference | const_reference |
typedef __gnu_cxx::__normal_iterator< pointer, vector_type > | iterator |
typedef __gnu_cxx::__normal_iterator< const_pointer, vector_type > | const_iterator |
typedef std::reverse_iterator< const_iterator > | const_reverse_iterator |
typedef std::reverse_iterator< iterator > | reverse_iterator |
typedef size_t | size_type |
typedef ptrdiff_t | difference_type |
typedef _Base::allocator_type | allocator_type |
Public Member Functions | |
vector (const allocator_type &__a=allocator_type()) | |
Default constructor creates no elements. | |
vector (size_type __n, const value_type &__value, const allocator_type &__a=allocator_type()) | |
Create a vector with copies of an exemplar element. | |
vector (size_type __n) | |
Create a vector with default elements. | |
vector (const vector &__x) | |
Vector copy constructor. | |
template<typename _InputIterator> | vector (_InputIterator __first, _InputIterator __last, const allocator_type &__a=allocator_type()) |
Builds a vector from a range. | |
~vector () | |
vector & | operator= (const vector &__x) |
Vector assignment operator. | |
void | assign (size_type __n, const value_type &__val) |
Assigns a given value to a vector. | |
template<typename _InputIterator> void | assign (_InputIterator __first, _InputIterator __last) |
Assigns a range to a vector. | |
iterator | begin () |
const_iterator | begin () const |
iterator | end () |
const_iterator | end () const |
reverse_iterator | rbegin () |
const_reverse_iterator | rbegin () const |
reverse_iterator | rend () |
const_reverse_iterator | rend () const |
size_type | size () const |
size_type | max_size () const |
void | resize (size_type __new_size, const value_type &__x) |
Resizes the vector to the specified number of elements. | |
void | resize (size_type __new_size) |
Resizes the vector to the specified number of elements. | |
size_type | capacity () const |
bool | empty () const |
void | reserve (size_type __n) |
Attempt to preallocate enough memory for specified number of elements. | |
reference | operator[] (size_type __n) |
Subscript access to the data contained in the vector. | |
const_reference | operator[] (size_type __n) const |
Subscript access to the data contained in the vector. | |
reference | at (size_type __n) |
Provides access to the data contained in the vector. | |
const_reference | at (size_type __n) const |
Provides access to the data contained in the vector. | |
reference | front () |
const_reference | front () const |
reference | back () |
const_reference | back () const |
void | push_back (const value_type &__x) |
Add data to the end of the vector. | |
void | pop_back () |
Removes last element. | |
iterator | insert (iterator __position, const value_type &__x) |
Inserts given value into vector before specified iterator. | |
void | insert (iterator __position, size_type __n, const value_type &__x) |
Inserts a number of copies of given data into the vector. | |
template<typename _InputIterator> void | insert (iterator __position, _InputIterator __first, _InputIterator __last) |
Inserts a range into the vector. | |
iterator | erase (iterator __position) |
Remove element at given position. | |
iterator | erase (iterator __first, iterator __last) |
Remove a range of elements. | |
void | swap (vector &__x) |
Swaps data with another vector. | |
void | clear () |
Protected Member Functions | |
void | _M_range_check (size_type __n) const |
template<typename _ForwardIterator> pointer | _M_allocate_and_copy (size_type __n, _ForwardIterator __first, _ForwardIterator __last) |
template<typename _Integer> void | _M_initialize_dispatch (_Integer __n, _Integer __value, __true_type) |
template<typename _InputIterator> void | _M_initialize_dispatch (_InputIterator __first, _InputIterator __last, __false_type) |
template<typename _InputIterator> void | _M_range_initialize (_InputIterator __first, _InputIterator __last, input_iterator_tag) |
template<typename _ForwardIterator> void | _M_range_initialize (_ForwardIterator __first, _ForwardIterator __last, forward_iterator_tag) |
template<typename _Integer> void | _M_assign_dispatch (_Integer __n, _Integer __val, __true_type) |
template<typename _InputIterator> void | _M_assign_dispatch (_InputIterator __first, _InputIterator __last, __false_type) |
template<typename _InputIterator> void | _M_assign_aux (_InputIterator __first, _InputIterator __last, input_iterator_tag) |
template<typename _ForwardIterator> void | _M_assign_aux (_ForwardIterator __first, _ForwardIterator __last, forward_iterator_tag) |
void | _M_fill_assign (size_type __n, const value_type &__val) |
template<typename _Integer> void | _M_insert_dispatch (iterator __pos, _Integer __n, _Integer __val, __true_type) |
template<typename _InputIterator> void | _M_insert_dispatch (iterator __pos, _InputIterator __first, _InputIterator __last, __false_type) |
template<typename _InputIterator> void | _M_range_insert (iterator __pos, _InputIterator __first, _InputIterator __last, input_iterator_tag) |
template<typename _ForwardIterator> void | _M_range_insert (iterator __pos, _ForwardIterator __first, _ForwardIterator __last, forward_iterator_tag) |
void | _M_fill_insert (iterator __pos, size_type __n, const value_type &__x) |
void | _M_insert_aux (iterator __position, const value_type &__x) |
Private Types | |
typedef vector< _Tp, _Alloc > | vector_type |
Private Member Functions | |
__glibcxx_class_requires (_Tp, _SGIAssignableConcept) typedef _Vector_base< _Tp | |
Private Attributes | |
_Alloc | _Base |
Meets the requirements of a container, a reversible container, and a sequence, including the optional sequence requirements with the exception of push_front
and pop_front
.
In some terminology a vector can be described as a dynamic C-style array, it offers fast and efficient access to individual elements in any order and saves the user from worrying about memory and size allocation. Subscripting ( [] ) access is also provided as with C-style arrays.
Definition at line 141 of file stl_vector.h.
|
Reimplemented from _GLIBCXX_STD::_Vector_base< _Tp, _Alloc >. Reimplemented in __gnu_debug_def::vector< _Tp, _Allocator >. Definition at line 162 of file stl_vector.h. |
|
Reimplemented in __gnu_debug_def::vector< _Tp, _Allocator >. Definition at line 157 of file stl_vector.h. Referenced by _GLIBCXX_STD::vector< _Tp, _Allocator >::begin(), _GLIBCXX_STD::vector< _Tp, _Allocator >::capacity(), _GLIBCXX_STD::vector< bool, _Alloc >::capacity(), and _GLIBCXX_STD::vector< _Tp, _Allocator >::end(). |
|
Reimplemented in __gnu_debug_def::vector< _Tp, _Allocator >. Definition at line 152 of file stl_vector.h. |
|
Reimplemented in __gnu_debug_def::vector< _Tp, _Allocator >. Definition at line 154 of file stl_vector.h. |
|
Reimplemented in __gnu_debug_def::vector< _Tp, _Allocator >. Definition at line 158 of file stl_vector.h. Referenced by _GLIBCXX_STD::vector< _Tp, _Allocator >::rbegin(), _GLIBCXX_STD::vector< bool, _Alloc >::rbegin(), _GLIBCXX_STD::vector< _Tp, _Allocator >::rend(), and _GLIBCXX_STD::vector< bool, _Alloc >::rend(). |
|
|
|
Reimplemented in __gnu_debug_def::vector< _Tp, _Allocator >. Definition at line 151 of file stl_vector.h. |
|
Reimplemented in __gnu_debug_def::vector< _Tp, _Allocator >. Definition at line 153 of file stl_vector.h. |
|
Reimplemented in __gnu_debug_def::vector< _Tp, _Allocator >. Definition at line 159 of file stl_vector.h. Referenced by _GLIBCXX_STD::vector< _Tp, _Allocator >::rbegin(), _GLIBCXX_STD::vector< bool, _Alloc >::rbegin(), _GLIBCXX_STD::vector< _Tp, _Allocator >::rend(), and _GLIBCXX_STD::vector< bool, _Alloc >::rend(). |
|
|
Reimplemented in __gnu_debug_def::vector< _Tp, _Allocator >. Definition at line 150 of file stl_vector.h. Referenced by _GLIBCXX_STD::vector< _Tp, _Allocator >::resize(). |
|
Definition at line 147 of file stl_vector.h. |
|
Default constructor creates no elements.
Definition at line 181 of file stl_vector.h. |
|
Create a vector with copies of an exemplar element.
Definition at line 191 of file stl_vector.h. |
|
Create a vector with default elements.
Definition at line 205 of file stl_vector.h. |
|
Vector copy constructor.
Definition at line 219 of file stl_vector.h. |
|
Builds a vector from a range.
If the iterators are forward, bidirectional, or random-access, then this will call the elements' copy constructor N times (where N is distance(first,last)) and do no memory reallocation. But if only input iterators are used, then this will do at most 2N calls to the copy constructor, and logN memory reallocations. Definition at line 241 of file stl_vector.h. |
|
The dtor only erases the elements, and note that if the elements themselves are pointers, the pointed-to memory is not touched in any way. Managing the pointer is the user's responsibilty. Reimplemented in __gnu_debug_def::vector< _Tp, _Allocator >. Definition at line 256 of file stl_vector.h. |
|
|
|
Definition at line 712 of file stl_vector.h. Referenced by _GLIBCXX_STD::vector< _Tp, _Alloc >::_M_assign_aux(), _GLIBCXX_STD::vector< _Tp, _Alloc >::operator=(), and _GLIBCXX_STD::vector< _Tp, _Alloc >::reserve(). |
|
|
|
Definition at line 792 of file stl_vector.h. |
|
Definition at line 783 of file stl_vector.h. Referenced by _GLIBCXX_STD::vector< _Tp, _Allocator >::assign(), and _GLIBCXX_STD::vector< bool, _Alloc >::assign(). |
|
|
|
Definition at line 745 of file stl_vector.h. |
|
Definition at line 734 of file stl_vector.h. Referenced by _GLIBCXX_STD::vector< _Tp, _Allocator >::vector(), and _GLIBCXX_STD::vector< bool, _Alloc >::vector(). |
|
|
Definition at line 833 of file stl_vector.h. |
|
Definition at line 823 of file stl_vector.h. Referenced by _GLIBCXX_STD::vector< _Tp, _Allocator >::insert(), and _GLIBCXX_STD::vector< bool, _Alloc >::insert(). |
|
Definition at line 481 of file stl_vector.h. Referenced by _GLIBCXX_STD::vector< _Tp, _Allocator >::at(), and _GLIBCXX_STD::vector< bool, _Alloc >::at(). |
|
Definition at line 766 of file stl_vector.h. |
|
Definition at line 756 of file stl_vector.h. Referenced by _GLIBCXX_STD::vector< _Tp, _Allocator >::_M_initialize_dispatch(). |
|
|
Definition at line 337 of file vector.tcc. References _GLIBCXX_STD::vector< _Tp, _Alloc >::insert(). Referenced by _GLIBCXX_STD::vector< _Tp, _Allocator >::_M_insert_dispatch(). |
|
Assigns a range to a vector.
Note that the assignment completely changes the vector and that the resulting vector's size is the same as the number of elements assigned. Old data may be lost. Reimplemented in __gnu_debug_def::vector< _Tp, _Allocator >. Definition at line 297 of file stl_vector.h. |
|
Assigns a given value to a vector.
Definition at line 280 of file stl_vector.h. |
|
Provides access to the data contained in the vector.
Definition at line 514 of file stl_vector.h. |
|
Provides access to the data contained in the vector.
Definition at line 500 of file stl_vector.h. |
|
Returns a read-only (constant) reference to the data at the last element of the vector. Reimplemented in __gnu_debug_def::vector< _Tp, _Allocator >. Definition at line 542 of file stl_vector.h. |
|
Returns a read/write reference to the data at the last element of the vector. Reimplemented in __gnu_debug_def::vector< _Tp, _Allocator >. Definition at line 535 of file stl_vector.h. |
|
Returns a read-only (constant) iterator that points to the first element in the vector. Iteration is done in ordinary element order. Reimplemented in __gnu_debug_def::vector< _Tp, _Allocator >. Definition at line 322 of file stl_vector.h. |
|
|
Returns the total number of elements that the vector can hold before needing to allocate more memory. Definition at line 419 of file stl_vector.h. Referenced by _GLIBCXX_STD::vector< _Tp, _Alloc >::_M_assign_aux(), _GLIBCXX_STD::vector< bool, _Alloc >::_M_fill_insert(), _GLIBCXX_STD::vector< bool, _Alloc >::_M_insert_range(), _GLIBCXX_STD::vector< _Tp, _Alloc >::operator=(), _GLIBCXX_STD::vector< bool, _Alloc >::operator=(), _GLIBCXX_STD::vector< _Tp, _Alloc >::reserve(), and _GLIBCXX_STD::vector< bool, _Alloc >::reserve(). |
|
Erases all the elements. Note that this function only erases the elements, and that if the elements themselves are pointers, the pointed-to memory is not touched in any way. Managing the pointer is the user's responsibilty. Reimplemented in __gnu_debug_def::vector< _Tp, _Allocator >. Definition at line 701 of file stl_vector.h. |
|
Returns true if the vector is empty. (Thus begin() would equal end().) Definition at line 427 of file stl_vector.h. |
|
Returns a read-only (constant) iterator that points one past the last element in the vector. Iteration is done in ordinary element order. Reimplemented in __gnu_debug_def::vector< _Tp, _Allocator >. Definition at line 338 of file stl_vector.h. |
|
|
Remove a range of elements.
Note This operation could be expensive and if it is frequently used the user should consider using std::list. The user is also cautioned that this function only erases the elements, and that if the elements themselves are pointers, the pointed-to memory is not touched in any way. Managing the pointer is the user's responsibilty. Reimplemented in __gnu_debug_def::vector< _Tp, _Allocator >. Definition at line 119 of file vector.tcc. References std::_Destroy(), and _GLIBCXX_STD::vector< _Tp, _Alloc >::end(). |
|
Remove element at given position.
Note This operation could be expensive and if it is frequently used the user should consider using std::list. The user is also cautioned that this function only erases the element, and that if the element is itself a pointer, the pointed-to memory is not touched in any way. Managing the pointer is the user's responsibilty. Reimplemented in __gnu_debug_def::vector< _Tp, _Allocator >. Definition at line 107 of file vector.tcc. References std::_Destroy(), std::copy(), and _GLIBCXX_STD::vector< _Tp, _Alloc >::end(). Referenced by _GLIBCXX_STD::vector< _Tp, _Alloc >::_M_assign_aux(), _GLIBCXX_STD::vector< bool, _Alloc >::_M_assign_aux(), _GLIBCXX_STD::vector< bool, _Alloc >::_M_fill_assign(), _GLIBCXX_STD::vector< _Tp, _Allocator >::clear(), _GLIBCXX_STD::vector< bool, _Alloc >::clear(), _GLIBCXX_STD::vector< _Tp, _Allocator >::resize(), and _GLIBCXX_STD::vector< bool, _Alloc >::resize(). |
|
Returns a read-only (constant) reference to the data at the first element of the vector. Reimplemented in __gnu_debug_def::vector< _Tp, _Allocator >. Definition at line 528 of file stl_vector.h. |
|
Returns a read/write reference to the data at the first element of the vector. Reimplemented in __gnu_debug_def::vector< _Tp, _Allocator >. Definition at line 521 of file stl_vector.h. |
|
Inserts a range into the vector.
Note that this kind of operation could be expensive for a vector and if it is frequently used the user should consider using std::list. Reimplemented in __gnu_debug_def::vector< _Tp, _Allocator >. Definition at line 630 of file stl_vector.h. |
|
Inserts a number of copies of given data into the vector.
Note that this kind of operation could be expensive for a vector and if it is frequently used the user should consider using std::list. Definition at line 611 of file stl_vector.h. |
|
|
Returns the size() of the largest possible vector. Definition at line 379 of file stl_vector.h. Referenced by _GLIBCXX_STD::vector< _Tp, _Alloc >::reserve(), and _GLIBCXX_STD::vector< bool, _Alloc >::reserve(). |
|
Vector assignment operator.
Definition at line 130 of file vector.tcc. References std::_Destroy(), _GLIBCXX_STD::vector< _Tp, _Alloc >::_M_allocate_and_copy(), _GLIBCXX_STD::_Vector_base< _Tp, _Alloc >::_M_deallocate(), _GLIBCXX_STD::vector< _Tp, _Alloc >::begin(), _GLIBCXX_STD::vector< _Tp, _Alloc >::capacity(), std::copy(), _GLIBCXX_STD::vector< _Tp, _Alloc >::end(), _GLIBCXX_STD::vector< _Tp, _Alloc >::size(), and std::uninitialized_copy(). |
|
Subscript access to the data contained in the vector.
Reimplemented in __gnu_debug_def::vector< _Tp, _Allocator >. Definition at line 476 of file stl_vector.h. |
|
Subscript access to the data contained in the vector.
Reimplemented in __gnu_debug_def::vector< _Tp, _Allocator >. Definition at line 462 of file stl_vector.h. |
|
Removes last element. This is a typical stack operation. It shrinks the vector by one. Note that no data is returned, and if the last element's data is needed, it should be retrieved before pop_back() is called. Reimplemented in __gnu_debug_def::vector< _Tp, _Allocator >. Definition at line 577 of file stl_vector.h. |
|
Add data to the end of the vector.
Definition at line 556 of file stl_vector.h. Referenced by _GLIBCXX_STD::vector< bool, _Alloc >::_M_initialize_range(), and _GLIBCXX_STD::vector< _Tp, _Allocator >::_M_range_initialize(). |
|
Returns a read-only (constant) reverse iterator that points to the last element in the vector. Iteration is done in reverse element order. Reimplemented in __gnu_debug_def::vector< _Tp, _Allocator >. Definition at line 354 of file stl_vector.h. |
|
Returns a read/write reverse iterator that points to the last element in the vector. Iteration is done in reverse element order. Reimplemented in __gnu_debug_def::vector< _Tp, _Allocator >. Definition at line 346 of file stl_vector.h. |
|
Returns a read-only (constant) reverse iterator that points to one before the first element in the vector. Iteration is done in reverse element order. Reimplemented in __gnu_debug_def::vector< _Tp, _Allocator >. Definition at line 370 of file stl_vector.h. |
|
Returns a read/write reverse iterator that points to one before the first element in the vector. Iteration is done in reverse element order. Reimplemented in __gnu_debug_def::vector< _Tp, _Allocator >. Definition at line 362 of file stl_vector.h. |
|
Attempt to preallocate enough memory for specified number of elements.
The advantage of this function is that if optimal code is a necessity and the user can determine the number of elements that will be required, the user can reserve the memory in advance, and thus prevent a possible reallocation of memory and copying of vector data. Reimplemented in __gnu_debug_def::vector< _Tp, _Allocator >. Definition at line 69 of file vector.tcc. References __N, std::_Destroy(), _GLIBCXX_STD::vector< _Tp, _Alloc >::_M_allocate_and_copy(), _GLIBCXX_STD::_Vector_base< _Tp, _Alloc >::_M_deallocate(), _GLIBCXX_STD::vector< _Tp, _Alloc >::capacity(), _GLIBCXX_STD::vector< _Tp, _Alloc >::max_size(), and _GLIBCXX_STD::vector< _Tp, _Alloc >::size(). |
|
Resizes the vector to the specified number of elements.
Definition at line 412 of file stl_vector.h. |
|
Resizes the vector to the specified number of elements.
Definition at line 393 of file stl_vector.h. Referenced by _GLIBCXX_STD::vector< _Tp, _Allocator >::resize(). |
|
Returns the number of elements in the vector. Definition at line 375 of file stl_vector.h. Referenced by _GLIBCXX_STD::vector< _Tp, _Alloc >::_M_assign_aux(), _GLIBCXX_STD::vector< bool, _Alloc >::_M_assign_aux(), _GLIBCXX_STD::vector< bool, _Alloc >::_M_fill_assign(), _GLIBCXX_STD::vector< _Tp, _Alloc >::_M_fill_insert(), _GLIBCXX_STD::vector< bool, _Alloc >::_M_fill_insert(), _GLIBCXX_STD::vector< bool, _Alloc >::_M_insert_aux(), _GLIBCXX_STD::vector< bool, _Alloc >::_M_insert_range(), _GLIBCXX_STD::vector< _Tp, _Allocator >::_M_range_check(), _GLIBCXX_STD::vector< bool, _Alloc >::_M_range_check(), _GLIBCXX_STD::vector< _Tp, _Alloc >::_M_range_insert(), _GLIBCXX_STD::vector< _Tp, _Alloc >::operator=(), _GLIBCXX_STD::vector< bool, _Alloc >::operator=(), _GLIBCXX_STD::operator==(), _GLIBCXX_STD::vector< _Tp, _Alloc >::reserve(), _GLIBCXX_STD::vector< _Tp, _Allocator >::resize(), _GLIBCXX_STD::vector< bool, _Alloc >::resize(), and _GLIBCXX_STD::vector< bool, _Alloc >::vector(). |
|
Swaps data with another vector.
Definition at line 687 of file stl_vector.h. Referenced by _GLIBCXX_STD::swap(). |
|
Reimplemented in __gnu_debug_def::vector< _Tp, _Allocator >. Definition at line 146 of file stl_vector.h. |