manual:chapter6:libdata:cmd_binputobj

Synopsis


Store a newRPL object into a binary data container

Stack Diagram


Input Stack Output Stack
Ddest Numoffset Osrc Ddest-upd
Level 3 Level 2 Level 1 Level 1

Legend

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
  • manual/chapter6/libdata/cmd_binputobj.txt
  • Last modified: 2021/09/23 00:45
  • by jojo1973