==== BINPUTB ====
<callout type="primary" color="" icon="fa fa-book" title="Synopsis">
----
Store bytes 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>**  |  **Num<sub>src</sub>**  |  **Num<sub>bytes</sub>**  |  **→**  |  **D<sub>dest-upd</sub>**  |
|  **D<sub>dest</sub>**  |  **Num<sub>offset</sub>**  |  **S<sub>src</sub>**  |  **Num<sub>bytes</sub>**  |  **→**  |  **D<sub>dest-upd</sub>**  |
|  **D<sub>dest</sub>**  |  **Num<sub>offset</sub>**  |  **L<sub>src</sub>**  |  **Num<sub>bytes</sub>**  |  **→**  |  **D<sub>dest-upd</sub>**  |
|  //Level 4//  |  //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 ''BINPUTB'' command stores a specified number of bytes into a binary data container, starting from an offset position; it's not possible to write data exceeding the container's size.

The source of data can be:

  * a **scalar**: the number is converted to an unsigned binary integer and divided into bytes which are stored in the container, in __little endian byte order__;
  * a **string**: the string is converted to a stream of UTF8 codepoints whose lower 8 bits are stored into the container;
  * a **list of scalars**: each number is converted to an unsigned binary integer and its lower 8 bits are written in the container.

If the size of the source data is less than the specified number of bytes remaining bytes will be set to ''#0h''.
</callout>

<callout type="danger" icon="true" title="Compatibility">
----
''BINPUTB'' is specific to **newRPL** and has no direct equivalent in **userRPL**.
</callout>

<callout type="info" icon="true" title="Usage">
----
**__Input__**
<code>
4:                BINDATA 2 AAAAAAAAAAAA
3:                                     0
2:                    #1122334455667788h
1:                                     8
…………………………………………………………………………………………………………
BINPUTB                                 
</code>
\\
**__Output__**
<code>
4:                                      
3:                                      
2:                                      
1:                BINDATA 2 VWZ3iYESIzR4
…………………………………………………………………………………………………………
                                        
</code>
</callout>

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