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 variable
offset
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 the IO offset instead of raising an error.