manual:chapter6:libdata:cmd_binmovb [newRPL User Manual]

Synopsis

Copy binary data block into a binary data object

Stack Diagram

Input Stack						Output Stack
D_dest	Num_{offset_dest}	D_src	Num_{offset_src}	Num_bytes	→	D_{dest_updated}
Level 5	Level 4	Level 3	Level 2	Level 1	→	Level 1

Legend

Legend	Object type
O	Any object
I	Integer number
R	Real number
#	Binary number
Num	Scalar (Integer, Real or Binary number)
Z	Complex number
U	Unit
∡	Angle
A	Symbolic expression
C	Symbolic constant
V	Vector
M	Matrix
S	String
1/0	Any expression evaluating to True or False
G	Grob
F	Font
D	Binary data container
T	Tag object
L	List
cL	Case list
N	Variable name / Identifier
Dir	Directory
pDir	Packed Directory
P	Program
Lib	Library

Type	Command
Parallel list processing	Group 7
Affected by flags	None

Description

The BINMOVB command copies a specified number of bytes 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.

Compatibility

This command is new in newRPL and does not exist in userRPL.

Usage

5:        BINDATA 2 AAAAAAAAAAAA
4:                             3
3:        BINDATA 2 VWZ3iYESIzR4
2:                             2
1:                             4
……………………………………………………………………………………
BINMOVB

will result in

1:        BINDATA 2 ZgAAAYADNEVx
……………………………………………………………………………………

a data container storing bytes { #66h #55h #44h #33h } in positions from 3 to 6.

Related Commands

Arbitrary data containers 9 NEW

Command	Short Description
MKBINDATA	Create binary data container object	NEW
BINPUTB	Store bytes into binary data object	NEW
BINGETB	Extract binary data as list of bytes	NEW
BINPUTW	Store 32-bit words into binary data object	NEW
BINGETW	Extract data from a binary data object as a list of 32-bit words	NEW
BINPUTOBJ	Store an entire object into a binary data container	NEW
BINGETOBJ	Extract an entire object from a binary data container	NEW
BINMOVB	Copy binary data block into a binary data object	NEW
BINMOVW	Copy 32-bit words between binary data objects	NEW