Sha256: 19c00e60d7493ed831a19177864edae2b57dc59134bd2e3a77c3ffebf981974c

Contents?: true

Size: 1.57 KB

Versions: 183

Compression:

Stored size: 1.57 KB

Contents

# Circular Buffer

A circular buffer, cyclic buffer or ring buffer is a data structure that
uses a single, fixed-size buffer as if it were connected end-to-end.

A circular buffer first starts empty and of some predefined length. For
example, this is a 7-element buffer:

    [ ][ ][ ][ ][ ][ ][ ]

Assume that a 1 is written into the middle of the buffer (exact starting
location does not matter in a circular buffer):

    [ ][ ][ ][1][ ][ ][ ]

Then assume that two more elements are added — 2 & 3 — which get
appended after the 1:

    [ ][ ][ ][1][2][3][ ]

If two elements are then removed from the buffer, the oldest values
inside the buffer are removed. The two elements removed, in this case,
are 1 & 2, leaving the buffer with just a 3:

    [ ][ ][ ][ ][ ][3][ ]

If the buffer has 7 elements then it is completely full:

    [6][7][8][9][3][4][5]

When the buffer is full an error will be raised, alerting the client
that further writes are blocked until a slot becomes free.

The client can opt to overwrite the oldest data with a forced write. In
this case, two more elements — A & B — are added and they overwrite the
3 & 4:

    [6][7][8][9][A][B][5]

Finally, if two elements are now removed then what would be returned is
not 3 & 4 but 5 & 6 because A & B overwrote the 3 & the 4 yielding the
buffer with:

    [ ][7][8][9][A][B][ ]
## Source

Wikipedia [http://en.wikipedia.org/wiki/Circular_buffer](http://en.wikipedia.org/wiki/Circular_buffer)

## Submitting Incomplete Solutions
It's possible to submit an incomplete solution so you can see how others have completed the exercise.

Version data entries

183 entries across 183 versions & 1 rubygems

Version Path
trackler-2.2.1.180 tracks/fsharp/exercises/circular-buffer/README.md
trackler-2.2.1.179 tracks/fsharp/exercises/circular-buffer/README.md
trackler-2.2.1.178 tracks/fsharp/exercises/circular-buffer/README.md
trackler-2.2.1.177 tracks/fsharp/exercises/circular-buffer/README.md
trackler-2.2.1.176 tracks/fsharp/exercises/circular-buffer/README.md
trackler-2.2.1.175 tracks/fsharp/exercises/circular-buffer/README.md
trackler-2.2.1.174 tracks/fsharp/exercises/circular-buffer/README.md
trackler-2.2.1.173 tracks/fsharp/exercises/circular-buffer/README.md
trackler-2.2.1.172 tracks/fsharp/exercises/circular-buffer/README.md
trackler-2.2.1.171 tracks/fsharp/exercises/circular-buffer/README.md
trackler-2.2.1.170 tracks/fsharp/exercises/circular-buffer/README.md
trackler-2.2.1.169 tracks/fsharp/exercises/circular-buffer/README.md
trackler-2.2.1.167 tracks/fsharp/exercises/circular-buffer/README.md
trackler-2.2.1.166 tracks/fsharp/exercises/circular-buffer/README.md
trackler-2.2.1.165 tracks/fsharp/exercises/circular-buffer/README.md
trackler-2.2.1.164 tracks/fsharp/exercises/circular-buffer/README.md
trackler-2.2.1.163 tracks/fsharp/exercises/circular-buffer/README.md
trackler-2.2.1.162 tracks/fsharp/exercises/circular-buffer/README.md
trackler-2.2.1.161 tracks/fsharp/exercises/circular-buffer/README.md
trackler-2.2.1.160 tracks/fsharp/exercises/circular-buffer/README.md