Markers

Markers allow a application to set down a marker, then parse forward, and then if need be revert to the marker position in case not enought data has arrived to complete the parse. Markers are especialy imporatnt whjen dealing with network handles, but it is always good practice to use them to make sure that the data one tries to retrive is intact.

testify_restart_marker_set

void testify_restart_marker_set(THandle *handle);

Description: Sets the marker at the current spot in the stream, forcing the handle not to free any data from this point forward in order to be able to rewind to this point.

testify_restart_marker_release

void testify_restart_marker_release(THandle *handle);

Description: Releases the currently set marker. The handle may free data before the current stream position.

testify_restart_marker_reset

void testify_restart_marker_reset(THandle *handle);

Description: Re sets the current read position to the marker.

testify_retivable

boolean testify_retivable(THandle *handle, uint size);

Description: Returns TRUE or FALSE if "size" number of bytes are retrivable. If the handle is set to debug mode the function will only count actiual payload not debug meta data.

testify_retivable_terminated

boolean testify_retivable_terminated(THandle *handle);

Description: Returns TRUE or FALSE if a null terminated string can be obtained form the stream.