Wiersz poleceń - Historia wersji

KMK: korekta przykładu i opisu (funkcja była źle opisana przez ICD w podręczniku użytkownika SDX, stąd zamieszanie)

2024-05-28T14:59:19Z

korekta przykładu i opisu (funkcja była źle opisana przez ICD w podręczniku użytkownika SDX, stąd zamieszanie)

← poprzednia wersja		Wersja z 28 maj 2024, 15:59
Linia 53:		Linia 53:
	</pre>		</pre>

	~~W SpartaDOS po wykonaniu~~ tego JSR-a ~~ustawiony bit Z rejestru znaczników CPU (czyli "wynik zerowy") oznacza, że w wierszu poleceń nie ma więcej parametrów. Przeciwny stan tego znacznika znaczy, że~~ parametr ~~został pobrany~~ do bufora COMFNAM znajdującego się pod adresem (DOSVEC)+33. Zawartość COMFNAM zawsze zaczyna się od specyfikacji urządzenia (np. "D:") i zawsze zakończona jest znakiem EOL (ASCII 155), co oznacza że przekazując do programu parametr "DOWOL.TXT" w COMFNAM otrzymamy ciąg "D1:DOWOL.TXT"+EOL.		Wykonanie tego JSR-a pobiera podany parametr do bufora COMFNAM znajdującego się pod adresem (DOSVEC)+33. Zawartość COMFNAM zawsze zaczyna się od specyfikacji urządzenia (np. "D:") i zawsze zakończona jest znakiem EOL (ASCII 155), co oznacza że przekazując do programu parametr "DOWOL.TXT" w COMFNAM otrzymamy ciąg "D1:DOWOL.TXT"+EOL.

	~~W DOS XL procedura~~ pobierania parametru nie sprawdza automatycznie, czy wiersz polecenia już się skończył: program musi to sprawdzić ~~"na piechotę"~~ przez porównanie stanu wskaźnika bufora wejściowego (BUFOFF) sprzed wywołania procedury ze stanem po jej wywołaniu~~. Ta metoda zadziała też pod SpartaDOS~~. A zatem:		Procedura pobierania parametru nie sprawdza automatycznie, czy wiersz polecenia już się skończył: program musi to sprawdzić przez porównanie stanu wskaźnika bufora wejściowego (BUFOFF) sprzed wywołania procedury ze stanem po jej wywołaniu. A zatem:

	<pre>		<pre>
	next ldy #$0a ; *		next ldy #$0a
	lda (dosvec),y ; *		lda (dosvec),y
	pha ; *		pha
	zcr jsr $0000		zcr jsr $0000
	ldy #$0a ; *		ldy #$0a
	pla ; *		pla
	cmp (dosvec),y ; *		cmp (dosvec),y
	beq _no_more_parameters		beq _no_more_parameters

Linia 80:		Linia 80:
	</pre>		</pre>

	~~Wiersze~~ programu ~~oznaczone~~ w ~~komentarzu gwiazdką (*) są zbędne pod SpartaDOS~~, ale ~~nieodzowne~~ dla ~~zgodności z DOS XL~~.		'''UWAGA!''' Nieoczywistym może być, że nazwy urządzeń podawane jako parametry do programu rozwijane są wewnętrznie według konwencji przyjętej przez używany DOS. Tak więc parametr "D:DOWOL.TXT" w DOS XL zostanie rozwinięty do postaci "D1:DOWOL.TXT", ale już Sparta DOS X rozwinie go jako "D4:DOWOL.TXT", a to dlatego że "D:" to dla niego czwarty dysk (począwszy od "A:").

	== SpartaDOS X ==		== SpartaDOS X ==
Linia 88:		Linia 88:

	Opis tego interfejsu znajduje się w [[Przewodnik programisty SpartaDOS X\|Przewodniku programisty SpartaDOS X]], dostępnym [http://sdx.atari8.info/index.php?show=en_docs tutaj] (rozdział 5, "Obróbka wiersza poleceń").		Opis tego interfejsu znajduje się w [[Przewodnik programisty SpartaDOS X\|Przewodniku programisty SpartaDOS X]], dostępnym [http://sdx.atari8.info/index.php?show=en_docs tutaj] (rozdział 5, "Obróbka wiersza poleceń").

	'''UWAGA!''' Nieoczywistym może być, że nazwy urządzeń podawane jako parametry do programu rozwijane są według konwencji przyjętej przez używany DOS. Tak więc parametr "D:DOWOL.TXT" w DOS XL zostanie rozwinięty do postaci "D1:DOWOL.TXT", ale już Sparta DOS X rozwinie go jako "D4:DOWOL.TXT", a to dlatego że "D:" to dla niego czwarty dysk (począwszy od "A:").

	[[Kategoria:Niezbędnik kodera]]		[[Kategoria:Niezbędnik kodera]]

Mono: /* SpartaDOS X */ D: to dla SDX D4:

2022-06-05T11:49:46Z

SpartaDOS X: D: to dla SDX D4:

← poprzednia wersja		Wersja z 5 cze 2022, 12:49
Linia 88:		Linia 88:

	Opis tego interfejsu znajduje się w [[Przewodnik programisty SpartaDOS X\|Przewodniku programisty SpartaDOS X]], dostępnym [http://sdx.atari8.info/index.php?show=en_docs tutaj] (rozdział 5, "Obróbka wiersza poleceń").		Opis tego interfejsu znajduje się w [[Przewodnik programisty SpartaDOS X\|Przewodniku programisty SpartaDOS X]], dostępnym [http://sdx.atari8.info/index.php?show=en_docs tutaj] (rozdział 5, "Obróbka wiersza poleceń").

			'''UWAGA!''' Nieoczywistym może być, że nazwy urządzeń podawane jako parametry do programu rozwijane są według konwencji przyjętej przez używany DOS. Tak więc parametr "D:DOWOL.TXT" w DOS XL zostanie rozwinięty do postaci "D1:DOWOL.TXT", ale już Sparta DOS X rozwinie go jako "D4:DOWOL.TXT", a to dlatego że "D:" to dla niego czwarty dysk (począwszy od "A:").

	[[Kategoria:Niezbędnik kodera]]		[[Kategoria:Niezbędnik kodera]]

Mono: /* Wywołanie funkcji odczytu wiersza poleceń */

2022-06-05T11:37:48Z

Wywołanie funkcji odczytu wiersza poleceń

← poprzednia wersja		Wersja z 5 cze 2022, 12:37
Linia 53:		Linia 53:
	</pre>		</pre>

	W SpartaDOS po wykonaniu tego JSR-a ustawiony bit Z rejestru znaczników CPU (czyli "wynik zerowy") oznacza, że w wierszu poleceń nie ma więcej parametrów. Przeciwny stan tego znacznika znaczy, że parametr został pobrany do bufora COMFNAM znajdującego się pod adresem (DOSVEC)+33. Zawartość COMFNAM zawsze zaczyna się od specyfikacji urządzenia (np. "D:") i zawsze zakończona jest znakiem EOL (ASCII 155), co oznacza że przekazując do programu parametr "DOWOL.TXT" w COMFNAM otrzymamy ciąg "D1:DOWOL.TXT<EOL>".		W SpartaDOS po wykonaniu tego JSR-a ustawiony bit Z rejestru znaczników CPU (czyli "wynik zerowy") oznacza, że w wierszu poleceń nie ma więcej parametrów. Przeciwny stan tego znacznika znaczy, że parametr został pobrany do bufora COMFNAM znajdującego się pod adresem (DOSVEC)+33. Zawartość COMFNAM zawsze zaczyna się od specyfikacji urządzenia (np. "D:") i zawsze zakończona jest znakiem EOL (ASCII 155), co oznacza że przekazując do programu parametr "DOWOL.TXT" w COMFNAM otrzymamy ciąg "D1:DOWOL.TXT"+EOL.

	W DOS XL procedura pobierania parametru nie sprawdza automatycznie, czy wiersz polecenia już się skończył: program musi to sprawdzić "na piechotę" przez porównanie stanu wskaźnika bufora wejściowego (BUFOFF) sprzed wywołania procedury ze stanem po jej wywołaniu. Ta metoda zadziała też pod SpartaDOS. A zatem:		W DOS XL procedura pobierania parametru nie sprawdza automatycznie, czy wiersz polecenia już się skończył: program musi to sprawdzić "na piechotę" przez porównanie stanu wskaźnika bufora wejściowego (BUFOFF) sprzed wywołania procedury ze stanem po jej wywołaniu. Ta metoda zadziała też pod SpartaDOS. A zatem:

Mono: /* Wywołanie funkcji odczytu wiersza poleceń */ naoczny przyklad

2022-06-05T11:37:24Z

Wywołanie funkcji odczytu wiersza poleceń: naoczny przyklad

← poprzednia wersja		Wersja z 5 cze 2022, 12:37
Linia 53:		Linia 53:
	</pre>		</pre>

	W SpartaDOS po wykonaniu tego JSR-a ustawiony bit Z rejestru znaczników CPU (czyli "wynik zerowy") oznacza, że w wierszu poleceń nie ma więcej parametrów. Przeciwny stan tego znacznika znaczy, że parametr został pobrany do bufora COMFNAM znajdującego się pod adresem (DOSVEC)+33. Zawartość COMFNAM zawsze zaczyna się od specyfikacji urządzenia (np. "D:") i zawsze zakończona jest znakiem EOL (ASCII 155).		W SpartaDOS po wykonaniu tego JSR-a ustawiony bit Z rejestru znaczników CPU (czyli "wynik zerowy") oznacza, że w wierszu poleceń nie ma więcej parametrów. Przeciwny stan tego znacznika znaczy, że parametr został pobrany do bufora COMFNAM znajdującego się pod adresem (DOSVEC)+33. Zawartość COMFNAM zawsze zaczyna się od specyfikacji urządzenia (np. "D:") i zawsze zakończona jest znakiem EOL (ASCII 155), co oznacza że przekazując do programu parametr "DOWOL.TXT" w COMFNAM otrzymamy ciąg "D1:DOWOL.TXT<EOL>".

	W DOS XL procedura pobierania parametru nie sprawdza automatycznie, czy wiersz polecenia już się skończył: program musi to sprawdzić "na piechotę" przez porównanie stanu wskaźnika bufora wejściowego (BUFOFF) sprzed wywołania procedury ze stanem po jej wywołaniu. Ta metoda zadziała też pod SpartaDOS. A zatem:		W DOS XL procedura pobierania parametru nie sprawdza automatycznie, czy wiersz polecenia już się skończył: program musi to sprawdzić "na piechotę" przez porównanie stanu wskaźnika bufora wejściowego (BUFOFF) sprzed wywołania procedury ze stanem po jej wywołaniu. Ta metoda zadziała też pod SpartaDOS. A zatem:

KMK o 18:37, 21 cze 2016

2016-06-21T18:37:02Z

← poprzednia wersja		Wersja z 21 cze 2016, 19:37
Linia 87:		Linia 87:
	Programy napisane specjalnie dla SpartaDOS X mają do dyspozycji oddzielny, bardziej wyrafinowany interfejs służący do interpretacji parametrów przekazanych w wierszu polecenia. Składa się nań kilkanaście procedur dostępnych za pośrednictwem [[symbol]]i i zawartych w [[Biblioteka SpartaDOS X\|bibliotece SpartaDOS X]], które nie tylko pobierają z wiersza poleceń kolejne parametry, ale też są w stanie je automatycznie interpretować i przetwarzać (np. liczbę przekazaną w postaci ciągu ASCII na postać 32-bitowej reprezentacji całkowitej).		Programy napisane specjalnie dla SpartaDOS X mają do dyspozycji oddzielny, bardziej wyrafinowany interfejs służący do interpretacji parametrów przekazanych w wierszu polecenia. Składa się nań kilkanaście procedur dostępnych za pośrednictwem [[symbol]]i i zawartych w [[Biblioteka SpartaDOS X\|bibliotece SpartaDOS X]], które nie tylko pobierają z wiersza poleceń kolejne parametry, ale też są w stanie je automatycznie interpretować i przetwarzać (np. liczbę przekazaną w postaci ciągu ASCII na postać 32-bitowej reprezentacji całkowitej).

	Opis tego interfejsu znajduje się w [[Przewodnik programisty SpartaDOS X\|Przewodniku programisty SpartaDOS X]], dostępnym [http://sdx.atari8.info/index.php?show=en_docs tutaj].		Opis tego interfejsu znajduje się w [[Przewodnik programisty SpartaDOS X\|Przewodniku programisty SpartaDOS X]], dostępnym [http://sdx.atari8.info/index.php?show=en_docs tutaj] (rozdział 5, "Obróbka wiersza poleceń").

	[[Kategoria:Niezbędnik kodera]]		[[Kategoria:Niezbędnik kodera]]

KMK o 18:36, 21 cze 2016

2016-06-21T18:36:33Z

← poprzednia wersja		Wersja z 21 cze 2016, 19:36
Linia 81:		Linia 81:

	Wiersze programu oznaczone w komentarzu gwiazdką (*) są zbędne pod SpartaDOS, ale nieodzowne dla zgodności z DOS XL.		Wiersze programu oznaczone w komentarzu gwiazdką (*) są zbędne pod SpartaDOS, ale nieodzowne dla zgodności z DOS XL.

			== SpartaDOS X ==
			[[SpartaDOS X]], jako klon SpartaDOS, oferuje zgodny z powyżej opisanym interfejs programowy, dzięki czemu istnieje zgodność wstecz, a programy napisane dla DOS XL i SpartaDOS są w stanie interpretować wiersz poleceń również wtedy, kiedy zostały uruchomione pod tym DOS-em.

			Programy napisane specjalnie dla SpartaDOS X mają do dyspozycji oddzielny, bardziej wyrafinowany interfejs służący do interpretacji parametrów przekazanych w wierszu polecenia. Składa się nań kilkanaście procedur dostępnych za pośrednictwem [[symbol]]i i zawartych w [[Biblioteka SpartaDOS X\|bibliotece SpartaDOS X]], które nie tylko pobierają z wiersza poleceń kolejne parametry, ale też są w stanie je automatycznie interpretować i przetwarzać (np. liczbę przekazaną w postaci ciągu ASCII na postać 32-bitowej reprezentacji całkowitej).

			Opis tego interfejsu znajduje się w [[Przewodnik programisty SpartaDOS X\|Przewodniku programisty SpartaDOS X]], dostępnym [http://sdx.atari8.info/index.php?show=en_docs tutaj].

	[[Kategoria:Niezbędnik kodera]]		[[Kategoria:Niezbędnik kodera]]

KMK: /* Wykrycie dostępności wiersza poleceń */ styl

2016-06-21T12:25:57Z

Wykrycie dostępności wiersza poleceń: styl

← poprzednia wersja		Wersja z 21 cze 2016, 13:25
Linia 7:		Linia 7:
	=== Wykrycie dostępności wiersza poleceń ===		=== Wykrycie dostępności wiersza poleceń ===

	Nie wszystkie DOS-y zawierają funkcje odczytu wiersza poleceń, jego ~~obecność~~ trzeba zatem wykryć. Standard DOS XL przewiduje, że funkcja odczytu wiersza poleceń jest dostępna, jeśli pod adresem wskazanym przez wektor DOSVEC ($0a), dodać 3, znajduje się rozkaz skoku JMP procesora [[6502]]. Rozkaz ten (w trybie absolutnym) ma kod operacyjny 76 ($4C):		Nie wszystkie DOS-y zawierają funkcje odczytu wiersza poleceń, jego dostępność trzeba zatem wykryć. Standard DOS XL przewiduje, że funkcja odczytu wiersza poleceń jest dostępna, jeśli pod adresem wskazanym przez wektor DOSVEC ($0a), dodać 3, znajduje się rozkaz skoku JMP procesora [[6502]]. Rozkaz ten (w trybie absolutnym) ma kod operacyjny 76 ($4C):

	<pre>		<pre>

KMK o 00:06, 21 cze 2016

2016-06-21T00:06:32Z

← poprzednia wersja		Wersja z 21 cze 2016, 01:06
Linia 1:		Linia 1:
	Część [[DOS]]-ów dla Atari obsługiwana jest za pośrednictwem tzw. [https://pl.wikipedia.org/wiki/Wiersz_polece%C5%84 wiersza poleceń] (ang. ''command line''). Takimi DOS-ami są np. [[OS/A Plus\|OS/A+]], [[DOS XL]], [[SpartaDOS]], [[CP\|DOS 2.5CP]], [[DOS II/D\|DOS II+/D]], [[TopDOS]]. System (na ogół) oferuje przy tym funkcję pozwalającą programowi na w miarę bezbolesny odczyt parametrów podanych przez użytkownika.		Część [[DOS]]-ów dla Atari obsługiwana jest za pośrednictwem tzw. [https://pl.wikipedia.org/wiki/Wiersz_polece%C5%84 wiersza poleceń] (ang. ''command line''). Takimi DOS-ami są np. [[OS/A Plus\|OS/A+]], [[DOS XL]], [[SpartaDOS]], [[BW-DOS]], [[CP\|DOS 2.5CP]], [[DOS II/D\|DOS II+/D]], [[TopDOS]]. System (na ogół) oferuje przy tym funkcję pozwalającą programowi na w miarę bezbolesny odczyt parametrów podanych przez użytkownika.

	== Standard OSS ==		== Standard OSS ==

	Najpopularniejszy standard w tej dziedzinie jest dziełem firmy [[OSS]]. Zgodny z nim interfejs wiersza poleceń zaimplementowano w OS/A+ (czyli DOS XL), a [[ICD]] użyło go w SpartaDOS.		Najpopularniejszy standard w tej dziedzinie jest dziełem firmy [[OSS]]. Zgodny z nim interfejs wiersza poleceń zaimplementowano w OS/A+ (czyli DOS XL), a [[ICD]] użyło go w SpartaDOS. Obsługuje go też BW-DOS - jako klon SpartaDOS.

	=== Wykrycie dostępności wiersza poleceń ===		=== Wykrycie dostępności wiersza poleceń ===

KMK: /* Wywołanie funkcji odczytu wiersza poleceń */

2016-06-20T21:17:39Z

Wywołanie funkcji odczytu wiersza poleceń

← poprzednia wersja		Wersja z 20 cze 2016, 22:17
Linia 53:		Linia 53:
	</pre>		</pre>

	W SpartaDOS po wykonaniu tego JSR-a ustawiony bit Z rejestru znaczników CPU (czyli "wynik zerowy") oznacza, że w wierszu poleceń nie ma więcej parametrów. Przeciwny stan tego znacznika znaczy, że parametr został pobrany do bufora COMFNAM znajdującego się pod adresem (DOSVEC)+33.		W SpartaDOS po wykonaniu tego JSR-a ustawiony bit Z rejestru znaczników CPU (czyli "wynik zerowy") oznacza, że w wierszu poleceń nie ma więcej parametrów. Przeciwny stan tego znacznika znaczy, że parametr został pobrany do bufora COMFNAM znajdującego się pod adresem (DOSVEC)+33. Zawartość COMFNAM zawsze zaczyna się od specyfikacji urządzenia (np. "D:") i zawsze zakończona jest znakiem EOL (ASCII 155).

	W DOS XL procedura pobierania parametru nie sprawdza automatycznie, czy wiersz polecenia już się skończył: program musi to sprawdzić "na piechotę" przez porównanie stanu wskaźnika bufora wejściowego (BUFOFF) sprzed wywołania procedury ze stanem po jej wywołaniu. Ta metoda zadziała też pod SpartaDOS.		W DOS XL procedura pobierania parametru nie sprawdza automatycznie, czy wiersz polecenia już się skończył: program musi to sprawdzić "na piechotę" przez porównanie stanu wskaźnika bufora wejściowego (BUFOFF) sprzed wywołania procedury ze stanem po jej wywołaniu. Ta metoda zadziała też pod SpartaDOS. A zatem:

	~~Zawartość COMFNAM zawsze zaczyna się od specyfikacji urządzenia (np. "D:") i zawsze zakończona jest znakiem EOL (ASCII 155)~~. A zatem:

	<pre>		<pre>

KMK: /* Wywołanie funkcji odczytu wiersza poleceń */ zgodność z DOS XL

2016-06-20T21:14:54Z

Wywołanie funkcji odczytu wiersza poleceń: zgodność z DOS XL

← poprzednia wersja		Wersja z 20 cze 2016, 22:14
Linia 53:		Linia 53:
	</pre>		</pre>

	Po wykonaniu tego JSR-a ustawiony bit Z rejestru znaczników CPU (czyli "wynik zerowy") oznacza, że w wierszu poleceń nie ma więcej parametrów. Przeciwny stan tego znacznika znaczy, że parametr został pobrany do bufora COMFNAM znajdującego się pod adresem (DOSVEC)+33. ~~Jego zawartość~~ zawsze zaczyna się od specyfikacji urządzenia (np. "D:") i zawsze zakończona jest znakiem EOL (ASCII 155). A zatem:		W SpartaDOS po wykonaniu tego JSR-a ustawiony bit Z rejestru znaczników CPU (czyli "wynik zerowy") oznacza, że w wierszu poleceń nie ma więcej parametrów. Przeciwny stan tego znacznika znaczy, że parametr został pobrany do bufora COMFNAM znajdującego się pod adresem (DOSVEC)+33.

			W DOS XL procedura pobierania parametru nie sprawdza automatycznie, czy wiersz polecenia już się skończył: program musi to sprawdzić "na piechotę" przez porównanie stanu wskaźnika bufora wejściowego (BUFOFF) sprzed wywołania procedury ze stanem po jej wywołaniu. Ta metoda zadziała też pod SpartaDOS.

			Zawartość COMFNAM zawsze zaczyna się od specyfikacji urządzenia (np. "D:") i zawsze zakończona jest znakiem EOL (ASCII 155). A zatem:

	<pre>		<pre>
			next ldy #$0a ; *
			lda (dosvec),y ; *
			pha ; *
	zcr jsr $0000		zcr jsr $0000
			ldy #$0a ; *
			pla ; *
			cmp (dosvec),y ; *
	beq _no_more_parameters		beq _no_more_parameters

Linia 66:		Linia 76:
	bne _cp		bne _cp
	... ; tu robimy z parametrem pobranym do bufora "parbuf" to, co potrzebujemy		... ; tu robimy z parametrem pobranym do bufora "parbuf" to, co potrzebujemy
	jmp ~~zcr~~		jmp next

	_no_more_parameters		_no_more_parameters
	...		...
	</pre>		</pre>

			Wiersze programu oznaczone w komentarzu gwiazdką (*) są zbędne pod SpartaDOS, ale nieodzowne dla zgodności z DOS XL.

	[[Kategoria:Niezbędnik kodera]]		[[Kategoria:Niezbędnik kodera]]