manual:chapter6:libdata:cmd_binputobj [newRPL User Manual]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
==== BINPUTOBJ ====
<callout type="primary" color="" icon="fa fa-book" title="Synopsis">
----
Store a **newRPL** object into a binary data container
</callout>

<callout color="green" icon="fa fa-indent" title="Stack Diagram">
----
^  __Input Stack__  ^^^  ^  __Output Stack__  ^
|  **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}}

| **Keyword type**  | [[manual:chapter5:basics#commands|Command]]  ||
| **Parallel list processing capabilities**  | [[manual:chapter5:listproc#group-7multiple-argument-one-result-commands|Group 7]]  | //Multiple argument, one result commands//  |
| **Affected by flags**  | //None//  ||














</callout>

<callout color="orangered" icon="fa fa-comment" title="Description">
----
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.

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">
----
''BINPUTOBJ'' is specific to **newRPL** and has no direct equivalent in **userRPL**.
</callout>

<callout type="info" icon="true" title="Usage">
----
**__Input__**
<code>
4:                                      
3:          BINDATA 3 AAAAAAAAAAAAAAAAAA
2:                                     0
1:                                 (0,1)
…………………………………………………………………………………………………………
BINPUTOBJ                               
</code>
\\
**__Output__**
<code>
4:                                      
3:                                      
2:                                      
1:          BINDATA 3 AegAAqAOAAAUAOAAAZ
…………………………………………………………………………………………………………
                                        
</code>
</callout>

<callout color="darkgray" icon="fa fa-hand-o-right" title="Related Commands">
----
{{page>manual:chapter6:libdata&nofooter&noeditbtn&inline}}
</callout>