Execute
| Formát: | [EXECUTE] <soubor> [{argumenty}] |
| Šablona: | Žádná |
| Účel: | Spouští dávkové soubory |
| Cesta: | C:EXECUTE |
Příkazem EXECUTE se spouštějí dávkové soubory AmigaDOSu. Dávkové soubory se pak zpracovávají stejně jako příkazy zadané interaktivně z klávesnice. Za určitých okolností příkaz EXECUTE nemusíte vůbec používat. Když totiž dávkovému souboru nastavíte stavový bit "s", můžete ho spustit jeho jménem jako každý jiný příkaz.
V dávkových souborech lze použít nahrazení parametrů použitím klíčových slov. Jejich prostřednictvím můžete předat dané proměnné dávkovému souboru. Před spuštěním dávkového souboru, AmigaDOS zkontroluje názvy parametrů v dávkovém souboru na základě argumentů zadaných v příkazovém řádku. Pokud nastane shoda, AmigaDOS nahradí hodnoty zadané v příkazovém řádku jménem parametru v dávkovém souboru. Lze také nastavit výchozí hodnoty pro AmigaDOS, které se použijí, pokud nejsou vybrány žádné proměnné. Pokud jste neurčili žádnou proměnnou a v dávkovém souboru není nastavena žádná výchozí hodnota, pak je hodnota parametru prázdná. Příkaz EXECUTE se obvykle stane rezidentní během spouštěcí startovací sekvence.
Přípustná klíčová slova pro nahrazení parametrů jsou vysvětlena níže. Každé klíčové slovo musí být opatřeno tečkou (.).
Klíčové slovo .KEY (nebo .K) upřesňuje jak názvy tak i pozice klíčových slov v dávkovém souboru. Říká příkazu EXECUTE, kolik parametrů lze očekávat a jak je interpretovat. Jinými slovy, .KEY slouží jako šablona pro hodnoty parametrů, které zadáte. Pro každý dávkový soubor je povoleno pouze jedno klíčové slovo .KEY. Pokud je přítomno, mělo by být na prvním řádku v souboru.
Argumenty na řádku .KEY lze zadat pomocí směrnic /A a /K, které fungují stejně jako v AmigaDOSšabloně. Argumenty následované /A jsou povinné. Argumenty následované /K vyžadují název tohoto argumentu jako klíčové slovo. Například, pokud dávkový soubor začíná klíčovým slovem .KEY soubor /A, znamená to, že název souboru musí být uveden na příkazovém řádku příkazu EXECUTE za názvem dávkového souboru. Název tohoto souboru pak bude nahrazen v následujících řádcích dávkového souboru. Například pokud je první řádek dávkového souboru:
| .KEY filename/A, TOname/K |
Musíte zadat proměnnou názvu souboru. Proměnná TOname je volitelná, ale pokud je zadána, musí být použito klíčové slovo TOname. Například:
| 1> EXECUTE Script Textfile TOname NewFile |
Před spuštěním, AmigaDOS prohledá dávkový soubor pro všechny položky uzavřené znaky BRA a KET (< a >). Takové položky se mohou skládat z klíčového slova nebo klíčového slova a výchozí hodnoty. Kdekoli příkaz EXECUTE najde klíčové slovo uzavřené v hranatých závorkách, pokusí se je nahradit parametrem.
Pokud však chcete v dávkovém souboru použít řetězec, který obsahuje úhlové závorky, budete muset pomocí příkazů .BRA a .KET definovat náhradní znaky „bracket"
Příkaz .BRA <ch> změní znak úvodní závorky na <ch>, zatímco .KEY změní znak závěrečné závorky na <ch>. Například:
| .KEY filename ECHO "This line does NOT print <angle> brackets." .BRA { .KET } ECHO "This line DOES print <angle> brackets." ECHO "The specified filename is{filename}." |
by vedlo k následujícímu výstupu:
| 1> EXECUTE script TestFile This line does NOT print brackets. This line DOES print <angle> brackets. The specified filename is TestFile. |
AmigaDOS poskytuje celou řadu příkazů, které jsou užitečné v dávkových souborech, jako například IF, ELSE, SKIP, LAB a QUIT. Tyto příkazy, stejně jako příkaz EXECUTE, lze vnořit do dávkového souboru.
Chcete-li zastavit provádění dávkového souboru, stiskněte klávesovou kombinaci Ctrl - D. Pokud máte vnořené dávkové soubory, můžete zastavit sadu EXECUTE příkazů stisknutím kláves Ctrl - C. Kombinace Ctrl - D zastaví pouze provádění aktuálního dávkového souboru. Na aktuální číslo Shellu lze odkazovat znaky <$$>. To je užitečné při vytváření jedinečných dočasných souborů, logických přiřazení a PIPE názvů.
Směrnice
Následující direktivy se mohou objevit na samém začátku dávkového souboru. Všimněte si, že ve skutečnosti musí být uvedeny na úplně prvních řádcích dávkového souboru, aby byly rozpoznány.
| Directiva | Význam |
|---|---|
| .KEY (.K) | Určuje šablonu příkazu, pomocí které by měl být tento dávkový soubor vyvolán. Parametry zadané v šabloně budou zpřístupněny v dávkovém souboru pomocí nahrazení klíčových slov. Počet podporovaných parametrů je omezen (v současné době na 100). |
| .DEF (.DEFAULT) | Výchozí parametry, které mají být dávkovému souboru předány, pokud neposkytlžádnéuživatel. Počet výchozích parametrů je omezený. |
| .BRA | Nahrazuje znak otevírací závorky (<), jak se používá k označení klíčových slov v dávkovém souboru, které by měly být nahrazeny. |
| .KET | Nahrazuje znak uzavírací závorky (>), jak se používá k označení klíčových slov v dávkovém souboru, které by měly být nahrazeny. |
| .DOLLAR | Nahrazuje znak dolaru ($) používaný v dávkových souborech k získání čísla aktuálního CLI. |
| .DOT | Nahrazuje znak tečky (.), který zavádí direktivu shellového skriptu, například jako samotný .DOT. |
| .ESC | Vybere znak "escape", který lze použít k ochraně řádků dávkového souboru před přepracováním příkazem EXECUTE. To může být užitečné například v případě, že znaky .BRA a .KET jsou stejné jako složené závorky, které obklopují názvy proměnných prostředí. |
Náhrada klíčových slov
Příkaz EXECUTE dokáže nahradit klíčová slova v dávkovém souboru, které odpovídají zadaným parametrům .KEY. Způsob, jakým tato náhrada probíhá, závisí na typu parametru:
SWITCH/S
Pokud nebyl zadán parametr přepínače, bude nahrazený řetězec prázdný, jinak to bude samotné klíčové slovo.
Příklad:
Dávkový soubor obsahuje:
| .KEY SWITCH/S Echo Switch is "<SWITCH>" |
Zadáním příkazu „execute script_file SWITCH“ zobrazí toto:
| Switch is SWITCH |
Zadáním příkazu „execute script_file“ zobrazí toto:
| Switch is |
TOGGLE/T
Pokud byl přepínací parametr nastaven na FALSE, NO, 0 atd., bude nahrazený řetězec prázdný, jinak to bude samotné klíčové slovo.
Příklad:
Dávkový soubor obsahuje:
| .KEY TOGGLE/T Echo Toggle is "<TOGGLE>" |
Zadáním příkazu "execute script_file TOGGLE=YES" se zobrazí toto:
| Toggle is TOGGLE |
Zadáním příkazu "execute script_file TOGGLE=NO" se zobrazí toto:
| Toggle is |
NUMBER/N
Pokud byl zadán parametr number, bude nahrazeným řetězcem číslo, jinak bude prázdné.
Příklad:
Dávkový soubor obsahuje:
| .KEY NUMBER/N Echo Number is "" |
Zadáním příkazu "execute script_file NUMBER=123" se zobrazí toto:
| Number is 123 |
Zadáním příkazu "execute script_file" se zobrazí toto:
| Number is |
MULTIPLE/M
Pokud byly zadány nějaké parametry, bude nahrazeným řetězcem seznam parametrů oddělený mezerami, jinak bude prázdný. Pokud některý z parametrů obsahuje mezery, budou uzavřeny do dvojitých uvozovek.
Příklad:
Dávkový soubor obsahuje:
| .KEY MULTIPLE/M Echo Multiple is "" |
Zadáním příkazu "execute script_file MULTIPLE abc def ghi" se zobrazí toto:
| Multiple is abc def ghi |
Zadáním příkazu "execute script_file" se zobrazí toto:
| Multiple is |
TEXT
Pokud byl zadán textový parametr, bude nahrazeným řetězcem text, jinak bude prázdný.
Příklad:
Dávkový soubor obsahuje:
| .KEY TEXT Echo Text is "" |
Zadáním příkazu "execute script_file TEXT=abc123" se zobrazí toto:
| Text is abc123 |
Zadáním příkazu "execute script_file" se zobrazí toto:
| Text is |
Vestavěná náhrada klíčových slov
Některá speciální klíčová slova v dávkovém souboru jsou rozšířena samotným příkazem EXECUTE. Všimněte si, že pro nahrazení klíčových slov, i když dávkový soubor nevyžaduje parametr příkazového řádku, musíte použít direktivu .KEY nebo .K v úvodní části dávkového souboru. Pokud tak neučiníte, nefungují ani integrované náhrady klíčových slov.
$$
Tímto se nahrazuje aktuální číslo shellu.
Příklad:
Dávkový soubor obsahuje:
| .KEY ignore_me Echo Shell number is <$$> |
Zadáním příkazu "execute script_file" se zobrazí například toto:
| Shell number is 10 |
Všimněte si, že je mnohem pohodlnější místo toho použít proměnnou prostředí $Process.
_ExecuteVersion
Nahrazuje číslo verze příkazu EXECUTE zpracovávajícím soubor shellu.
Příklad:
Dávkový soubor obsahuje:
| .KEY ignore_me Echo Execute version is <_ExecuteVersion> |
Zadáním příkazu "execute script_file" se zobrazí například toto:
| Execute version is 51.49 |
_ExecuteVersion
Nahrazuje číslo verze příkazu EXECUTE zpracovávajícím soubor shellu.
Příklad:
Dávkový soubor obsahuje:
| .KEY ignore_me Echo Execute version is <_ExecuteVersion> |
Zadáním příkazu "execute script_file" se zobrazí například toto:
| Execute version is 51.49 |
Příklad:
Předpokládejme, že dávkový soubor obsahuje následující:
| .K filename RUN COPY TO PRT: + ECHO "Printing of done" |
Následující příkaz:
| 1> EXECUTE List Test/Prg |
se chová, jako byste na klávesnici zadali následující příkazy:
| 1> RUN COPY Test/Prg TO PRT: + 1> ECHO "Printing of Test/Prg done" |
Další příklad, Display, používá více funkcí popsaných výše:
| .Key name/A IF EXISTS <název> TYPE <název> NUMBER ;if the file is in the given directory, ;type it with line numbers ELSE ECHO "<název>" is not in this directory" ENDIF |
Příkaz:
| 1> RUN EXECUTE Display Work/Prg2 |
by měl zobrazit soubor Work/Prg2 s čísly řádků na obrazovce, pokud existuje v zadaném adresáři. Pokud tam daný soubor není, zobrazí se chybová zpráva. Z důvodu /A, pokud není zadán název souboru po příkazu Display, dojde k chybě.
