manual:chapter6:libdata:cmd_binputw

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
manual:chapter6:libdata:cmd_binputw [2019/10/31 16:12]
jojo1973 Added examples 		manual:chapter6:libdata:cmd_binputw [2021/09/23 00:44] (current)
jojo1973
Line 1: Line 1:
 ==== BINPUTW ==== ==== BINPUTW ====
----- 
 <callout type="primary" color="" icon="fa fa-book" title="Synopsis"> <callout type="primary" color="" icon="fa fa-book" title="Synopsis">
 ---- ----
-Store 32-bit words into binary data object+Store 32-bit words into a binary data container
 </callout> </callout>
  
Line 9: Line 8:
 ---- ----
 ^  __Input Stack__  ^^^^  ^  __Output Stack__  ^ ^  __Input Stack__  ^^^^  ^  __Output Stack__  ^
-|  **D<sub>dest</sub>**  |  **Num<sub>offset</sub>**  |  **Num<sub>src</sub>**  |  **Num<sub>words</sub>**  |  **→**  |  **D<sub>new</sub>**  | +|  **D<sub>dest</sub>**  |  **Num<sub>offset</sub>**  |  **Num<sub>src</sub>**  |  **Num<sub>words</sub>**  |  **→**  |  **D<sub>dest-upd</sub>**  | 
-|  **D<sub>dest</sub>**  |  **Num<sub>offset</sub>**  |  **S<sub>src</sub>**  |  **Num<sub>words</sub>**  |  **→**  |  **D<sub>new</sub>**  | +|  **D<sub>dest</sub>**  |  **Num<sub>offset</sub>**  |  **S<sub>src</sub>**  |  **Num<sub>words</sub>**  |  **→**  |  **D<sub>dest-upd</sub>**  | 
-|  **D<sub>dest</sub>**  |  **Num<sub>offset</sub>**  |  **L<sub>src</sub>**  |  **Num<sub>words</sub>**  |  **→**  |  **D<sub>new</sub>**  | +|  **D<sub>dest</sub>**  |  **Num<sub>offset</sub>**  |  **L<sub>src</sub>**  |  **Num<sub>words</sub>**  |  **→**  |  **D<sub>dest-upd</sub>**  | 
-|  //Level 4//  |  //Level 3//  |  //Level 2//  |  //Level 1//  |  //→//  |  //Level 1//  | +|  //Level 4//  |  //Level 3//  |  //Level 2//  |  //Level 1//  |  //→//  |  //Level 1//  |
  
 {{page>manual:chapter6:aux:legend&nofooter&noeditbtn&inline}} {{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> </callout>
  
 <callout color="orangered" icon="fa fa-comment" title="Description"> <callout color="orangered" icon="fa fa-comment" title="Description">
 ---- ----
-The ''BINPUTW'' stores a specified number of 32 bits words into a binary data container, starting from an offset position; it's not possible to write data exceeding the container's size.+The ''BINPUTW'' command stores a specified number of 32-bit words 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: The source of data can be:
  
-  * a **scalar**: the number is converted to an unsigned binary integer and divided into 32-bits words which are stored in the container, in __little endian word order__;+  * a **scalar**: the number is converted to an unsigned binary integer and divided into 32-bit words which are stored in the container, in __little endian word order__;
   * a **string**: the string is converted to a stream of UTF8 codepoints whose lower 32 bits are stored into the container;   * a **string**: the string is converted to a stream of UTF8 codepoints whose lower 32 bits are stored into the container;
   * a **list of scalars**: each number is converted to an unsigned binary integer and its lower 32 bits are written in the container.   * a **list of scalars**: each number is converted to an unsigned binary integer and its lower 32 bits are written in the container.
  
-If the size of the source data is less than the specified number of words the writing operation terminates silently without error.+If the size of the source data is less than the specified number of words remaining words will be set to ''#0h''.
 </callout> </callout>
  
 <callout type="danger" icon="true" title="Compatibility"> <callout type="danger" icon="true" title="Compatibility">
 ---- ----
-This command is new in newRPL and does not exist in userRPL.+''BINPUTW'' is specific to **newRPL** and has no direct equivalent in **userRPL**.
 </callout> </callout>
  
 <callout type="info" icon="true" title="Usage"> <callout type="info" icon="true" title="Usage">
 ---- ----
 +**__Input__**
 <code> <code>
-4:        BINDATA 2 AAAAAAAAAAAA +4:                BINDATA 2 AAAAAAAAAAAA 
-3:                             0 +3:                                     0 
-2:            #1122334455667788h +2:                    #1122334455667788h 
-1:                             2 +1:                                     2 
-…………………………………………………………………………………… +………………………………………………………………………………………………………… 
-BINPUTW+BINPUTW                                 
 </code> </code>
-will result in+\\ 
 +**__Output__**
 <code> <code>
-1:        BINDATA 2 VWZ3iYESIzR4 +4:                                       
-…………………………………………………………………………………… +3:                                       
 +2:                                       
 +1:                BINDATA 2 VWZ3iYESIzR4 
 +………………………………………………………………………………………………………… 
 +                                        
 </code> </code>
-a data container storing words ''{ #55667788h #11223344h }'' in positions from 0 to 1. 
----- 
-<code> 
-4:        BINDATA 2 AAAAAAAAAAAA 
-3:                             0 
-2:                           "∞̅" 
-1:                             2 
-…………………………………………………………………………………… 
-BINPUTW 
-</code> 
-(where character on level 2 is $\overline{\infty}$, obtained with **LS<sup>hold</sup>-0**) will result in 
-<code> 
-1:        BINDATA 2 AAAiHqAAADBV 
-…………………………………………………………………………………… 
- 
-</code> 
-a data container storing words ''{ #0000221Eh #00000305h }'' in positions from 0 to 1. 
----- 
-<code> 
-4:        BINDATA 2 AAAAAAAAAAAA 
-3:                             0 
-2: { #1122334455h #5544332211h } 
-1:                             2 
-…………………………………………………………………………………… 
-BINPUTW 
-</code> 
-will result in 
-<code> 
-1:        BINDATA 2 IjNEVBRDMiE5 
-…………………………………………………………………………………… 
- 
-</code> 
-a data container storing words ''{ #22334455h #44332211h }'' in positions from 0 to 1. 
 </callout> </callout>
  
Line 94: Line 79:
 {{page>manual:chapter6:libdata&nofooter&noeditbtn&inline}} {{page>manual:chapter6:libdata&nofooter&noeditbtn&inline}}
 </callout> </callout>
 +
  • manual/chapter6/libdata/cmd_binputw.1572563527.txt.gz
  • Last modified: 2019/10/31 16:12
  • by jojo1973