Get Buffer Position Icon Get Buffer Position

This action can be used to retrieve the current position for reading/writing to the buffer. When you create a buffer, the read/write position is set at 0 bytes, and as you add data to the buffer this position will move along sequentially, meaning that you can use this action to get the number of bytes into the buffer that it is set to at any time. You supply the unique buffer ID value as returned by the action Create Buffer and then give a target variable to return the position value to. The target variable can be flagged as being a temporary local variable, in which case it will be created for you and removed from memory again at the end of the current action script or event.

 

Action Syntax:

Get Buffer Position Action

Arguments:

ArgumentDescription
BufferThe buffer index (stored in a variable)
PositionThe read/write position (in bytes) within the buffer

 

Example:

Get Buffer Position ExampleThe above action block code gets the read/write position for the given buffer and if it is not 0 (ie: at the start of the buffer) it is set to the start of the buffer.