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-File8.18.3  shel_get                                                   TOS

 Name:         »Shell get« - liest den GEM-Environment-Puffer.

 AES-Nummer:   122

 Deklaration:  int16_t shel_get ( int8_t *sh_gaddr, uint16_t sh_glen 
               );

 Beschreibung: Die Funktion dient zum Lesen von Zeichen aus dem 
               internen Environment-Speicher des AES. Es gilt:

                Parameter  Bedeutung

                sh_gaddr   Adresse des Zielspeichers
                sh_glen    Anzahl der zu lesenden Bytes oder Wert -1, 
                           um die Länge des Speichers zu ermitteln.

               Hinweis: Das Desktop nutzt diesen Speicher zur 
               Aufbewahrung der DESKTOP.INF bzw. NEWDESK.INF Datei. 
               Das Format dieser Dateien ist allerdings nicht 
               offiziell dokumentiert. Eine aktuelle Beschreibung 
               findet sich jedoch in newdesk.hyp.

               Unter MagiC werden beim Start des AES alle Daten in den 
               Puffer kopiert, die nach der Zeile #_CTR in MAGX.INF 
               liegen. Die zulässige Länge des Puffers liegt seit 
               MagiC 3 zwischen 4192 und 65534 Bytes. Das 
               Vorhandensein der zusätzlichen Features kann per 
               appl_getinfo (Opcode 6) abgefragt werden.

 Ergebnis:     Ein Rückgabewert von Null signalisiert einen Fehler.

 Verfügbar:    All AES versions.

 Gruppe:       Shell-Kommunikation

 Querverweis:  Binding   shel_put