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.7  shel_read                                                  TOS

 Name:         »Shell read« - liest die Kommandozeilen-Parameter der 
               Applikation.

 AES-Nummer:   120

 Deklaration:  int16_t shel_read ( int8_t *sh_rpcmd, int8_t *sh_rptail 
               );

 Beschreibung: Die Funktion ermittelt den Namen und die Kommandozeile, 
               mit der eine Applikation gestartet wurde. Es gilt:

                Parameter  Bedeutung

                sh_rpcmd   vollständiger Pfadname mit Programmname
                sh_rptail  Kommandozeile (gemäß Pexec, also 
                           nullterminiert und mit Längenangaben im 
                           ersten Byte)

               Hinweis: Die Funktion arbeitet nur dann korrekt, wenn 
               die Applikation per shel_write gestartet worden ist. 
               Daher sollte man im Zweifelsfall auf die Werte der 
               Basepage zurückgreifen.

 Ergebnis:     Ein Fehler ist nur dann aufgetreten, wenn als Ergebnis 
               0 zurückgegeben wird.

 Verfügbar:    All AES versions.

 Gruppe:       Shell-Kommunikation

 Querverweis:  Binding   shel_write   Pexec