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.1  shel_envrn                                                 TOS

 Name:         »Shell environment« - ermittelt den Wert von 
               Environmentvariablen.

 AES-Nummer:   125

 Deklaration:  int16_t shel_envrn ( int8_t **sh_epvalue, int8_t 
               *sh_eparm );

 Beschreibung: Die Funktion ermittelt den Wert einer beliebigen 
               Environmentvariablen des AES. Es gilt:

                Parameter   Bedeutung

                sh_epvalue  Name der Environment-Variablen
                sh_eparm    enthält nach dem Aufruf den Wert der 
                            entsprechenen Variablen

               Hinweis: Um das AES-Environment zu ändern sollte man 
               sich in den exec_os-Vektor einklinken, über den auch 
               das GEM gestartet wird. In der aufgerufenen Routine 
               liegt (analog zu einem Programm) der Basepage-Zeiger 
               auf dem Stack. In diese Basepage kann dann einfach ein 
               Zeiger auf das neue Environment eingetragen werden. 
               Aber Achtung: In AES-Versionen kleiner als 1.4 werden 
               nur die ersten 50 Bytes übernommen.

               Noch ein Tip: Wenn der für 'PATH=' zurückgelieferte 
               Zeiger auf ein Nullbyte verweist, sollte man ihn um den 
               Wert 1 erhöhen, um an das richtige Ergebnis zu 
               gelangen.

 Ergebnis:     Die Funktion liefert als Ergebnis immer 1.

 Verfügbar:    All AES versions.

 Gruppe:       Shell-Kommunikation

 Querverweis:  Binding