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.3.9  appl_read                                                   TOS

 Name:         »Application read« - empfängt eine Mitteilung einer 
               anderen Applikation.

 AES-Nummer:   11

 Deklaration:  int16_t appl_read ( int16_t ap_rid, int16_t ap_rlength, 
               void *ap_rpbuff );

 Beschreibung: Die Funktion liest eine Anzahl von Bytes aus der 
               Message-Pipe. Es gilt:

                Parameter  Bedeutung

                ap_rid     ID der Applikation, aus deren 
                           Ereignispuffer gelesen werden soll.
                ap_rlength Anzahl der zu lesenden Bytes
                ap_rpbuff  Adresse des Puffers, in dem die Daten 
                           abgelegt werden sollen

               Die Funktion wartet ggfs. bis die angeforderte Anzahl 
               an Bytes tatsächlich zur Verfügung steht. In MagiC und 
               MultiTOS ist die Funktion so erweitert worden, daß sie 
               mit einer entsprechenden Meldung zurückkehrt, wenn 
               keine Daten vorhanden sind (ap_rid: -1).

               Hinweis: appl_read arbeitet destruktiv, d.h. daß 
               Nachrichten nach dem Auslesen aus der Message-Pipe 
               entfernt werden. Dies macht es notwendig, die gelesene 
               Nachricht so auszuwerten, wie es beispielsweise nach 
               einem evnt_multi-Aufruf geschieht.

               Das Vorhandensein des erweiterten Feature kann über 
               appl_getinfo (Opcode 6) abgefragt werden.

 Ergebnis:     Wird eine Null zurückgegeben, so ist ein Fehler 
               aufgetreten, sonst wird eine positive Zahl als Ergebnis 
               zurückgegeben.

 Verfügbar:    In allen AES Versionen.

 Gruppe:       Applikationen

 Querverweis:  Binding   appl_init   appl_write   evnt_mesag 
               evnt_multi