TITLE=DOSLIB
ROUTE=/dos/doslib
LOCALE=hu
MODIFIED=1792180394
URL=https://wiki.teletypegames.org/hu/dos/doslib
L=1 #16
L=2 #18
L=3 #15
L=4 #49
L=5 https://git.teletypegames.org/dos/doslib


q│ A DOSLIB a 1DOSINST, a 2GMENU, a 3BMAGIC és a 4TTGWIKI DOS-programok közös kódja

q│ (C++, Open Watcom, 16 bites DOS és Win32), és a szabályok, amelyeket a

q│ kódjuk követ. Mindegyik program 
cSOURCE/lib
q mappájában git subtree-ként van

q│ benne, így önállóan fordul.

• 
bRepó:
0 5git.teletypegames.org/dos/doslib


1Mi van benne

1════════════


t┌──────────────────────────────┬─────────────────────────────────────────────┐

t│
h Mappa                        
t│
h Tartalom                                    
t│

t├──────────────────────────────┼─────────────────────────────────────────────┤

t│
0 
ccore
0                         
t│
0 I/O nélkül: szövegek és 8.3-as nevek,       
t│

t│
0                              
t│
0 INI-fájlok, UTF-8 és 437-es kódlap, a       
t│

t│
0                              
t│
0 437-es és 852-es kódlap karakterenként egy  
t│

t│
0                              
t│
0 bájttal (
ccode_page
0), CRC-32, a közös 
cError
0. 
t│

t├──────────────────────────────┼─────────────────────────────────────────────┤

t│
0 
cplatform
0                     
t│
0 A gép interfészei: 
cScreen
0, 
cKeyboard
0, 
cMouse
0, 
t│

t│
0                              
t│
0 
cClock
0, 
cFileSystem
0, 
cNetwork
0, ...             
t│

t├──────────────────────────────┼─────────────────────────────────────────────┤

t│
0 
cplatform/dos
0, 
cplatform/win32
0 
t│
0 A megvalósításaik: videomemória, BIOS, INT  
t│

t│
0                              
t│
0 33h, a Watcom C-könyvtár; a Win32-konzol.   
t│

t├──────────────────────────────┼─────────────────────────────────────────────┤

t│
0 
cnet
0                          
t│
0 FTP-kliens a 
cNetwork
0 interfészen.           
t│

t├──────────────────────────────┼─────────────────────────────────────────────┤

t│
0 
cui
0                           
t│
0 Rajzolás egy 
cScreen
0-re, a                   
t│

t│
0                              
t│
0 BIOS-billentyűkódok, listakurzor.           
t│

t├──────────────────────────────┼─────────────────────────────────────────────┤

t│
0 
ctesting
0                      
t│
0 A tesztbuildek kampói (szkriptelt           
t│

t│
0                              
t│
0 billentyűk, képernyőmentés), és             
t│

t│
0                              
t│
0 tesztpótlékok a fejlesztőgépes              
t│

t│
0                              
t│
0 unit-tesztekhez.                            
t│

t├──────────────────────────────┼─────────────────────────────────────────────┤

t│
0 
ctools
0                        
t│
0 A Watcom-build segédje, a rétegellenőrzés,  
t│

t│
0                              
t│
0 a unit-tesztfuttató, a formázó.             
t│

t└──────────────────────────────┴─────────────────────────────────────────────┘


1Rétegek

1═══════

Egy program rétegekből áll; mindegyik csak az alatta lévőket használja, azokat
is csak az interfészükön át:


p main_*.cpp     a gép: kiválasztja a platform-megvalósításokat                

p app/           összerakja a rétegeket                                        

p controller/    billentyűk és parancsok -> service-hívások                    

p view/          rajzol                                                        

p service/       amit a program csinál                                         

p repository/    a tárolás interfészei; a repository/<fajta>/ valósítja meg ők»

p et                                                                           

p model/         az adatok és a szabályaik, I/O nélkül                         

p platform/      a program saját gépinterfészei és megvalósításaik             

p lib/           a DOSLIB                                                      

A 
ctools/check_layers.py
0 ezt a CI-ban ellenőrzi: melyik mappa mit
include-olhat, hogy DOS- és Windows-fejléc csak a platformkódban van, hogy
nincs 
cgoto
0, és 
cexit()
0 csak a 
cmain
0-ben. A platform fölött minden a
fejlesztőgépen is lefordul, így ott unit-tesztelhető, DOSBox nélkül.


1A kód

1═════

• C++98, amennyit az Open Watcom ismer: osztályok, tisztán virtuális
  interfészek, referenciák, egyszerű template-ek; nincs kivétel, RTTI, STL és
  C++11.
• Az interfész neve azt mondja meg, mi (
cFileSystem
0), a megvalósításé azt,
  hogyan (
cDosFileSystem
0, 
cFakeFileSystem
0). A függőségek a konstruktoron jönnek;
  konkrét objektumot csak az 
capp/
0 és a 
cmain_*.cpp
0 hoz létre.
• A hiba egy 
cbool
0 és egy közös 
cError
0; a platformkódon kívül nincs globális
  állapot.
• Fájlok 
csnake_case
0, típusok 
cPascalCase
0, függvények 
ccamelCase
0, tagok 
cname_
0;
  clang-format 18 a repó 
c.clang-format
0-jával.


1Egy program frissítése

1══════════════════════


p git subtree pull --prefix=SOURCE/lib ssh://git@git.teletypegames.org:2222/do»

p s/doslib master --squash                                                     

Egy program 
cSOURCE/lib
0 mappájában tett változtatás a 
cgit subtree push

c--prefix=SOURCE/lib ... master
0 paranccsal megy vissza.


1Open Watcom-buktatók

1════════════════════

• A large modell 16 bites fordítója összeomlik 25 karakternél hosszabb
  modulnévnél; a build 
c-nm
0-mel levágja.
• A 32 KB-nál nagyobb statikus objektum az EXE-fájlba kerül: a nagy objektumok
  a heapen vannak.
• 16 biten a rétegeknek mérete van (far mutatók, konstruktorok, virtuális
  táblák): a GMENU 30-ról 45 KB-ra, a DOSINST 77-ről 90 KB-ra nőtt.