Name

preq_string − Prompts for input using the string-class logical input device specified. 

Operating States: PHOP, WSOP, ∗, ∗
PHIGS standard function

Syntax

void preq_string (
  Pint         wsid,      /∗ (I) Workstation identifier ∗/
  Pint         dev_num,   /∗ (I) String device number ∗/
  Pin_status  ∗status,    /∗ (O) Input status ∗/
  char        ∗string     /∗ (O) Requested string ∗/
)

Data Structures

typedef enum {
    PIN_STATUS_NONE,    /∗ user performed a break action ∗/
    PIN_STATUS_OK,      /∗ user entered a string ∗/
    PIN_STATUS_NO_IN    /∗ not used by this function ∗/
} Pin_status;

Description

preq_string prompts for input using the string-class logical input device specified by the device number and the workstation identifier.  If the input status is PIN_STATUS_OK, this function returns the character string. 

If you generate a string that contains more characters (including the initial string) than the number of components in the string buffer, you lose the additional input.  To establish a string buffer size, call the pinit_string function. 

The application allocates the memory for the character string returned by this function.  You specify the maximum size of the returned character string with the function pinit_string or pinit_string3.  To determine the maximum size of a character string supported by Digital PHIGS, call either pinq_def_string_data or pinq_def_string_data3. 

See Also

pget_string
pinit_string
pinq_string_st
psample_string
pset_string_mode