SEEK

From Atariki

(Różnice między wersjami)
Jump to: navigation, search

Wersja z dnia 23:19, 28 sie 2009

Przeznaczenie: Funkcja DOS-u ustawiają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 Atari BASIC-a: 10 A=INT(POS/65536) 15 B=INT((POS-A*65536)/256) 20 C=POS-A*65536-B*256 25 POKE 844+iocb*16,C 30 POKE 845+iocb*16,B 35 POKE 846+iocb*16,A 40 XIO 37,#iocb,x1,x2,"D:"

Składnia Turbo BASIC-a XL: POINT #iocb,POS,0

Kod w asemblerze:

    ldx #iocb*16
    lda #37
    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.
  • x1 i x2 powinny mieć takie same wartości jak odpowiednie parametry funkcji OPEN uzytej do otwarcia tego pliku.

Uwagi:

  • żądaną pozycję przekazujemy jako 24-bitowa liczbę w icax3, icax4, icax5 (bajty, odpowiednio: młodszy, starszy, najstarszy).
  • wynik próby ustawienia pozycji poza końcem pliku zależy od trybu dostępu do pliku: przy plikach otwartych do odczytu kończy się błędem, natomiast podczas zapisu jest to akceptowane, aczkolwiek może się skończyć powstaniem pliku nieciągłego (ang. sparse file).
  • ta funkcja SpartaDOS-u jest niezgodna z funkcją POINT 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 zostanie 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.

Personal tools