Tekst źródłowy strony NOTE

'''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:''' <code>NOTE #''iocb'',''sector'',''byte''</code>

'''Kod w asemblerze:'''

<code>
     ldx #''iocb''*16
     lda #38
     sta iccmd,x
     jsr [[Tablica skoków#JCIOMAIN|jciomain]]
</code>

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 [[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</code> wskazanego kanału ''iocb'' zostanie zapisany numer sektora (w kolejności bajtów, odpowiednio: młodszy, starszy), a w <code>icax5</code> numer bajtu w sektorze.

[[Kategoria:Niezbędnik kodera]]