https://mirror.atariki.pl/w/index.php?action=history&feed=atom&title=Programowanie%3A_Przerywanie_d%C5%82ugotrwa%C5%82ych_operacji_klawiszem_BREAKProgramowanie: Przerywanie długotrwałych operacji klawiszem BREAK - Historia wersji2026-10-04T22:54:07ZHistoria wersji tej strony wikiMediaWiki 1.46.0https://mirror.atariki.pl/w/index.php?title=Programowanie:_Przerywanie_d%C5%82ugotrwa%C5%82ych_operacji_klawiszem_BREAK&diff=3304&oldid=previmported>Atariki recovery: Reconstructed from archived HTML; see provenance manifest2026-10-01T08:51:48Z<p>Reconstructed from archived HTML; see provenance manifest</p>
<p><b>Nowa strona</b></p><div>[[SpartaDOS X]] posiada mechanizmy pozwalające programiście elegancko obsługiwać sytuacje wyjątkowe.<br />
Służą do tego procedury opisane w 4 rozdziale [http://sdx.atari8.info/index.php?show=en_docs podręcznika programowania] p.t. "Obsługa błędów".<br />
<br />
Zazwyczaj używa się ich przy przechwytywaniu sytuacji wyjątkowych występujących podczas operacji na plikach, jednakże można z powodzeniem wykorzystać ten mechanizm do generowania sytuacji wyjątkowych we własnych procesach.<br />
<br />
Wystarczy ustawić własną obsługę błędu za pomocą '''U_SFAIL''' i z wnętrza własnej procedury wywołać fukcję '''U_FAIL''' z kodem błędu w akumulatorze:<br />
<br />
<pre>protectedroutine:<br />
lda ?catchad<br />
ldx ?catchad+1<br />
jsr U_SFAIL<br />
<br />
jsr routine<br />
<br />
jmp U_XFAIL<br />
<br />
?catchad .dw catchroutine<br />
<br />
catchroutine:<br />
... ;obsługujemy błąd<br />
rts<br />
<br />
;a to procedura generująca błąd<br />
routine:<br />
... ;coś robimy<br />
<br />
lda #ERROR ;i generujemy błąd<br />
jmp U_FAIL<br />
</pre><br />
<br />
W przypadku wygenerowania błędu funkcja '''U_FAIL''' przekazuje sterowanie natychmiast do procedury obsługi, a stan stosu odtwarzany jest tak, aby powrót nastąpił do procedury wywołującej kod zakładający pułapkę - w tym przypadku będzie to punkt wywołujący '''protectedroutine'''.<br />
<br />
'''UWAGA!''' '''U_SFAIL''' w żaden sposób nie raportuje przepełnienia wewnętrznego stosu zarejestrowanych procedur obsługi błędów należy więc pamiętać, iż takich procedur obsługi może być maksymalnie 10.<br />
<br />
== Klawisz BREAK ==<br />
<br />
OS w przypadku naciśnięcia klawisza BREAK powoduje wyzerowanie komórki IRQSTAT ($11). Można więc wykorzystując opisany wyżej mechanizm łatwo zaimplementować funkcjonalność przerywania dowolnego długotrwałego procesu za pomocą wciśnięcia klawisza BREAK.<br />
<br />
W kodzie długotrwałej procedury należy co jakiś czas sprawdzać zawartość IRQSTAT i jeśli została wyzerowana rzucić błąd (np. [[Kody statusowe Atari OS|BREAK KEY ABORT]])<br />
<br />
<pre>routine:<br />
...<br />
jsr erroronbreak<br />
...<br />
rts<br />
<br />
erroronbreak:<br />
lda IRQSTAT<br />
seq<br />
rts<br />
dec IRQSTAT<br />
lda #$80 ;BREAK KEY ABORT<br />
jmp U_FAIL<br />
</pre><br />
<br />
Warto zauważyć, iż po wykryciu wciśnięcia klawisza BREAK wstawiana jest wartość $FF do IRQSTAT. Ustawiana jest ona przez OS podczas normalnej pracy i po obsłudze wciśnięcia klawisza BREAK podczas procedur I/O (procedury edytora ustawiają tam wartość $80 po obsłudze wciśnięcia klawisza BREAK, lub $88 po obsłudze wciśnięcia kombinacji klawiszy CTRL+3).<br />
Jest to o tyle istotne, że funkcje konsoli sprawdzają tę komórkę i również generują błąd wciśnięcia klawisza BREAK, więc brak jej obsługi spowodowałby nieoczekiwane wyrzucenie błędu przy pierwszej próbie użycia np. '''PRINTF''', '''PUTC''', itp.<br />
<br />
Oczywiście ustawianie własnej pułapki przez '''U_SFAIL''' nie jest obowiązkowe. Wyjątek rzucony przez '''U_FAIL''' przechwyci w takiej sytuacji poprzednio zarejestrowana procedura lub w ostateczności systemowa procedura obsługi błędów.<br />
<br />
== Kody błędów ==<br />
<br />
Do '''U_FAIL''' w akumulatorze przekazuje się kod błędu. Kody te dzielone są na dwie logiczne grupy:<br />
<br />
* wartości dodatnie (0..127) oznaczają kody statusu operacji,<br />
* wartości ujemne (128..255, czy też inaczej -128..-1) oznaczają kody błędów.<br />
<br />
W przypadku gdy rzucony wyjątek obsługuje procedura systemowa, wtedy wyłącznie w przypadku wyrzucenia kodu błędu następuje wypisanie komunikatu (wg pliku zdefiniowanego w zmiennej środowiskowej '''$SYSERR''' - standardowo jest to CAR:SYSERR.MSG) na ekran konsoli.<br />
<br />
Jeśli program wywoływany jest z poziomu polecenia wsadowego zwrócony kod statusu można testować za pomocą warunku '''IF ERROR'''. Szczegóły opisane są w 5 rozdziale [http://sdx.atari8.info/index.php?show=en_docs instrukcji użytkownika] p.t. "Command Processor - szersze możliwości".<br />
<br />
[[Kategoria:Programowanie Atari 8-bit]]<br />
[[Kategoria:Niezbędnik kodera]]<br />
</div>imported>Atariki recovery