Error Handling and the rc Variable

The rc variable is a predefined global variable that is accessible from all loaded modules. The following functions require that you use the rc variable for error handling: buf_match and get_env.

By convention, functions that use integer error codes return negative error codes that correspond to the error codes in rc.sh. For these functions, 0 means success and positive codes means the error code is not in rc.sh.

Some functions display an error message on the message line. Use the clear_message function to clear the message.

Example:

    // Cause a message.
    _deselect();_copy_to_cursor();
    // Clear the message.
    clear_message();