Документ взят из кэша поисковой машины. Адрес оригинального документа : http://www.atnf.csiro.au/computing/software/gipsy/sub/usertext.dc2 Дата изменения: Mon Feb 5 07:28:23 2001 Дата индексирования: Fri Jan 16 20:39:39 2009 Кодировка: Поисковые слова: galaxy cluster

Function: USERTEXT

Purpose: User input interface routine for characters.

Category: USER-INTERFACE

File: srvreq.c

Author: J.P. Terlouw

Declaration: INTEGER USERTEXT

Use: INTEGER USERTEXT( ARRAY, Output character array
DEFAULT, Input integer
KEY, Input character
MES ) Input character

USERTEXT number of characters entered by the user.
ARRAY array, contains output.
DEFAULT default code ( 0: no default, 1: default,
2: hidden, 4: exact number, -1: special, see below).
KEY keyword prompt.
MES message for user.

Special: Event-driven tasks can call USERTEXT with DEFAULT=-1.
In this case the following information can be obtained
from Hermes, depending on the supplied keyword:

UCAMESSAGE= obtains the last User Command Area error message,
usually a message associated with a rejected keyword;
REJECTED= the input text associated with a rejected keyword.
LSTMESSAGE= the last status message issued by a deputy task.

In order to obtain reliable information from these keywords,
the call must take place immediately after the detection of
the problem at hand.

Updates: Jul 25, 1988: KGB, Creation date.
Feb 15, 1990: JPT, Portable version, rewritten in ANSI C.
Sep 17, 1990: JPT, Bug in default handling repaired.
Apr 17, 1991: JPT, reply buffer check added
Oct 15, 1993: JPT, removed reply buffer limitation.
Nov 25, 1997: JPT, documented special operation.
Jun 10, 1998: JPT, documented LSTMESSAGE=.