module BinData::CheckOrAdjustOffsetPlugin
WARNING: THIS IS UNSUPPORTED!!
This was a (failed) experimental feature that allowed seeking within the input stream. It remains here for backwards compatability for the few people that used it.
The official way to skip around the stream is to use BinData::Skip
with the ‘:to_abs_offset` parameter.
Parameters¶ ↑
Parameters may be provided at initialisation to control the behaviour of an object. These parameters are:
:check_offset
-
Raise an error if the current
IO
offset doesn’t meet this criteria. A boolean return indicates success or failure. Any other return is compared to the current offset. The variableoffset
is made available to any lambda assigned to this parameter. This parameter is only checked before reading. :adjust_offset
-
Ensures that the current
IO
offset is at this position before reading. This is like:check_offset
, except that it will adjust theIO
offset instead of raising an error.