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-File4.18.3  CJar                                                       TOS

 Name:         »CJar« - Erzeugen, Abfragen und Löschen von Cookies

 Xbiosnummer:  17226 (0x434A)

 Deklaration:  int32_t CJar( int16_t mode, int32_t cookie, int32_t 
               *value );

 Beschreibung: Die XBIOS-Routine CJar dient auf komfortable Weise zum 
               Erzeugen, Abfragen und Löschen von Cookies.

                Parameter  Bedeutung

                mode       Modus 0:
                           Ermittelt den Wert des Kekses und legt in 
                           an der angegebenen Adresse ab. Übergibt man 
                           für value einen Nullzeiger, so wird 
                           lediglich die Existenz des Kekses 
                           überprüft.
                           Bei erfolgreicher Ermittlung des Kekses, 
                           liefert der Aufruf 0x6172 (="CJar_OK") 
                           zurück, sonst einen anderen Wert.

                           Modus 1:
                           Erzeugt einen neuen Keks (cookie). Value 
                           zeigt auf einen Wert, der in den Jar 
                           eingetragen wird. WICHTIG! Es wird nicht 
                           value eingetragen, sondern der Wert auf den 
                           'value' weist! Bei Übergabe eines NULL- 
                           Pointers wird 0 als Kekswert eingetragen. 
                           Existiert der Keks bereits, so wird sein 
                           alter Inhalt überschrieben!
                           Die Funktion liefert "CJar_OK" bei 
                           erfolgreicher Eintragung. -1 wird für den 
                           Fall geliefert, daß der Cookie-Jar voll 
                           ist.

                           Modus 2:
                           Entfernt den Keks cookie aus dem Jar. Der 
                           Wert von value ist egal. Liefert bei 
                           erfolgreicher Entfernung "CJar_OK", sonst 
                           einen anderen Wert.
                           Ist nur Verfügbar, wenn die System- 
                           erweiterung Liberty (Cookie 'Lity') 
                           installiert ist.
                cookie     Cookiebezeichnung
                value      Adresse des Puffers, in dem die Daten 
                           abgelegt werden sollen.

 Ergebnis:     Im Erfolgsfall liefert die Funktion den Wert CJar_OK 
               (0x6172) zurück.

 Verfügbar     Die Funktion ist verfügbar, wenn der Cookie 'CJar' 
               ($434A6172) vorhanden ist. Dieser wird von JARxxx 
               (Cookie Jar Manager) oder Liberty erzeugt.

 Gruppe:       Spezialbefehle

 Querverweis:  Binding   Cookie Funktionen