TELL: Różnice pomiędzy wersjami

Z Atariki
Przejdź do nawigacji Przejdź do wyszukiwania
mNie podano opisu zmian
Nie podano opisu zmian
Linia 3: Linia 3:
'''Dostępność:''' [[SpartaDOS]] ([[Real.DOS]]), [[SpartaDOS X]]
'''Dostępność:''' [[SpartaDOS]] ([[Real.DOS]]), [[SpartaDOS X]]


'''Składnia [[BASIC]]-a:''' NOTE #''iocb'',X,Y:POS=X+65536*Y
'''Składnia [[BASIC]]-a:''' <code>NOTE #''iocb'',X,Y:POS=X+65536*Y</code>


'''Kod w asemblerze:'''
'''Kod w asemblerze:'''
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. Para funkcji TELL/[[SEEK]] w SpartaDOS będzie działać tak jak NOTE i [[POINT]] w innych DOS-ach tylko wtedy, kiedy POINT zostanie używane do ponownego ustawiania pozycji odczytanej poprzednio przez NOTE.
'''Uwagi:''' ta funkcja SpartaDOS-u jest '''niezgodna''' z funkcją [[NOTE]] zaimplementowaną we wszystkich innych DOS-ach. Para funkcji TELL/[[SEEK]] w SpartaDOS będzie działać tak jak NOTE i [[POINT]] w innych DOS-ach tylko wtedy, kiedy SEEK będzie używane do ponownego ustawiania pozycji odczytanej poprzednio przez TELL.


'''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, 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 29 sie 2009, 01:24

Przeznaczenie: Funkcja DOS-u zwracająca bieżącą pozycję odczytu/zapisu w pliku, liczoną względem początku tego pliku. Innymi słowy, ta pozycja 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 w SpartaDOS będzie działać tak jak NOTE i POINT w innych DOS-ach tylko wtedy, kiedy SEEK będzie używane do ponownego ustawiania pozycji odczytanej poprzednio przez TELL.

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, 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.