Releases a record from a buffer object. The BUFFER-RELEASE method corresponds to the RELEASE statement.

Note: To delete the buffer object, use the DELETE OBJECT statement.

Return type: LOGICAL

Applies to: Buffer object handle

Syntax

BUFFER-RELEASE ( )

If a record has been modified, this method causes a WRITE event and executes all related WRITE triggers.

If successful, this method returns TRUE. Otherwise, it returns FALSE. If the validation fails on a newly-created record, this method returns FALSE and raises the ERROR condition.

Note: The BUFFER-RELEASE() method cannot be used together with other assignments in a single ASSIGN statement.