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/30 16:45]
jojo1973 Fixed description 		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, divided into 32-bits words and the specified number of words is written 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 8 bits are __zero padded to 32 bits__ then written in __little endian byte order__ 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 lowest 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 1 AYNcEw +4:                BINDATA 2 AAAAAAAAAAAA 
-3:                             0 +3:                                     0 
-2:                           "X" +2:                    #1122334455667788h 
-1:                             1 +1:                                     2 
-…………………………………………………………………………………… +………………………………………………………………………………………………………… 
-BINPUTW+BINPUTW                                 
 </code> </code>
-where level 4 stores a binary data container of size 4, will result in+\\ 
 +**__Output__**
 <code> <code>
-1:              BINDATA 1 AAAAWQ +4:                                       
-…………………………………………………………………………………… +3:                                       
 +2:                                       
 +1:                BINDATA 2 VWZ3iYESIzR4 
 +………………………………………………………………………………………………………… 
 +                                        
 </code> </code>
-a data container storing bytes ''{ #58h #0h #0h #0h }'' in positions from 0 to 3. 
 </callout> </callout>
  
Line 62: Line 79:
 {{page>manual:chapter6:libdata&nofooter&noeditbtn&inline}} {{page>manual:chapter6:libdata&nofooter&noeditbtn&inline}}
 </callout> </callout>
 +
  • manual/chapter6/libdata/cmd_binputw.1572479140.txt.gz
  • Last modified: 2019/10/30 16:45
  • by jojo1973