Adapter.maskedScanUint32Peek

Scan for pattern pattern with applied mask mask in the adapter data, starting from offset offset. If a match is found, the value that matched is returned through value, otherwise value is left untouched.

The bytes in pattern and mask are interpreted left-to-right, regardless of endianness. All four bytes of the pattern must be present in the adapter for it to match, even if the first or last bytes are masked out.

It is an error to call this function without making sure that there is enough data (offset+size bytes) in the adapter.

class Adapter

ptrdiff_t

maskedScanUint32Peek

(

uint mask

uint pattern

size_t offset

size_t size

out uint value

)

Parameters

mask uint: mask to apply to data before matching against pattern
pattern uint: pattern to match (after mask is applied)
offset size_t: offset into the adapter data from which to start scanning, returns the last scanned position.
size size_t: number of bytes to scan from offset
value uint: pointer to uint32 to return matching data

Return Value

Type: ptrdiff_t

offset of the first match, or -1 if no match was found.