NOTE

From Atariki

Aktualna wersja

Przeznaczenie: Funkcja DOS-u zwracająca bieżącą pozycję odczytu/zapisu w pliku, podaną w postaci numeru sektora i numeru bajtu w sektorze. Innymi słowy, ta pozycja to fizyczne koordynaty następnego bajtu, jaki zostanie odczytany lub zapisany podczas najbliższej operacji I/O na danym pliku.

Dostępność: DOS 1.0, DOS 2.0, DOS 2.5 i pochodne (MyDOS)

Składnia BASIC-a: NOTE #iocb,sector,byte

Kod w asemblerze:

    ldx #iocb*16
    lda #38
    sta iccmd,x
    jsr jciomain
    bmi error
    lda icax3,x
    sta sector
    lda icax4,x
    sta sector+1
    lda icax5,x
    sta byte

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.
• sector - numer sektora przypisanego do pliku. Jest to fizyczny numer sektora dyskietki, a nie numer kolejny sektora w pliku.
• byte - numer bajtu w sektorze

Uwagi: części DOS-ów ten sam kod operacyjny (XIO 38) zajmuje funkcja 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 wskazanego kanału iocb zostanie zapisany numer sektora (w kolejności bajtów, odpowiednio: młodszy, starszy), a w icax5 numer bajtu w sektorze.