TELL
From Atariki
Wersja z dnia 22:08, 28 sie 2009 KMK (Dyskusja | wkład) ← Previous diff |
Wersja z dnia 22:44, 28 sie 2009 KMK (Dyskusja | wkład) Next diff → |
||
Linia 11: | Linia 11: | ||
lda #38 | lda #38 | ||
sta iccmd,x | sta iccmd,x | ||
- | jsr jciomain | + | jsr [[Tablica skoków#JCIOMAIN|jciomain]] |
</code> | </code> | ||
Linia 18: | Linia 18: | ||
* ''iocb'' - numer kanału [[IOCB]] z zakresu od 1 do 7. Kanał ten w chwili wywołania funkcji musi być '''otwarty''' dla danego pliku. | * ''iocb'' - numer kanału [[IOCB]] z zakresu od 1 do 7. Kanał ten w chwili wywołania funkcji musi być '''otwarty''' dla danego pliku. | ||
- | '''Uwagi:''' ta funkcja SpartaDOS-u jest '''niezgodna''' z funkcją [[NOTE]] zaimplementowaną we wszystkich innych DOS-ach. | + | '''Uwagi:''' ta funkcja SpartaDOS-u jest '''niezgodna''' z funkcją [[NOTE]] zaimplementowaną we wszystkich innych DOS-ach. Para funkcji TELL/[[SEEK]] będzie działac tak jak NOTE i [[POINT]] w innych DOS-ach tylko w przypadku, kiedy POINT zostanie użyte do ponownego ustawienia pozycji odczytanej poprzednio przez NOTE. |
'''Zwracana wartość:''' Procedura zwraca w rejestrze Y ujemny [[Kody błędów Atari OS|kod błędu]] albo wartość $01 w przypadku powodzenia, oraz odpowiednio do tego ustawia znacznik N rejestru znaczników. W przypadku powodzenia w <code>icax3, icax4 i icax5</code> wskazanego kanału ''iocb'' zostanie zapisana 24-bitowa liczba (w kolejności bajtów,odpowiednio: młodszy, starszy, najstarszy) oznaczająca bieżącą pozycję odczytu lub zapisu w pliku. | '''Zwracana wartość:''' Procedura zwraca w rejestrze Y ujemny [[Kody błędów Atari OS|kod błędu]] albo wartość $01 w przypadku powodzenia, oraz odpowiednio do tego ustawia znacznik N rejestru znaczników. W przypadku powodzenia w <code>icax3, icax4 i icax5</code> wskazanego kanału ''iocb'' zostanie zapisana 24-bitowa liczba (w kolejności bajtów,odpowiednio: młodszy, starszy, najstarszy) oznaczająca bieżącą pozycję odczytu lub zapisu w pliku. | ||
[[Kategoria:Niezbędnik kodera]] | [[Kategoria:Niezbędnik kodera]] |
Wersja z dnia 22:44, 28 sie 2009
Przeznaczenie: Funkcja DOS-u zwracająca bieżącą pozycję odczytu/zapisu w pliku, liczoną względem początku tego pliku. Innymi słowy, jest to numer następnego bajtu, jaki zostanie odczytany lub zapisany podczas najbliższej operacji I/O na danym pliku.
Dostępność: SpartaDOS (Real.DOS), SpartaDOS X
Składnia BASIC-a: NOTE #iocb,X,Y:POS=X+65536*Y
Kod w asemblerze:
ldx #iocb*16 lda #38 sta iccmd,x jsr jciomain
gdzie:
- iocb - numer kanału IOCB z zakresu od 1 do 7. Kanał ten w chwili wywołania funkcji musi być otwarty dla danego pliku.
Uwagi: ta funkcja SpartaDOS-u jest niezgodna z funkcją NOTE zaimplementowaną we wszystkich innych DOS-ach. Para funkcji TELL/SEEK będzie działac tak jak NOTE i POINT w innych DOS-ach tylko w przypadku, kiedy POINT zostanie użyte do ponownego ustawienia pozycji odczytanej poprzednio przez NOTE.
Zwracana wartość: Procedura zwraca w rejestrze Y ujemny kod błędu albo wartość $01 w przypadku powodzenia, oraz odpowiednio do tego ustawia znacznik N rejestru znaczników. W przypadku powodzenia w icax3, icax4 i icax5
wskazanego kanału iocb zostanie zapisana 24-bitowa liczba (w kolejności bajtów,odpowiednio: młodszy, starszy, najstarszy) oznaczająca bieżącą pozycję odczytu lub zapisu w pliku.