| 1 # Buffer |
1 # Buffer |
| 2 |
2 |
| 3 <warning> |
3 <warning> |
| 4 Outdated - Rewrite! |
4 Outdated Section - will be updated soon! |
| 5 </warning> |
5 </warning> |
| 6 |
6 |
| 7 Instances of this buffer implementation can be used to read from or write to memory like you would do with a stream. |
7 Instances of this buffer implementation can be used to read from or write to memory like you would do with a stream. |
| 8 This allows the use of `cx_stream_copy()` (see [](streams.h.md)) to copy contents from one buffer to another, |
8 This allows the use of `cx_stream_copy()` (see [](streams.h.md)) to copy contents from one buffer to another, |
| 9 or from a file or network streams to the buffer and vice-versa. |
9 or from a file or network streams to the buffer and vice versa. |
| 10 |
10 |
| 11 More features for convenient use of the buffer can be enabled, like automatic memory management and automatic |
11 More features for convenient use of the buffer can be enabled, like automatic memory management and automatic |
| 12 resizing of the buffer space. |
12 resizing of the buffer space. |
| 13 |
13 |
| 14 Since UCX 3.0, the buffer also supports automatic flushing of contents to another stream (or buffer) as an alternative |
14 Since UCX 3.0, the buffer also supports automatic flushing of contents to another stream (or buffer) as an alternative |
| 15 to automatically resizing the buffer space. |
15 to automatically resizing the buffer space. |
| 16 Please refer to the API doc for the fields prefixed with `flush_` to learn more. |
16 Please refer to the API doc for the fields prefixed with `flush_` to learn more. |
| 17 |
17 |
| |
18 <!-- |
| 18 ## Undocumented Symbols (TODO) |
19 ## Undocumented Symbols (TODO) |
| 19 ### cxBufferAppend |
20 ### cxBufferAppend |
| 20 ### cxBufferClear |
21 ### cxBufferClear |
| 21 ### cxBufferCreate |
22 ### cxBufferCreate |
| 22 ### cxBufferDestroy |
23 ### cxBufferDestroy |