############################################################################### ## ## ## M M ll tt ii RRRRR ## ## MM MM ll tt RR RR ## ## MMM MMM uu uu ll ttttt ii RR RR eeee qqqqq ## ## MMMMMMM uu uu ll tt ii RRRRR ee ee qq qq ## ## MM M MM uu uu ll tt ii RR RR eeeeee qq qq ## ## MM MM uu uu ll tt ii RR RR ee qqqqq ## ## MM MM uuuuu ll ttt ii RR RR eeee qq ## ## qq ## ## ## ############################################################################### MultiReq v1.20 © 11/1992 by Andreas Krebs (veröffentlicht am 12-Nov-92) Diese Datei enthält eine ausführliche Beschreibung aller Funktionen der "multireq.library". Die Funktionen werden in der Reihenfolge ihrer Offsets aufgelistet. Alle diese Funktionen verändern NUR die Register, die unter Ergebnisse aufgelistet aufgelistet sind und eventuel D0 als Rückgaberegister. Alle anderen Register werden nicht verändert, auch wenn sie zur Parameterübergabe benützt werden. multireq.library/StrLen multireq.library/StrLen NAME StrLen -- ermittelt die Länge eines Textstrings SYNTAX length = StrLen( str ) D0 -30 A0 UWORD StrLen( UBYTE * ) FUNKTION Diese Funktion ermittelt die Länge eines Textstrings, wobei die Länge ohne das abschließende Nullbyte gezählt wird. EINGABEN str - Zeiger auf einen nullterminierten String ERGEBNISSE length - Länge des Strings in Bytes A0 - Adresse des abschließenden Nullbytes SIEHE AUCH StrCpy, StrCmp, StrIns, UpperCase, TestPattern multireq.library/StrCpy multireq.library/StrCpy NAME StrCpy -- kopiert den einen Textstring SYNTAX StrCpy( src, dest ) -36 A0 A1 void StrCpy( UBYTE *, UBYTE * ) FUNKTION Diese Funktion kopiert den Textstring src in den Textstring dest, wobei der Kopiervorgang beendet wird, wenn das abschließende Nullbyte erreicht ist. EINGABEN src - Zeiger auf den nullterminierten Quellenstring dest - Zeiger auf einen Adressbereich für den Zielstring ERGEBNISSE A0 - Adresse des abschließenden Nullbytes des Quellenstrings A1 - Adresse des abschließenden Nullbytes des Zielstrings SIEHE AUCH StrLen, StrCmp, StrIns, UpperCase, TestPattern multireq.library/StrCmp multireq.library/StrCmp NAME StrCmp -- vergleicht zwei Textstrings SYNTAX dif = StrCmp( str1, str2 ) D0 -42 A0 A1 WORD StrCmp( UBYTE *, UBYTE * ) FUNKTION Diese Funktion vergleicht zwei Textstrings miteinander, wobei nicht zwischen Groß- und Kleinschreibung unterschieden ist. Wenn dif < 0 ist, ist String str1 "kleiner" als String str2, d.h. der ASCII- code von str1 ist niedriger als der von str2. Wenn dif = 0 ist, sind str1 und str2 identisch. Wenn dif > 0 ist, ist str1 "größer" als str2. EINGABEN str1 - Zeiger auf den ersten nullterminierten String str2 - Zeiger auf den zweiten nullterminierten String ERGEBNISSE dif - Unterschied zwischen str1 und str2 A0 - Adresse des unterschiedlichen Zeichens in str1 A1 - Adresse des unterschiedlichen Zeichens in str2 SIEHE AUCH StrLen, StrCpy, StrIns, UpperCase, TestPattern multireq.library/StrIns multireq.library/StrIns NAME StrIns -- fügt einen TextString in einen anderen ein SYNTAX StrIns( src, dest ) -48 A0 A1 void StrIns( UBYTE *, UBYTE * ) FUNKTION Diese Funktion fügt einen Textstring in einen anderen ein, dazu wird zunächst der Zielstring dest um StrLen( src ) verschoben und anschließend wird src in die entstandene Lücke eingefügt. EINGABEN src - Zeiger auf den einzufügenden String dest - Zeiger auf die Position, an der der String eingefügt werden soll ERGEBNISSE SIEHE AUCH StrLen, StrCpy, StrCmp, UpperCase, TestPattern multireq.library/UpperCase multireq.library/UpperCase NAME UpperCase -- wandelt einen Buchstaben in Großbuchstaben um SYNTAX character = Uppercase( character ) D0 -54 D0 UBYTE UpperCase( UBYTE ) FUNKTION Diese Funktion wandelt das angegeben Zeichen in einen Großbuchstaben um, sofern es sich um einen Buchstaben handelt. Es werden auch Sonderzeichen wie Umlaute berücksichtigt. EINGABEN character - der umzuwandelnte Buchstabe ERGEBNISSE character - der entsprechende Großbuchstabe SIEHE AUCH StrLen, StrCpy, StrCmp, StrIns, TestPattern multireq.library/TestPattern multireq.library/TestPattern NAME TestPattern -- überprüft, ob ein String einem bestimmten Muster entspricht SYNTAX result = TestPattern( wild, str ) D0 -60 A0 A1 BOOL TestPattern( UBYTE *, UBYTE * ) FUNKTION Diese Funktion überprüft, ob der Textstring str, dem durch den Musterstring wild definierten Muster entspricht, wobei das Zeichen '*' für einen beliebig langen Teilstring steht und '|' zwei Muster voneinander trennt. Bei der Überprüfung wird nicht zwischen Groß- und Kleinschreibung unter- schieden, weshalb z.B. "a*" identisch ist mit "A*". EINGABEN wild - Zeiger auf einen String, der das Muster enthält str - Zeiger auf den zu überprüfenden String ERGEBNISSE result - TRUE (1), wenn der String dem Muster entspricht, oder FALSE (0) sonst BEISPIELE TestPattern( "*.c|*.h", str ) - ist str ein C Source- or Include-File ? TestPattern( "*.*|*-*", str ) - enthält str ein '.'- oder '-'-Zeichen ? TestPattern( "*", str ) - immer TRUE, da jeder String diesem Muster entspricht SIEHE AUCH StrLen, StrCpy, StrCmp, StrIns, UpperCase multireq.library/DelPort multireq.library/DelPort NAME DelPort -- löscht einen Message Port SYNTAX DelPort( port ) -66 A1 void DelPort( struct MsgPort * ) FUNKTION Diese Funktion löscht einen Message Port, dazu wird dieser aus der Betriebs- systemliste der Message Ports entfernt und anschließend wird der belegte Speicher wieder freigegeben. EINGABEN port - Zeiger auf die MsgPort-Struktur des Message Ports ERGEBNISSE BEMERKUNGEN Diese Funktion ist identisch mit der DeletePort-Funktion der Linkerlibrary amiga.lib. SIEHE AUCH CrtPort multireq.library/CrtPort multireq.library/CrtPort NAME CrtPort -- erzeugt einen Message Port SYNTAX port = CrtPort( name, pri ) D0 -72 A0 D0 struct MsgPort *CrtPort( UBYTE *, UWORD ) FUNKTION Diese Funktion erzeugt einen Message Port mit dem angegebenen Namen und der ausgewählten Priorität, wobei der Benötigte Speicher reserviert wird. Wenn der Message Port erzeugt ist, wird er automatisch in die Betriebssystemliste der Message Ports eingefügt. EINGABEN name - Zeiger auf einen nullterminierten String mit dem Namen des Ports oder 0 für keinen Namen pri - Priorität, die der Message Port haben soll ERGEBNISSE port - Zeiger auf die MsgPort-Struktur des Message Ports oder 0, wenn ein Fehler aufgetretten ist BEMERKUNGEN Diese Funktion ist identisch mit der CreatePort-Funktion der Linkerlibrary amiga.lib. SIEHE AUCH DelPort multireq.library/GetCurrentPath multireq.library/GetCurrentPath NAME GetCurrentPath -- ermittelt Namen und Pfad des aktuellen Verzeichnisses SYNTAX GetCurrentPath( bufff ) -78 A0 void GetCurrentPath( UBYTE * ) FUNKTION Diese Funktion ermittelt des Namen und den Pfad des aktuellen Verzeichnisses und schreibt diesen in den durch buff angegeben Puffer. EINGABEN buff - Zeiger auf einen Puffer in den der Namen eingetragen wird ERGEBNISSE multireq.library/DrawBox multireq.library/DrawBox NAME DrawBox -- malt ein Rechteck mit 3D-Effekt SYNTAX DrawBox( rp, x1, y1, x2, y2, col1, col2 ) -84 A1 D0 D1 D2 D3 D4 D5 void DrawBox( struct RastPort *, UWORD, UWORD, UWORD, UWORD, UWORD, UWORD ) FUNKTION Diese Funktion zeichnet ein Rechteck mit 3D-Effekt in der angegebenen Größe, wobei der linke und obene Rand in der Farbe col1 und der rechte und untere Rand in der Farbe col2 gezeichnet wird. EINGABEN rp - Zeiger auf den RastPort in dem gezeichnet werden soll x1 - x-Position der linken oberen Ecke y1 - y-Position der linken oberen Ecke x2 - x-Position der rechten unteren Ecke y2 - y-Position der rechten unteren Ecke col1 - Farbe des linken und oberen Rands col2 - Farbe des rechten und unteren Rands ERGEBNISSE BEMERKUNGEN Es muß unbedingt sichergestellt werden, daß x1