Differences

This shows you the differences between two versions of the page.

--- manual:chapter6:libdata:cmd_binputobj [2019/10/31 17:01]
jojo1973 created
+++ manual:chapter6:libdata:cmd_binputobj [2021/09/23 00:45] (current)
jojo1973
@@ Line 1: / Line 1: @@
 ==== BINPUTOBJ ====
-----
 <callout type="primary" color="" icon="fa fa-book" title="Synopsis">
 ----
-Store an entire object into a binary data container
+Store a **newRPL** object into a binary data container
 </callout>
@@ Line 9: / Line 8: @@
 ----
 ^  __Input Stack__  ^^^  ^  __Output Stack__  ^
-|  **D<sub>dest</sub>**  |  **Num<sub>offset</sub>**  |  **O<sub>src</sub>**  |  **→**  |  **D<sub>new</sub>**  |
+|  **D<sub>dest</sub>**  |  **Num<sub>offset</sub>**  |  **O<sub>src</sub>**  |  **→**  |  **D<sub>dest-upd</sub>**  |
 |  //Level 3//  |  //Level 2//  |  //Level 1//  |  //→//  |  //Level 1//  |
 {{page>manual:chapter6:aux:legend&nofooter&noeditbtn&inline}}
-|**Type**| [[manual:chapter5:basics#commands|Command]]  ||
+| **Keyword type**  | [[manual:chapter5:basics#commands|Command]]  ||
-|**Parallel list processing**| [[manual:chapter5:listproc#group-7multiple-argument-one-result-commands|Group 7]]  ||
+| **Parallel list processing capabilities**  | [[manual:chapter5:listproc#group-7multiple-argument-one-result-commands|Group 7]]  | //Multiple argument, one result commands//  |
-|**Affected by flags**| None  ||
+| **Affected by flags**  | //None//  ||
 </callout>
@@ Line 23: / Line 36: @@
 The ''BINPUTOBJ'' command stores a specified object into a binary data container, starting from an offset position; it's not possible to write data exceeding the container's size.
-If the container is large enough, many objects can be stored in it.
+The ''[[manual:chapter6:system:cmd_bytes|BYTES]]'' command returns the size of an object and proves useful for the computation of the offsets. In fact, there is no limit to the number of different objects that can be stored in a binary data container, provided they don't overlap.
 </callout>
 <callout type="danger" icon="true" title="Compatibility">
 ----
-This command is new in newRPL and does not exist in userRPL.
+''BINPUTOBJ'' is specific to **newRPL** and has no direct equivalent in **userRPL**.
 </callout>
 <callout type="info" icon="true" title="Usage">
 ----
+**__Input__**
 <code>
+:
-:  BINDATA 3 AAAAAAAAAAAAAAAAAA
+:          BINDATA 3 AAAAAAAAAAAAAAAAAA
-:                             0
+:                                     0
-:                         (0,1)
+:                                 (0,1)
-……………………………………………………………………………………
+…………………………………………………………………………………………………………
 BINPUTOBJ
 </code>
-will result in
+\\
+**__Output__**
 <code>
-:  BINDATA 3 AegAAqAOAAAUAOAAAZ
+:
-……………………………………………………………………………………
+:
+:
+:          BINDATA 3 AegAAqAOAAAUAOAAAZ
+…………………………………………………………………………………………………………
 </code>
 </callout>
@@ Line 53: / Line 71: @@
 {{page>manual:chapter6:libdata&nofooter&noeditbtn&inline}}
 </callout>