File Comparer v. 1.0 Bartosz Īepecki, lipiec 1995 Wszelkie prawa zastrzeūone SHAREWARE Instrukcja obsīugi KILKA SĪÓW O SHAREWARE Ten program jest rozprowadzany jako shareware. Oznacza to, ūe masz prawo nieodpīatnego uūywania go przez okres tygodnia, choź jest na tyle prosty, ūe bėdziesz wiedziaī o nim wszystko juū pierwszego dnia. Moūesz go takūe rozpowszechniaź, ale tylko wtedy, gdy zaīāczysz do niego niniejszā dokumentacjė. Po upīywie tygodnia musisz zdecydowaź, czy Ci on odpowiada i bėdziesz z niego korzystaī. Jeōli tak, wyōlij proszė 5 nowych zī lub 3 DM jako wynagrodzenie dla autora na adres: Bartosz Īepecki ul.Piaskowa 2/45 21-500 Biaīa Podlaska tel. 44-19-04 Jeōli jednak uznasz, ūe nie speīnia on Twoich oczekiwaļ lub nie jest wart swej ceny, powinieneō go niezwīocznie skasowaź. Pamiėtaj, ūe idea shareware udostėpnia Ci ten program po to, byō mógī siė z nim zapoznaź i liczy na Twojā uczciwoōź. Oczywiōcie nie sposób sprawowaź nad tym kontroli, dlatego jedynym kontrolerem bėdzie Twoja uczciwoōź i sumienie. Poza tym ta niewielka suma pieniėdzy bėdzie wyrazem tego, ūe doceniasz trud programisty, oraz bodścem dla autora do tworzenia nowych, lepszych programów. INFORMACJA O PROGRAMIE File Comparer powstaī w jėzyku Amos Professional na komputerze A1200 z twardym dyskiem. Ma bardzo prostā oprawė graficznā, co naturalnie nie wpīywa negatywnie na jego dziaīanie. Wymaga biblioteki amos.library. Jeōli jej nie posiadasz, skorzystaj z zaīāczonej wersji 1.1, która jej nie wymaga (i dlatego jest dwa razy dīuūsza). Program by oczywiōcie testowany, jednak jeōli znajdziesz w nim jakiō bīād lub masz inne uwagi, napisz na adres podany powyūej. Jeōli oczekujesz odpowiedzi, nie zapomnij o opīaconej kopercie zwrotnej. OPIS DZIAĪANIA Gīównym zadaniem programu File Comparer jest porównanie dwóch plików o jednakowej dīugoōci. Jeūeli oba pliki sā takie same, program poinformuje o tym uūytkownika, w przeciwnym razie wygeneruje raport, zawierajācy informacje o wszystkich róūnicach. Zadaniem uūytkownika jest wybranie dwóch plików do porównania i trzeciego do zapisu raportu.Ten ostatni jest ustawiony domyōlnie na RAM:raport. Dane sā do niego sukcesywnie zapisywane, a po zakoļczeniu operacji porównania plik jest wyōwietlany na ekranie za pomocā Amos Text Readera. Moūliwa jest zmiana nazwy i ōcieūki dostėpu pliku z raportem, lecz najlepiej, by byī on zapisany do RAM-u z uwagi na przewagė szybkoōci tej pamiėci nad innymi rodzajami pamiėci masowej. Sama operacja porównania odbywa siė z wykorzystaniem póīkilobajtowego bufora. Stopieļ zaawansowania procesu ilustruje poziomy, niebieski pasek, stopniowo wydīuūajācy siė w prawo. Dziaīanie programu moūna przerwa wciskajāc Control i C.Naleūy wspomnieź, ūe porównywane pliki nie powinny znajdowaź siė na róūnych dyskietkach, poniewaū dane sā z nich czytane na zmianė (po póī kilobajta). Dla wiėkszej wygody jeden z nich lub oba moūna przegraź do RAM-u, co przyspieszy operacjė. Jeōli zachodzi koniecznoōź porównania plików tak dīugich, ūe nie jest moūliwe umieszczenie ich na jednej dyskietce bādś przeniesienie jednego z nich do Ram Dysku, pozostaje skorzystaź z uprzejmoōci kolegi, posiadajācego dysk twardy. File Comparer w zamyōle autora ma sīuūyź do uīatwienia ūycia wīamywaczom do gier, które zapisujā stan gry w systemie DOS w postaci plików o zawsze takiej samej dīugoōci (np. Ishar 3). Wīamanie do takiej gry polega na zapisaniu stanu gry, dokonaniu jakiejō zmiany (np. zakupu lub straty energii) i ponownemu zapisaniu stanu gry do drugiego pliku. Wówczas pozostaje tylko porównanie zawartoōci obu zapisów, by dowiedzieź siė, w którym miejscu sā zapisane interesujāce nas wartoōci, takie jak wspomniana energia czy stan funduszy. Nikomu nie ūyczė porównywania kilkukilobajtowych plików "na piechotė". Ze wzglėdu na przeznaczenie program przerywa pracė, gdy liczba bajtów róūniācych oba pliki przekroczy tysiāc. File Comparer zapisuje swój raport w postaci tabelki, moūliwej do odczytania przy pomocy dowolnego edytora tekstu. Kaūda linia tabelki to jeden znak-róūnica, opisany na kilka sposobów w poszczególnych kolumnach. Kolejne kolumny tabelki to: liczba porzādkowa, informujāca nas o liczbie znaków, róūniācych badane pliki, offset, czyli przesuniėcie znaku, którego dotyczy linia, wzglėdem poczātku pliku, oraz sam bajt w obu plikach, przedstawiony na trzy sposoby: jako kod ASCII szesnastkowo (HEX), kod ASCII dziesiėtnie (DEC) i jako znak na ekranie (TXT). Jeōli znaku o tym kodzie nie da siė pokazaź na ekranie, zamiast niego wyōwietlana jest kropka. Na szczycie pliku, oprócz symbolicznych nazw kolumn tabeli, znajdujā siė takūe nazwy i ōcieūki dostėpu porównywanych plików i przyporzādkowane im kody literowe (A i B), co pozwala na odrobinė lepszā orientacjė w tabeli. Przesuw w pionie umoūliwia widoczny po prawej stronie czerwony suwak. Program obsīuguje teū niektóre bīėdy, jakie mogā siė pojawiź podczas jego pracy. W przypadku wystāpienia bīėdu odczytu, zīej walidacji dysku (dysk nieuaktualniony), zabezpieczenia pliku przed odczytem lub zapisem czy skasowaniem (plik z raportem) zostanie wyōwietlona odpowiednia informacja i program poprosi o wybór nowych plików (jednego - w dwóch ostatnich przypadkach lub wszystkich). Jeōli skoļczy siė miejsce w urzādzeniu, na które bėdzie zapisywany raport, uūytkownik zostanie poproszony o wybranie nowej lokacji, do której plik z raportem zostanie przeniesiony. Stary plik zostanie skasowany, a operacja bėdzie kontynuowana. Jeōli plik jest zabezpieczony przed zapisem lub odczytem, moūna przejōź do Workbencha poprzez naciōniėcie Control-A i wykorzystujāc multitasking zmieniź bity protekcji w danym pliku przy pomocy opcji Informacje z menu Ikony Workbencha lub posīuūyź siė programem typu DiskMaster, FileMaster czy DirectoryOpus, po czym powróciź do programu (równieū Control-A). Mimo, iū File Comparer zostaī przeznaczony do porównania plików o jednakowej dīugoōci, speīnienie tego warunku nie jest konieczne dla jego poprawnego dziaīania. Jeōli badane pliki bėdā róūniīy siė dīugoōciā, przy porównaniu program weśmie pod uwagė tylko tė czėōź dīuūszego pliku, której dīugoōź jest równa dīugoōci krótszego pliku. Innymi sīowy, program porównuje pliki dotād, aū któryō z nich siė nie skoļczy. Ūyczė przyjemnej pracy i wielu udanych "wīamów" - Bartosz Īepecki