BSGETV, BSGETOCTV – Binary Structure - Get matrix (all values of the same given type)

Block SymbolsLicensing group: ADVANCED

Function Description
This group of blocks is used for obtaining values from a binary structure (byte array). The BSSETV and BSSETOCTV blocks can be used to write to the binary structure.
The meaning of most of the parameters is the same as the BSGET block, but these blocks retrieve several values of the same type and store them in an array (matrix). A matrix always has m rows and n columns. For the BSGETV block, all elements are of the same type (determined by the type parameter) and the data is filled into the matrix fed to the uMat input. The BSGETOCTV block loads up to 8 vectors. Each row of the matrix can be of a different type. The block allocates the matrix itself. The matrix is available at the yMat output.

Inputs

uVec	Binary Structure (array of bytes) input	Reference
uMat	Reference of matrix for output values	Reference
uOffset	Offset to start in the input Binary Structure (in bytes)	Long (I32)
n	Number of matrix columns	Long (I32)
m	Number of active items	Long (I32)

Outputs

yVec	Copy of the uVec, for easy chaining	Reference
yMat	Copy of the uMat, for easy chaining	Reference
yOffset	Offset after the last processed byte of the input Binary Structure (in bytes), for easy chaining	Long (I32)

Parameters

m	Number of active items (for multi-blocks) $↓$ 1 $↑$ 8 $⊙$ 8	Long (I32)
BE	Big-Endian byte order (default is Little-Endian, e.g. Intel)	Bool
nmax	Allocated size of output matrix (total number of items) yMat $↓$ 1 $⊙$ 32	Long (I32)
type	Data type of item $↓$ 2 $↑$ 10 $⊙$ 2	Long (I32)

[Previous] [Back to top] [Up] [Next]