BINGETOBJ


Synopsis


Extract an entire object from a binary data container

Stack Diagram


Input Stack Output Stack
Dsrc Numoffset O
Level 2 Level 1 Level 1

Legend

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
  • manual/chapter6/libdata/cmd_bingetobj.txt
  • Last modified: 2019/11/01 06:25
  • by jojo1973