
Vadí ti chudé editační funkce ZX BASICu? Musíš často sahat
po BASIC extenderech nebo toolkitech? Používáš z podobných
různých důvodů některou z upravených ZX BASIC ROM a občas
musíš řešit, zda a jak je kompatibilní s originálem, resp.
proč s ní některý program nefunguje?

Zkus to jinak: použij esxDOS, který nabízí systémové
příkazy s řadou nových funkcí. Přesně takových, které jsi
postrádal a musel proto používat nestandardní úpravy ROM
nebo rozšíření zabírající místo v paměti. S moderním
esxDOSem nepřijdeš ani o kousek standardní paměti a máš
zaručen soulad s originální ROM.

Rozšíření esxDOSu najdete na webstránce esxdos.zxfiles.net.

------------------------------------------------------------
Příkaz .DEL pro esxDOS                                  2026
------------------------------------------------------------

.DEL je tzv. tečkový příkaz, uložený v adresáři BIN na SD
kartě a spouštěný z editačního řádku BASICu ZX Spectra.
Dělá úplně jednoduchou věc - maže řádky BASICovského
programu. Je podobný standardnímu editorovému mazání řádků,
jen to dokáže udělat hromadně - jedním příkazem zruší celý
rozsah, nebo třeba každý druhý řádek od X do Y. Tam, kde bys
v editoru musel jednotlivá čísla řádků opisovat a mačkat
ENTER, nyní napíšeš .DEL 100 200 a máš vystaráno.

.DEL se chová stejně, jako kdyby tu práci dělal samotný
BASIC editor: hledá adresu řádku podle čísla, provádí posun
na další řádek programu, maže bajty z paměti a po provedeném
výmazu posouvá všechny systémové ukazatele (VARS, E-LINE,
STKBOT, STKEND atd.).


Co se stane, když zadáš řádek, který v programu není?
------------------------------------------------------------
Pravidlo u .DEL zní: zadané hraniční řádky vůbec nemusejí
v programu existovat. Příkaz si sám najde, co je k mání.
Když napíšeš .DEL 100 200 a v programu jsou řádky 50, 150 a
250, smaže se řádek 150, řádky 50 a 250 zůstávají. Když
napíšeš .DEL 9000 a v programu je nejvyšší řádek 500: vrátí
"No lines in given range".


Styl příkazu
------------------------------------------------------------
Příkaz rozumí dvěma konvencím, které se dají i míchat.

1. Parametry oddělené čárkou nebo středníkem (oba znaky
znamenají totéž). Mezery místo nebo navíc oddělovače fungují
stejně, takže mezi .DEL 100 200 5 a .DEL 100,200;5 není
rozdíl.

2. Tokenový zápis: .DEL <first> TO <last> STEP <step>
Stejně jako v BASICu se klíčová slova TO a STEP vkládají
z klávesnice pomocí SYMB+F a SYMB+D. Když je napíšeš jako
dvě/čtyři písmena, parser je neuvidí a nahlásí chybu -
vyžaduje se opravdický BASICovský token.

Oba styly se dají kombinovat: .DEL 100 TO 200,5 je legální
stejně jako .DEL 100,200 STEP 5. Hodnoty se vždy
interpretují podle pozice nebo tokenu. Bez TO a STEP platí,
že první číslo je <first>, druhé <last>, třetí <step>.


Oddělovače - umějí doplnit chybějící hodnotu
------------------------------------------------------------
Tady se .DEL snaží být chytrý (smart). Když před čárku nebo
středník nedáš parametr, příkaz si tam doplní rozumnou
výchozí hodnotu - číslo prvního, resp. posledního řádku
programu.

Pravidla doplňování jsou následující:
a) prázdné místo před prvním oddělovačem -first se nahradí
číslem prvního existujícího řádku programu
b) prázdné místo před druhým oddělovačem - last se nahradí
číslem posledního existujícího řádku

Pár konkrétních příkladů:
.DEL ;40         smaže od prvního řádku do 40,
.DEL 100,        smaže od 100 do konce programu 
.DEL ,           celý program (start=first, end=do konce),

Když dáš .DEL N bez ničeho dalšího, smaže se právě jen N.
.DEL 100 a .DEL 100, se tedy chovají odlišně. Bez
oddělovače je end implicitně rovno start), kdežto
s jakýmkoliv oddělovačem (i samotnou koncovou čárkou) je
end implicitně "do konce".


Krok (STEP / třetí poziční číslo)
------------------------------------------------------------
Když je zadaný krok, příkaz se přepne ze souvislého mazání
do "pruhové" mazání. Místo aby ustřihnul jeden blok
najednou, prochází rozsah řádek po řádku a maže jen ty,
jejichž pozice v rozsahu odpovídá kroku. Krok musí být
v rozsahu 1 až 16382. Krok 1 dává totéž co souvislý režim.

.DEL ,40 STEP 5  každý řádek s přírůstkem pěti od začátku
                   programu po 40,
.DEL 100,;2      každý řádek (+2) od 100 do konce,
.DEL ,,2         každý řádek (+2) celého programu.


Test mód (-n jako no-op, no-operation)
------------------------------------------------------------
Když mezi .DEL a parametry vrazíš přepínač -n (nebo -N),
příkaz nic nemaže a jen spočítá, kolik řádků by smazal,
kdyby běžel naostro. Pak oznámí výsledek hláškou "Would
delete ..lines". Před skutečným mazáním tedy uvidíš, co tě
čeká :-)


Rozsah čísel řádků
------------------------------------------------------------
Nulový řádek je obvykle vytvářen pomocí POKE. .DEL 0 ti ho
pomůže snadno vyzmizíkovat.

V paměti BASICu může být číslo řádku uloženo v rozsahu 0 až
16383. Standardní Sinclair ROM BASIC ale dovoluje zadat (a
zobrazit) jen řádky 0 až 9999. Některé pozdější patche
ROM toto omezení uvolnily a využívají rozsah až do 16383.
.DEL byl napsán tak, aby fungoval s maximálním rozsahem.
Přijímá a kontroluje celý rozsah 0 až 16383. Hláška "Line
out of range" se tedy vztahuje k této horní mezi. Hranici
číslování ale určuje BASIC ROM, s níž esxDOS běží.


Chybové hlášky
------------------------------------------------------------
Když spustíš .DEL bez argumentů, dostaneš krátký výpis
nápovědy.

Když napíšeš nesmysl, tj. v parametrech se objeví znak,
který tam nepatří (písmeno na místě čísla, neznámý token,
duplicitní TO, čtvrtý poziční argument apod.) příkaz se
vrátí s autentickou Sinclair hláškou Nonsense in BASIC -
takovou, kterou by BASIC vypsal, kdybys napsal LET 5 = ABC.

Nová hlášení jsou:

  Line out of range (0..16383) - některé číslo přesahuje
                                 14bitový rozsah,
  Step out of range (1..16382) - neplatná hodnota kroku,
  Bad range: end before start  - end je menší než start
  No lines in given range      - rozsah je sice formálně
                                 platný, ale neobsahuje ani
                                 jeden existující řádek
                                 (nebo je program prázdný).


Co .DEL nedělá a neumí
------------------------------------------------------------
* Nemaže basicové proměnné, nesahá na nic mimo SYSVARS a
program (oblast od PROG po VARS).
* Nepoužívá ramtop ani buffer souborového systému.
* Nepoužívá vlastní paměť v ZX oblasti; pracuje výhradně se
systémovými proměnnými ZX Spectrum BASICu.
* Nepamatuje si minulé příkazy, neumí undo - smazaný řádek
je opravdu pro .DEL navždy smazaný.
* Pokud pracuješ s hexadecimálním číslem řádku, musíš jej
pro .DEL převést sám do decimálního tvaru.


<end>
esxDOS, with love...
