bdelete

bdelete --  deletes a single character from a buffer.

Syntax

bdelete (buffer, position)

		

Arguments

buffer

A buffer.

position

A number from 0 to the length of the buffer - 1.

Returns

The number contained at the specified position in the buffer, or nil if the buffer is undefined at the given position.

Description

This function deletes a single character from a raw memory buffer. The buffer length does not change as a result of this function. A zero character is placed at the empty position at the end of the buffer, then the buffer is collapsed.

Example

    Gamma> y = buffer (101, 102, 103, 104);
    #{efgh}
    Gamma> bdelete(y,2);
    103
    Gamma> y;
    #{efh\0}
    Gamma> 
    		

See Also

delete

Copyright 1995-2002 by Cogent Real-Time Systems, Inc.