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

Synopsis

Extract an entire object from a binary data container

Stack Diagram

Input Stack			Output Stack
D_src	Num_offset	→	O
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 BINGETOBJ command retrieves an object stored into a binary data container, starting from an offset position; the command checks if the object actually exist and fails otherwise.

Compatibility

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

Usage

2:  BINDATA 3 AegAAqAOAAAUAOAAAZ
1:                             0
……………………………………………………………………………………
BINGETOBJ

will result in

1:                         (0,1)
……………………………………………………………………………………

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