File: ExtensibleSequence.rst

package info (click to toggle)
boost1.88 1.88.0-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 576,932 kB
  • sloc: cpp: 4,149,234; xml: 136,789; ansic: 35,092; python: 33,910; asm: 5,698; sh: 4,604; ada: 1,681; makefile: 1,633; pascal: 1,139; perl: 1,124; sql: 640; yacc: 478; ruby: 271; java: 77; lisp: 24; csh: 6
file content (81 lines) | stat: -rw-r--r-- 4,874 bytes parent folder | download | duplicates (13)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
.. Sequences/Concepts//Extensible Sequence |40

Extensible Sequence
===================

Description
-----------

An |Extensible Sequence| is a sequence that supports insertion and removal of 
elements. Extensibility is orthogonal to sequence traversal characteristics.


Expression requirements
-----------------------

For any |Extensible Sequence| ``s``, its iterators ``pos`` and ``last``, 
|Forward Sequence| ``r``, and any type ``x``, the following expressions must
be valid:

+-----------------------------------+---------------------------+---------------------------+
| Expression                        | Type                      | Complexity                |
+===================================+===========================+===========================+
| ``insert<s,pos,x>::type``         | |Extensible Sequence|     | Unspecified               |
+-----------------------------------+---------------------------+---------------------------+
| ``insert_range<s,pos,r>::type``   | |Extensible Sequence|     | Unspecified               |
+-----------------------------------+---------------------------+---------------------------+
| ``erase<s,pos>::type``            | |Extensible Sequence|     | Unspecified               |
+-----------------------------------+---------------------------+---------------------------+
| ``erase<s,pos,last>::type``       | |Extensible Sequence|     | Unspecified               |
+-----------------------------------+---------------------------+---------------------------+
| ``clear<s>::type``                | |Extensible Sequence|     | Constant time             |
+-----------------------------------+---------------------------+---------------------------+

Expression semantics
--------------------

+-----------------------------------+---------------------------------------------------------------+
| Expression                        | Semantics                                                     |
+===================================+===============================================================+
| ``insert<s,pos,x>::type``         | A new sequence, concept-identical to ``s``, of                |
|                                   | the following elements:                                       |
|                                   | [``begin<s>::type``, ``pos``), ``x``,                         |
|                                   | [``pos``, ``end<s>::type``); see |insert|.                    |
+-----------------------------------+---------------------------------------------------------------+
| ``insert_range<s,pos,r>::type``   | A new sequence, concept-identical to ``s``, of                |
|                                   | the following elements:                                       |
|                                   | [``begin<s>::type``, ``pos``),                                |
|                                   | [``begin<r>::type``, ``end<r>::type``),                       |
|                                   | [``pos``, ``end<s>::type``); see |insert_range|.              |
+-----------------------------------+---------------------------------------------------------------+
| ``erase<s,pos>::type``            | A new sequence, concept-identical to ``s``, of                |
|                                   | the following elements:                                       |
|                                   | [``begin<s>::type``, ``pos``),                                |
|                                   | [``next<pos>::type``, ``end<s>::type``); see |erase|.         |
+-----------------------------------+---------------------------------------------------------------+
| ``erase<s,pos,last>::type``       | A new sequence, concept-identical to ``s``, of                |
|                                   | the following elements:                                       |
|                                   | [``begin<s>::type``, ``pos``),                                |
|                                   | [``last``, ``end<s>::type``); see |erase|.                    |
+-----------------------------------+---------------------------------------------------------------+
| ``clear<s>::type``                | An empty sequence concept-identical to ``s``; see             |
|                                   | |clear|.                                                      |
+-----------------------------------+---------------------------------------------------------------+


Models
------

* |vector|
* |list|


See also
--------

|Sequences|, |Back Extensible Sequence|, |insert|, |insert_range|, |erase|, |clear|


.. copyright:: Copyright   2001-2009 Aleksey Gurtovoy and David Abrahams
   Distributed under the Boost Software License, Version 1.0. (See accompanying
   file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)