<< Click to Display Table of Contents >> Navigation: 3. Script Language > Variable Definitions and Operations > Data-Block Commands > GFB. - Get-From-Block |
MiniRobotLanguage (MRL)
GFB. Command
Get from Block
Intention
This command can be used to get several elements of an data-block in one strike.
It saves you a bit typing compared to GBE.
When using GFB. there is no need to specify the Block-Variable. GFB. will automatically remember and use the last used block variable. Also the index (the first element number) is fix - the first parameter will retrieve element 1.
A short example, using GFB. and SIB. is:
CNB.$$BLO|6
SIB.Element 01|Element 02|Element 03
GFB.$$EL1|$$EL2|$$EL3
DBP.$$EL1$crlf$$$EL2$crlf$$$EL3
ENR.
Syntax
GFB.P1[|P2][|P3][|P4]..[|PX]
Parameter Explanation
P1- variable, will hold first block element
P2 ... Px (optional) more variables, they will get all successive
Block-Elements.
Example
'**********************************************
' GFB./ SIB. - Sample
'**********************************************
CNB.$$BLO|6
SIB.Element 01|Element 02|Element 03
GFB.$$EL1|$$EL2|$$EL3
DBP.$$EL1$crlf$$$EL2$crlf$$$EL3
ENR.
Remarks
Blocks are internally checked for authenticity. This is done to prevent hard to track error.
If you change bytes or the length of a block variable externally, the block will not be unpacked anymore.
Data blocks can contain all 256 ASC Characters (even binary files) and are binary-compatible. Therefore whether special folders nor system variables are resolved inside blocks. Variables are resolved one time.
Limitations:
There is no explicit limit on data-items per block. However timing considerations may set you a limit at around 10000 Items, depending on your available hardware. For a larger number of non-binary items, Member-Operations, using SBD. FEM. and SBM. may be significantly faster.
See also:
• 1.5.1.5. Organizing data items in blocks