Difference between revisions of "cpp/named req/SequenceContainer"
From cppreference.com
Ben.Hymers (Talk | contribs) (Correct description of effect of a.emplace(p, t); was referring to 'i') |
Ben.Hymers (Talk | contribs) (Correction: renaming emplace(p, t) to insert since there is no such emplace requirement (ref. [sequence.reqmts])) |
||
| Line 44: | Line 44: | ||
| | | | ||
|- | |- | ||
| − | |{{c|a. | + | |{{c|a.insert(p,t)}}||iterator |
|Inserts a copy of {{ttb|t}} before {{ttb|p}} | |Inserts a copy of {{ttb|t}} before {{ttb|p}} | ||
| | | | ||
Revision as of 06:41, 10 January 2014
Template:cpp/concept/title Template:cpp/concept/navbar
A SequenceContainer is a Template:concept that stores objects of the same type in a linear arrangement.
Contents |
Requirements
Legend | |
X
|
Container type |
T
|
Element type |
a, b
|
Objects of type X
|
t
|
Object of type T
|
n
|
Positive integer |
i, j
|
Template:concepts denoting a valid range |
il
|
std::initializer_list<T> |
args
|
Parameter pack |
p, q
|
const_iterators in a
|
| expression | return type | effects | precondition | postcondition |
|---|---|---|---|---|
| X(n,t) | Constructs a SequenceContainer containing n copies of t |
T Template:concept | std::distance(begin(),end()) == n | |
| X(i,j) | Constructs a SequenceContainer equivalent to the range [i,j)
|
|
std::distance(begin(),end()) == std::distance(i,j) | |
| X(il) | X(il.begin(),il.end()) | |||
| a = il | X& | Assigns the range represented by il into a
|
T Template:concept and Template:concept | Existing elements of a are destroyed or assigned to
|
| a.emplace(p,args) | iterator | Insert an object constructed with std::forward<Args>(args) before p
|
|
|
| a.insert(p,t) | iterator | Inserts a copy of t before p
|
|
|
| a.insert(p,n,t) | iterator | Inserts n copies of t before p
|
T Template:concept and Template:concept | |
| a.insert(p,i,j) | iterator | Inserts copies of elements in [i, j) before p
|
|
Each iterator in [i,j) is dereferenced once
|
| a.insert(p, il) | iterator | a.insert(p,il.begin(),il.end()) | ||
| a.erase(q) | iterator | Erases the element pointed to by q | (std::deque, std::vector) T Template:concept | |
| a.erase(p,q) | iterator | Erases elements in [p,q) |
(std::deque, std::vector) T Template:concept | |
| a.clear() | void | Destroys all elements in a |
| |
| a.assign(i,j) | void | Replaces elements in a with a copy of [i, j)
|
|
Each iterator in [i,j) is dereferenced once
|
| a.assign(il) | void | a.assign(il.begin(),il.end()) | ||
| a.assign(n,t) | void | Replaces elements in a with n copies of t
|
T Template:concept and Template:concept |
Optional Operations
| This section is incomplete |
SequenceContainers in the standard library
| (C++11) |
fixed-sized inplace contiguous array (class template) |
| dynamic contiguous array (class template) | |
| double-ended queue (class template) | |
| (C++11) |
singly-linked list (class template) |
| doubly-linked list (class template) |
Trade-offs / usage notes
| std::array | Fast access but fixed number of elements |
| std::vector | Fast access but mostly inefficient insertions/deletions |
| std::list std::forward_list |
Efficient insertion/deletion in the middle of the sequence |
| std::deque | Efficient insertion/deletion at the beginning and at the end of the sequence |
