Name

psample_string − Returns the character string from the string-class logical input device specified. 

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

Syntax

void psample_string (
  Pint     wsid,     /∗ (I) Workstation identifier ∗/
  Pint     dev_num,  /∗ (I) String device number ∗/
  char    ∗string    /∗ (O) String ∗/
)

Description

psample_string takes the current measure of the string-class logical input device specified by the device number and the workstation identifier, and returns the character string. 

If the current string contains more characters (including the initial string) than the number of components in the string buffer, Digital PHIGS loses the additional input.  To establish a string buffer size, call the pinit_string function. 

See Also

pget_string
pinit_string
pinq_string_st
preq_string
pset_string_mode