TutBufReset

Name

TutBufReset — reset the buffer contents

Synopsis

T_BOOL TutBufReset(buf, ptr) 
T_BUF buf; 
T_PTR ptr; 

Arguments

buf — T_BUF object to reset

ptr — new position

Return Values

TRUE if successful, FALSE otherwise.

Diagnostics

None

Description

TutBufReset moves the "write pointer" to the location given by ptr. If ptr is NULL, then the buffer is reset to empty. This function fails if ptr is outside the bounds of the buffer.

Caution

None

See Also

TutBufRewind

Examples

This example resets a buffer to the beginning:

T_BOOL status; 
status = TutBufReset(buf, NULL); 
if (status == FALSE) { 
  /* error */ 
}