manual:chapter6:libdata:cmd_binputb

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_binputb [2019/11/06 15:43]
jojo1973 		manual:chapter6:libdata:cmd_binputb [2021/09/23 00:44] (current)
jojo1973
Line 1: Line 1:
 ==== BINPUTB ==== ==== BINPUTB ====
----- 
 <callout type="primary" color="" icon="fa fa-book" title="Synopsis"> <callout type="primary" color="" icon="fa fa-book" title="Synopsis">
 ---- ----
-Store bytes into binary data object+Store bytes 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>bytes</sub>**  |  **→**  |  **D<sub>dest_updated</sub>**  | +|  **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_updated</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_updated</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//  | +|  //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>
  
Line 31: Line 44:
   * a **list of scalars**: each number is converted to an unsigned binary integer and its lower 8 bits are written in 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 ''#00h''.+If the size of the source data is less than the specified number of bytes remaining bytes 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.+''BINPUTB'' 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:                             8 +1:                                     8 
-…………………………………………………………………………………… +………………………………………………………………………………………………………… 
-BINPUTB+BINPUTB                                 
 </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 bytes ''{ #88h #77h #66h #55h #44h #33h #22h #11h }'' in positions from 0 to 7. 
----- 
-<code> 
-4:        BINDATA 2 AAAAAAAAAAAA 
-3:                             0 
-2:                           "∞̅" 
-1:                             2 
-…………………………………………………………………………………… 
-BINPUTB 
-</code> 
-(where character on level 2 is $\overline{\infty}$, obtained with **LS<sup>hold</sup>-0**) will result in 
-<code> 
-1:        BINDATA 2 AAAFHiAAAAAA 
-…………………………………………………………………………………… 
- 
-</code> 
-a data container storing bytes ''{ #1Eh #05h }'' in positions from 0 to 1. 
----- 
-<code> 
-4:        BINDATA 2 AAAAAAAAAAAA 
-3:                             0 
-2: { #1122334455h #5544332211h } 
-1:                             2 
-…………………………………………………………………………………… 
-BINPUTB 
-</code> 
-will result in 
-<code> 
-1:        BINDATA 2 AAARVZAAAAAA 
-…………………………………………………………………………………… 
- 
-</code> 
-a data container storing bytes ''{ #55h #11h #00h #00h #00h #00h #00h #00h }'' 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_binputb.1573083820.txt.gz
  • Last modified: 2019/11/06 15:43
  • by jojo1973