aboutsummaryrefslogtreecommitdiffstats
path: root/pages/develop/api/efl/io/buffered_stream/method/discard.txt
diff options
context:
space:
mode:
Diffstat (limited to 'pages/develop/api/efl/io/buffered_stream/method/discard.txt')
-rw-r--r--pages/develop/api/efl/io/buffered_stream/method/discard.txt26
1 files changed, 13 insertions, 13 deletions
diff --git a/pages/develop/api/efl/io/buffered_stream/method/discard.txt b/pages/develop/api/efl/io/buffered_stream/method/discard.txt
index 973b65e5a..477f29fde 100644
--- a/pages/develop/api/efl/io/buffered_stream/method/discard.txt
+++ b/pages/develop/api/efl/io/buffered_stream/method/discard.txt
@@ -1,4 +1,17 @@
~~Title: Efl.Io.Buffered_Stream.discard~~
+===== Description =====
+
+%%Discards the given number of bytes.%%
+
+%%This has the same effect as reading and discarding the given amount of bytes, without executing the actual copy.%%
+
+%%It's often paired with %%[[:develop:api:efl:io:buffered_stream:property:slice|Efl.Io.Buffered_Stream.slice]]%%, if users read the information from the slice and once they're done, that data must be discarded.%%
+
+%%As an example, some protocols provide messages with a "size" header, then %%[[:develop:api:efl:io:buffered_stream:property:slice|Efl.Io.Buffered_Stream.slice]]%% is used to peek into the available memory to see if there is a "size" and if the rest of the slice is the full payload, in this case the slice may be handled to some processing function. When the function is done, that amount of data must be discarded -- with this function.%%
+
+//Since 1.19//
+{{page>:develop:api-include:efl:io:buffered_stream:method:discard:description&nouser&nolink&nodate}}
+
===== Signature =====
<code>
@@ -19,19 +32,6 @@ void efl_io_buffered_stream_discard(Eo *obj, size_t amount);
* **amount** //(in)// - %%Bytes to discard%%
-===== Description =====
-
-%%Discards the given number of bytes.%%
-
-%%This has the same effect as reading and discarding the given amount of bytes, without executing the actual copy.%%
-
-%%It's often paired with %%[[:develop:api:efl:io:buffered_stream:property:slice|Efl.Io.Buffered_Stream.slice]]%%, if users read the information from the slice and once they're done, that data must be discarded.%%
-
-%%As an example, some protocols provide messages with a "size" header, then %%[[:develop:api:efl:io:buffered_stream:property:slice|Efl.Io.Buffered_Stream.slice]]%% is used to peek into the available memory to see if there is a "size" and if the rest of the slice is the full payload, in this case the slice may be handled to some processing function. When the function is done, that amount of data must be discarded -- with this function.%%
-
-//Since 1.19//
-{{page>:develop:api-include:efl:io:buffered_stream:method:discard:description&nouser&nolink&nodate}}
-
===== Implemented by =====
* **Efl.Io.Buffered_Stream.discard**