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-File5.10.1  Talarm                                                     TOS

 Name:         »Talarm« - Lesen/setzen eines Alarms für den aktuellen 
               Prozess.

 Gemdosnummer: 288 (0x0120)

 Deklaration:  int32_t Talarm ( int32_t time );

 Beschreibung: Die Funktion sendet dem aufrufenden Prozess nach time 
               Sekunden ein SIGALRM-Signal.

               Falls für dieses Signal kein Signal-Handler per Psignal 
               installiert wurde, wird der Prozess sofort (d.h. beim 
               Eintreffen des Signals) terminiert.

               Durch einen Wert von time = 0, kann ein früher 
               gesetzter Alarm storniert werden. Ist time negativ, so 
               hat die Funktion keine Auswirkungen und lediglich der 
               Rückgabewert wird geliefert.

 Ergebnis:     Die Funktion liefert die Zeit bis zum Eintreffen des 
               SIGALRM-Signals (wenn ein Alarm aktiviert wurde) in 
               Sekunden zurück, und anderenfalls den Wert 0.

 Verfügbar:    Seit der ersten in MultiTOS integrierten MiNT Version 
               1.04.

               Diese Funktion wurde mit MiNT Version 0.8pl8 
               eingeführt, aber für Versionen vor 1.12 enthält der 
               Code einen Fehler, der die Funktionalität 
               beeinträchtigt.

 Gruppe:       Datum und Uhrzeit

 Querverweis:  Binding   Tmalarm   Pause   Psignal   Signale