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.6  appl_getinfo_str                                            TOS

 Name:         »Application get information« - Informationen über 
               vorhandene Funktionsaufrufe und Eigenschaften erfragen.

 AES-Nummer:   130

 Deklaration:  int16_t appl_getinfo_str ( int16_t ap_gtype, int16_t 
               *ap_gout1, int16_t *ap_gout2, int16_t *ap_gout3, 
               int16_t *ap_gout4 );

 Beschreibung: Dies ist eine erweiterte Version von appl_getinfo. 
               Statt der integer Werte liefert sie Zeichenketten 
               zurück.

               ap_gtype bestimmt die Art der Informationen, die 
               erfragt werden sollen. Es bedeutet:

               96: AES Version

                ap_gout1: This is a character string with a fixed 
                          lenght of 8 bytes, into which the AES will 
                          write its unique AES ID. the AES ID is a 
                          left-aligned, space padded string, and can 
                          be considered to be the current AES's short 
                          name. For XaAES this string is filled with " 
                          XaAES". This string is not null-terminated.
                ap_gout2: This is a character buffer that the 
                          application must ensure can take up to 256 
                          (255 + 0 termination) characters. The AES 
                          fills its long name description into this 
                          buffer. Lines in here are delimitted using 
                          CR (ascii 13). For XaAES, this buffer 
                          contains the following after the call;
                          "XaAES Ain't the AES, a free MultiTasking 
                          AES for FreeMiNT"
                ap_gout3: This is a character buffer that the 
                          application must ensure can take up to 256 
                          (255 + 0 termination) characters. The AES 
                          fills this buffer with the following 
                          information where each element is delimitted 
                          by the "|" (ascii 0x7c) character. The 
                          string is constructed as follows;
                          "asci version|development 
                          status|architecture target| build date & 
                          time|compiler used",0
                          Example string returned might be;
                          "0.992|Alpha|m68k|Dec 17 2004 22:58:52|gcc 
                          2.95.3",0
                ap_gout4: reserved, set to NULL.

               Hinweis: Ein Problem dieser Funktion besteht darin, 
               festzustellen, wann sie überhaupt aufgerufen werden 
               darf. Zwar sollte sie ab AES-Version 4.0 vorhanden 
               sein, MagiC 2.0 (und auch MagiC 3.0) besitzt aber 
               beispielsweise die Version 3.99. Aus diesem Grund 
               definieren viele Programmierer die Funktion 
               appl_xgetinfo, in der überprüft wird, ob appl_getinfo 
               in der aktuellen Systemumgebung vorhanden ist.

 Ergebnis:     Ein Rückgabewert von 0 zeigt einen Fehler an; bei einem 
               Wert von 1 ist kein Fehler aufgetreten.

 Verfügbar:    since XaAES from 2004-12-18

 Gruppe:       Applikationen

 Querverweis:  Binding   appl_getinfo