SHIP:Sail:bufClr

Function	Returns	Introduced	Description
bufClr	Integer	v5.1.0	Returns number of bytes cleared.

See Also:

• Sail Home
• Sail Functions
• Sail String Functions
• bufCmp, bufCpy, bufSet, bufReset, bufPut, bufGet

Prototype

Integer bufClr(Node buf[,Integer len [,Integer offset]]);

Parameters/Return Value

Parameter	Data Type	Description
buf	String	Buffer to use
len	String	Bytes to clear
offset	Integer	starting index into buf
Return	Integer	number of bytes cleared.

Detailed Description

Clears a buffer variable of all data. Can be supplied a offset, and number of bytes if the user wants a partial clear or certain elements.

Examples

Example	Result	Notes
bufClr(infoBuf, 30);	30
bufClr(splashBuf);	100
bufClr(cancelBuf, 12, 32);	12