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

Synopsis

Store a newRPL object into a binary data container

Stack Diagram

Input Stack				Output Stack
D_dest	Num_offset	O_src	→	D_dest-upd
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

Keyword type	Command
Parallel list processing capabilities	Group 7	Multiple argument, one result commands
Affected by flags	None

Description

The BINPUTOBJ command stores a specified object into a binary data container, starting from an offset position; it's not possible to write data exceeding the container's size.

The BYTES command returns the size of an object and proves useful for the computation of the offsets. In fact, there is no limit to the number of different objects that can be stored in a binary data container, provided they don't overlap.

Compatibility

BINPUTOBJ is specific to newRPL and has no direct equivalent in userRPL.

Usage

Input

4:                                      
3:          BINDATA 3 AAAAAAAAAAAAAAAAAA
2:                                     0
1:                                 (0,1)
…………………………………………………………………………………………………………
BINPUTOBJ

Output

4:                                      
3:                                      
2:                                      
1:          BINDATA 3 AegAAqAOAAAUAOAAAZ
…………………………………………………………………………………………………………

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