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

Synopsis

Extract data from a binary data object as a list of 32-bit words

Stack Diagram

Input Stack				Output Stack
D_src	Num_offset	Num_words	→	L
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 BINGETW command retrieves a specified number of words from a binary data container, starting from an offset position and returning the result in form of a list. The data is read from the container assuming it is stored in little endian byte order.

Compatibility

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

Usage

3:        BINDATA 2 VWZ3iYESIzR4
2:                             1
1:                             1
……………………………………………………………………………………
BINGETW

will result in

1:                { #11223344h }
……………………………………………………………………………………

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