Topic       : TOS - das Betriebssystem
Author      : 
Version     : tos.hyp (5. März 2013)
Subject     : Programmieren/Atari
Nodes       : 3001
Index Size  : 93602
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Titel
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File7.7.31  vsm_string                                                 TOS

 Name:         »Input String, Sample Mode« - liest einen String im 
               SAMPLE-Modus ein.

 VDI-Nummer:   31

 Deklaration:  int16_t vsm_string ( int16_t handle, int16_t 
               max_length, int16_t echo_mode, int16_t *echo_xy, int8_t 
               *string );

 Beschreibung: Die Funktion gibt einen String von der Tastatur zurück. 
               Es gilt:

                Parameter  Bedeutung

                handle     Kennung der Workstation
                max_length maximale Länge des Strings
                echo_mode  Modus
                            0 = kein Echo
                            1 = Echo benutzen
                echo_xy[0] x-Koordinate
                echo_xy[1] y-Koordinate für den Startpunkt der 
                           Echoausgabe
                string     Adresse der Zeichenkette

               Die Echoausgabe ist nicht auf allen Geräten verfübar; 
               im Falle eines Echos werden die Text-Attribute jedoch 
               berücksichtigt.

               Ist max_length negativ, so wird der Absolut-Betrag als 
               Länge benutzt und statt der ASCII-Codes werden Scan- 
               Codes übergeben.

               Die Eingabe der Zeichenkette wird abgebrochen durch:

                  ∙ Return
                  ∙ erreichen der maximalen Eingabelänge
                  ∙ nicht verfügbare Datenwerte

               Falls die Zeichenkette grundsätzlich mit Return 
               abgeschlossen werden soll, ist der Request-Modus per 
               vrq_string zu wählen.

               Hinweis: Die Eingabefunktionen des VDI arbeiten nur auf 
               der physikalischen Workstation, die im Normalfall von 
               den AES benutzt wird.

 Ergebnis:     Die Funktion liefert entweder die Anzahl der gelesen 
               Zeichen oder Null, falls die Eingabe durch eine 
               ungültige Taste abgebrochen wurde. Der eingegebene Text 
               steht in string.

 Verfügbar:    Die Funktion wird nicht von allen Gerätetreibern 
               unterstützt.

 Gruppe:       Eingabefunktionen

 Querverweis:  Binding   vswr_mode   vs_color   vst_alignment 
               vst_height   vst_point   vst_rotation   vst_font 
               vst_color   vst_effects   vrq_string