sys_request()

Purpose

Displays an error message and conditionally aborts

Old name

#define _sys_request sys_request

Syntax

void sys_request(msg_nr, ADDITIONAL)

Parameters

int msg_nr

Number of error map to display

 

ADDITIONAL

Two optional parameters:

  • error number to display
  • extra error parameter

Description

The sys_request() function is used by the library functions to display an error message followed by a pause. The program is aborted only if the user presses the <Esc> key. The error map displayed corresponds to the map number on the system mapset of the SYSTEM database.

You should use your own function to display critical error messages rather than this function.

This function does not abort the program, unlike the function sys_error().

It is one of the functions you must rewrite if you do not wish to load the terminal manager.

See also

sys_message(), sys_error()