manual:chapter6:libdata:cmd_binmovw [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.
==== BINMOVW ====
----
<callout type="primary" color="" icon="fa fa-book" title="Synopsis">
----
Copy 32-bit words between binary data objects
</callout>

<callout color="green" icon="fa fa-indent" title="Stack Diagram">
----
^  __Input Stack__  ^^^^^  ^  __Output Stack__  ^
|  **D<sub>dest</sub>**  |  **Num<sub>offset_dest</sub>**  |  **D<sub>src</sub>**  |  **Num<sub>offset_src</sub>**  |  **Num<sub>words</sub>**  |  **→**  |  **D<sub>dest_updated</sub>**  |
|  //Level 5//  |  //Level 4//  |  //Level 3//  |  //Level 2//  |  //Level 1//  |  //→//  |  //Level 1//  | 

{{page>manual:chapter6:aux:legend&nofooter&noeditbtn&inline}}

|**Type**| [[manual:chapter5:basics#commands|Command]]  ||
|**Parallel list processing**| [[manual:chapter5:listproc#group-7multiple-argument-one-result-commands|Group 7]]  || 
|**Affected by flags**| None  ||
</callout>

<callout color="orangered" icon="fa fa-comment" title="Description">
----
The ''BINMOVW'' command copies a specified number of words from a binary data container to another, starting from an offset position and writing the data at another; it's not possible to write data exceeding the destination container's size.
</callout>

<callout type="danger" icon="true" title="Compatibility">
----
This command is new in newRPL and does not exist in userRPL.
</callout>

<callout type="info" icon="true" title="Usage">
----
<code>

5:        BINDATA 2 AAAAAAAAAAAA
4:                             1
3:        BINDATA 2 VWZ3iYESIzR4
2:                             0
1:                             1
……………………………………………………………………………………
BINMOVW
</code>
will result in
<code>
1:        BINDATA 2 AAAAAAVWZ3iY
……………………………………………………………………………………

</code>
a data container storing the word ''#55667788h'' in position 1.
</callout>

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