GET_INFO (BUFFER)

This form can take either two or three parameters. The first parameter is always either of the keywords BUFFER or BUFFERS. The second parameter is any of the words in the following list. The third parameter (in the case of the word "find_buffer") is the name of a specific buffer.

Parameter 2 Return

"current" A pointer to the current buffer in the buffer list or 0 if no such buffer exists. This is equivalent to the CURRENT_BUFFER built-in.

"find_buffer" Uses the buffer name passed in the third parameter to point to the buffer in the nu/TPU buffer list.

"first" A pointer to the first buffer in the buffer list or 0 if no such buffer exists.

"last" A pointer to the last buffer in the buffer list or 0 if no such buffer exits.

"next" A pointer to the next buffer in the buffer list or 0 if no such buffer exists.

"previous" A pointer to the previous buffer in the buffer list or 0 if no such buffer exists.

Syntax:

buffer := GET_INFO ( BUFFER, request )

buffer := GET_INFO ( BUFFER, “find_buffer”, name_string )

Example:

The following example uses the GET_INFO (BUFFER, "current") and GET_INFO(BUFFER_VARIABLE, "name") built-ins to return the buffer name to be copied to the current edit position.

COPY_TEXT (GET_INFO (GET_INFO (BUFFER, "current"), "name"))