QB64 Referenční příručka

QB64 Phoenix Edition

Kompletní referenční příručka jazyka QB64 v češtině: od proměnných a cyklů přes grafiku, zvuk, soubory a přímý přístup do paměti až po volání DLL. Každá kapitola obsahuje příklady, které lze zkopírovat a rovnou spustit v IDE klávesou F5.

PRINT příkaz QBasicu _NEWIMAGE rozšíření QB64 "text" řetězec 42 číslo ' komentář $CONSOLE metapříkaz
Nic nenalezeno. Zkuste kratší výraz nebo název bez podtržítka.

01Úvod a instalace

QB64 je moderní kompilátor jazyka BASIC kompatibilní s Microsoft QuickBASIC 4.5 a QBasic 1.1. Zdrojový kód .bas se překládá do C++ a dál do nativního spustitelného souboru pro Windows, Linux i macOS. Aktivně vyvíjenou větví je QB64 Phoenix Edition (QB64-PE); tato příručka popisuje ji. Původní QB64 (qb64.com) se už nevyvíjí.

Klíčová slova začínající podtržítkem (_NEWIMAGE, _RGB32…) jsou rozšíření QB64 nad rámec QuickBASICu. V kódu jsou proto zvýrazněna jinou barvou než klasické příkazy.

Instalace

  • Windows: stáhněte ZIP z qb64phoenix.com (nebo GitHub QB64-Phoenix-Edition), rozbalte do cesty bez diakritiky, např. C:\QB64pe, a spusťte qb64pe.exe. Kompilátor MinGW je přibalený.
  • Linux: rozbalte archiv a spusťte ./setup_lnx.sh; skript doinstaluje g++, OpenGL a ALSA hlavičky a přeloží IDE.
  • macOS: nutné Xcode Command Line Tools, pak ./setup_osx.command.

Klávesy v IDE

KlávesaFunkce
F5Přeložit a spustit
F11Pouze vytvořit EXE (Make EXE only)
F1Nápověda ke klíčovému slovu pod kurzorem
F2Seznam SUB/FUNCTION v programu
Ctrl+F / F3Hledat / hledat další
Ctrl+Z / Ctrl+YZpět / znovu
Alt+EnterCelá obrazovka IDE
F7 / F8Krokování v ladicím režimu ($DEBUG)
F9Přepnout breakpoint ($DEBUG)

Překlad z příkazové řádky

' Windows
qb64pe.exe -c hra.bas -o hra.exe     ' přeložit (s oknem stavu)
qb64pe.exe -x hra.bas -o hra.exe     ' přeložit, výstup do konzole (vhodné pro skripty)

' Linux
./qb64pe -x hra.bas -o hra

První program

' Ahoj světe
_TITLE "Můj první program"
PRINT "Ahoj, světe!"
INPUT "Jak se jmenuješ"; jmeno$
PRINT "Vítej, "; jmeno$; "!"
SLEEP
END

Okno programu používá výchozí kódovou stránku 437, takže české znaky v PRINT v textovém režimu nezobrazí správně. Řešení: _MAPUNICODE s tabulkou CP852, nebo grafický režim s TrueType fontem (_LOADFONT) a výpisem přes _UPRINTSTRING v novějších verzích PE.

02Základy syntaxe

  • Na velikosti písmen u klíčových slov a proměnných nezáleží (Pocet = POCET). IDE klíčová slova převádí na velká.
  • Komentář: apostrof ' nebo REM.
  • Více příkazů na řádku oddělte dvojtečkou :.
  • Pokračování dlouhého řádku: podtržítko _ na konci řádku.
  • Návěští (label): Start: nebo číslo řádku 100.
  • Proměnné není nutné deklarovat; bez přípony mají typ SINGLE. Doporučeno OPTION _EXPLICIT, které vyžaduje DIM.
OPTION _EXPLICIT          ' vynutí deklaraci všech proměnných

DIM a AS INTEGER, b AS INTEGER
a = 5: b = 7              ' dva příkazy na jednom řádku
PRINT "Součet:"; a + b    ' středník = bez mezery mezi položkami
PRINT "A", "B"            ' čárka = skok na další tabulační zónu (14 znaků)

DIM dlouhy AS STRING
dlouhy = "první část, " + _
         "druhá část"     ' pokračování řádku podtržítkem
PRINT dlouhy

REM Tohle je také komentář
END

Struktura programu

Hlavní program je nahoře, pod ním následují SUB a FUNCTION. DECLARE SUB z QuickBASICu není v QB64 potřeba (IDE jej toleruje a ignoruje). Datové bloky DATA a TYPE definice patří do hlavního modulu.

' --- hlavní modul ---
DIM SHARED skore AS LONG
Pozdrav "Pavel"
PRINT Ctverec(9)
END

' --- podprogramy ---
SUB Pozdrav (kdo AS STRING)
    PRINT "Ahoj, "; kdo
END SUB

FUNCTION Ctverec& (n AS LONG)
    Ctverec& = n * n
END FUNCTION

03Datové typy a proměnné

TypPříponaVelikostRozsah / poznámka
_BIT`1 bit−1 až 0 (_UNSIGNED _BIT: 0–1)
_BYTE%%1 B−128 až 127
_UNSIGNED _BYTE~%%1 B0 až 255
INTEGER%2 B−32 768 až 32 767
_UNSIGNED INTEGER~%2 B0 až 65 535
LONG&4 B−2 147 483 648 až 2 147 483 647
_UNSIGNED LONG~&4 B0 až 4 294 967 295 (barvy _RGB32)
_INTEGER64&&8 B±9,22 × 1018
_UNSIGNED _INTEGER64~&&8 B0 až 18,4 × 1018
SINGLE!4 B≈ 7 platných číslic (výchozí typ)
DOUBLE#8 B≈ 15–16 platných číslic
_FLOAT##10 B (long double)≈ 19 platných číslic
STRING$proměnnáaž ~2 GB; pevná délka STRING * n
_OFFSET%&4/8 Bukazatel (velikost dle platformy)
_MEM—strukturablok paměti, viz kapitola _MEM
DIM pocet AS LONG
DIM cena AS DOUBLE
DIM jmeno AS STRING
DIM kod AS STRING * 4          ' řetězec pevné délky (doplní se mezerami)
DIM bajt AS _UNSIGNED _BYTE
DIM barva AS _UNSIGNED LONG

' Více proměnných stejného typu (syntaxe QB64)
DIM AS INTEGER x, y, z

' Použití přípony místo DIM
i% = 10: velke&& = 9000000000: pi# = 3.14159265358979#
t$ = "text"

' Výchozí typy podle počátečního písmene
DEFINT A-Z                     ' vše bez přípony bude INTEGER
_DEFINE M AS _UNSIGNED LONG    ' QB64: proměnné začínající M

' Konstanty
CONST MAXHRACU = 4
CONST NAZEV$ = "Hra"
CONST GRAVITACE = 9.81

' Literály v jiných soustavách
PRINT &HFF, &O17, &B1010       ' 255  15  10
kod = "AB"
PRINT "["; kod; "]"            ' [AB  ]

Převody typů

PRINT CINT(2.5), CINT(3.5)     ' 2  4  (zaokrouhlení na sudé)
PRINT CLNG(123456.7)           ' 123457
PRINT INT(-2.5), FIX(-2.5)     ' -3  -2
PRINT CSNG(1 / 3), CDBL(1 / 3)
PRINT _ROUND(2.7)              ' 3  (QB64: zaokrouhlí na celé číslo typu _INTEGER64)
PRINT VAL("12.5") + 1          ' 13.5
PRINT STR$(42)                 ' " 42" (mezera pro znaménko)
PRINT _TRIM$(STR$(42))         ' "42"

04Operátory

SkupinaOperátoryPoznámka
Aritmetické^ -(unární) * / \ MOD + -\ celočíselné dělení, MOD zbytek
Relační= <> < > <= >=výsledek −1 (pravda) nebo 0 (nepravda)
Logické / bitovéNOT AND OR XOR EQV IMPpracují po bitech
Zkrácené vyhodnocení_ANDALSO _ORELSEQB64-PE 3.x+; pravá strana se nevyhodnotí, pokud není třeba
Řetězce+spojení řetězců

Priorita (od nejvyšší): ^, unární -, * /, \, MOD, + -, relační, NOT, AND, OR, XOR, EQV, IMP.

PRINT 17 \ 5, 17 MOD 5, 2 ^ 10      ' 3  2  1024
PRINT (5 > 3), (5 < 3)               ' -1  0
PRINT 12 AND 10, 12 OR 10, 12 XOR 10 ' 8  14  6
PRINT NOT 0                          ' -1

' Test bitu a nastavení bitu
priznaky% = 0
priznaky% = priznaky% OR 4           ' nastav bit 2
IF priznaky% AND 4 THEN PRINT "bit 2 je nastaven"

' Zkrácené vyhodnocení – bez dělení nulou
d = 0
IF d <> 0 _ANDALSO 10 / d > 1 THEN PRINT "ok" ELSE PRINT "přeskočeno"

' Posun bitů (QB64)
PRINT _SHL(1, 4), _SHR(256, 2)        ' 16  64

05Textový výstup a vstup

PRINT a formátování

CLS
COLOR 14, 1                    ' popředí žlutá, pozadí modrá
LOCATE 5, 10                   ' řádek 5, sloupec 10
PRINT "Na pozici 5,10"
COLOR 7, 0

PRINT "Bez odřádkování";       ' středník na konci = kurzor zůstane
PRINT " pokračuje"
PRINT TAB(20); "sloupec 20"
PRINT SPC(5); "5 mezer"

' PRINT USING
PRINT USING "###.##"; 3.14159              '   3.14
PRINT USING "Cena: #,###.## Kč"; 12345.6   ' Cena: 12,345.60 Kč
PRINT USING "+###"; -42                    '  -42
PRINT USING "\   \"; "Řetězec"             ' první 5 znaků
PRINT USING "!"; "Pavel"                   ' P
PRINT USING "& je &"; "QB64"; "super"

' Velikost textového okna
WIDTH 100, 30                  ' 100 sloupců × 30 řádků
PRINT CSRLIN, POS(0)           ' aktuální řádek a sloupec kurzoru

Vstup z klávesnice

INPUT "Zadej věk: ", vek%           ' čárka = bez otazníku
INPUT "Jméno a rok"; j$, r%         ' středník = s otazníkem
LINE INPUT "Celá věta: ", veta$     ' načte i čárky a uvozovky

' Čekání na klávesu bez Enteru
PRINT "Stiskni libovolnou klávesu..."
DO: k$ = INKEY$: LOOP UNTIL k$ <> ""
PRINT "Stisknuto: "; k$; " (ASC"; ASC(k$); ")"

' Rozšířené klávesy vrací CHR$(0) + kód
DO
    k$ = INKEY$
    IF LEN(k$) = 2 THEN
        SELECT CASE ASC(k$, 2)
            CASE 72: PRINT "nahoru"
            CASE 80: PRINT "dolů"
            CASE 75: PRINT "vlevo"
            CASE 77: PRINT "vpravo"
        END SELECT
    END IF
    _LIMIT 60
LOOP UNTIL k$ = CHR$(27)            ' Esc

' Jednoduché čekání
SLEEP 2       ' 2 sekundy nebo do stisku klávesy
SLEEP         ' do stisku klávesy
_DELAY 0.5    ' přesně 0,5 s, klávesa nepřeruší

Konzolový režim

$CONSOLE:ONLY            ' program běží jen v konzoli (vhodné pro nástroje)
PRINT "Výstup do terminálu"
PRINT "Argumenty: "; COMMAND$
FOR i = 1 TO _COMMANDCOUNT
    PRINT i; COMMAND$(i)
NEXT
SYSTEM 0                 ' ukončí program s návratovým kódem 0
$CONSOLE                 ' grafické okno + konzole zároveň
_DEST _CONSOLE: PRINT "do konzole"
_DEST 0:        PRINT "do okna programu"
_ECHO "ladicí zpráva do konzole"   ' kamkoli, bez změny _DEST

06Řízení toku programu

IF … THEN … ELSE

' Jednořádkový tvar
IF x > 10 THEN PRINT "velké" ELSE PRINT "malé"

' Blokový tvar
IF teplota < 0 THEN
    PRINT "mrzne"
ELSEIF teplota < 20 THEN
    PRINT "chladno"
ELSE
    PRINT "teplo"
END IF

' Složené podmínky
IF vek >= 18 AND NOT zakaz THEN PRINT "vstup povolen"

SELECT CASE

SELECT CASE znamka
    CASE 1: PRINT "výborně"
    CASE 2, 3: PRINT "dobře"
    CASE 4 TO 5: PRINT "slabé"
    CASE IS > 5: PRINT "neplatná známka"
    CASE ELSE: PRINT "?"
END SELECT

SELECT CASE UCASE$(prikaz$)
    CASE "A" TO "M": PRINT "první polovina abecedy"
    CASE "KONEC": SYSTEM
END SELECT

' SELECT EVERYCASE (QB64) – provede všechny vyhovující větve
SELECT EVERYCASE n
    CASE IS > 0: PRINT "kladné"
    CASE IS > 100: PRINT "a větší než 100"
END SELECT

FOR … NEXT

FOR i = 1 TO 10
    PRINT i;
NEXT i

FOR i = 10 TO 0 STEP -2: PRINT i;: NEXT       ' 10 8 6 4 2 0
FOR x# = 0 TO 1 STEP 0.25: PRINT x#;: NEXT

' Vnořené cykly – malá násobilka
FOR r = 1 TO 10
    FOR s = 1 TO 10
        PRINT USING "####"; r * s;
    NEXT s
    PRINT
NEXT r

DO … LOOP a WHILE … WEND

' Podmínka na začátku
n = 1
DO WHILE n < 1000
    n = n * 2
LOOP
PRINT n                        ' 1024

' Podmínka na konci (proběhne aspoň jednou)
DO
    INPUT "Heslo"; h$
LOOP UNTIL h$ = "qb64"

' Nekonečný cyklus s ukončením
DO
    k$ = INKEY$
    IF k$ = CHR$(27) THEN EXIT DO
    _LIMIT 30                  ' max. 30 průchodů za sekundu – šetří CPU
LOOP

WHILE INKEY$ = "": WEND        ' starší tvar

EXIT, _CONTINUE, GOTO, GOSUB

FOR i = 1 TO 20
    IF i MOD 3 = 0 THEN _CONTINUE   ' přeskoč na další průchod
    IF i > 14 THEN EXIT FOR
    PRINT i;
NEXT

' GOSUB / RETURN (lokální podprogram v rámci modulu)
GOSUB Hlavicka
PRINT "tělo"
END

Hlavicka:
    PRINT "=== HLAVIČKA ==="
RETURN

' ON ... GOSUB / GOTO podle hodnoty 1, 2, 3...
' ON volba GOSUB Nova, Otevrit, Ulozit

DATA, READ, RESTORE

RESTORE Ovoce
FOR i = 1 TO 3
    READ nazev$, cena
    PRINT nazev$; " stojí"; cena; "Kč"
NEXT
END

Ovoce:
DATA "jablko", 12, "hruška", 15, "banán", 9

07Pole

DIM cisla(10) AS INTEGER          ' indexy 0..10 (11 prvků)
DIM dny(1 TO 7) AS STRING         ' vlastní rozsah
DIM mapa(1 TO 80, 1 TO 25) AS _BYTE  ' dvourozměrné pole
DIM SHARED tabulka(100) AS DOUBLE ' sdílené se všemi SUB/FUNCTION

OPTION BASE 1                     ' výchozí dolní mez 1 (musí být před DIM)

PRINT LBOUND(dny), UBOUND(dny)    ' 1  7
PRINT UBOUND(mapa, 2)             ' 25 – horní mez druhého rozměru

' Dynamické pole
DIM seznam(0) AS STRING
n = 0
DO
    LINE INPUT "Položka (prázdné = konec): ", p$
    IF p$ = "" THEN EXIT DO
    n = n + 1
    REDIM _PRESERVE seznam(1 TO n) AS STRING   ' zvětšení se zachováním dat
    seznam(n) = p$
LOOP
FOR i = 1 TO n: PRINT i; seznam(i): NEXT

ERASE cisla                       ' statické pole vynuluje, dynamické uvolní

Naplnění a řazení

RANDOMIZE TIMER
CONST N = 15
DIM a(1 TO N) AS INTEGER
FOR i = 1 TO N: a(i) = INT(RND * 100): NEXT

' Bublinkové řazení se SWAP
FOR i = 1 TO N - 1
    FOR j = 1 TO N - i
        IF a(j) > a(j + 1) THEN SWAP a(j), a(j + 1)
    NEXT
NEXT
FOR i = 1 TO N: PRINT a(i);: NEXT
PRINT

Quicksort (rekurzivní)

DIM SHARED d(1 TO 1000) AS LONG
RANDOMIZE TIMER
FOR i = 1 TO 1000: d(i) = INT(RND * 100000): NEXT
QuickSort 1, 1000
FOR i = 1 TO 10: PRINT d(i);: NEXT
END

SUB QuickSort (lo AS LONG, hi AS LONG)
    DIM i AS LONG, j AS LONG, pivot AS LONG
    i = lo: j = hi
    pivot = d((lo + hi) \ 2)
    DO WHILE i <= j
        DO WHILE d(i) < pivot: i = i + 1: LOOP
        DO WHILE d(j) > pivot: j = j - 1: LOOP
        IF i <= j THEN SWAP d(i), d(j): i = i + 1: j = j - 1
    LOOP
    IF lo < j THEN QuickSort lo, j
    IF i < hi THEN QuickSort i, hi
END SUB

Pole se předává do podprogramu s prázdnými závorkami: Vypis pole(), v hlavičce SUB Vypis (p() AS INTEGER).

08Práce s řetězci

FunkcePopisPříklad → výsledek
LEN(s$)délkaLEN("QB64") → 4
LEFT$(s$, n)n znaků zlevaLEFT$("BASIC", 2) → "BA"
RIGHT$(s$, n)n znaků zpravaRIGHT$("BASIC", 3) → "SIC"
MID$(s$, od, n)podřetězecMID$("BASIC", 2, 3) → "ASI"
INSTR([od,] s$, h$)pozice hledaného (0 = nenalezeno)INSTR("abcabc", "c") → 3
_INSTRREV(s$, h$)hledání odzadu_INSTRREV("abcabc", "c") → 6
UCASE$ / LCASE$velká / malá písmenaUCASE$("qb") → "QB"
LTRIM$ / RTRIM$ / _TRIM$ořez mezer_TRIM$(" a ") → "a"
STR$(n) / VAL(s$)číslo ↔ textVAL("3.5") → 3.5
CHR$(k) / ASC(s$[,pos])kód ↔ znakCHR$(65) → "A"
STRING$(n, z)opakování znakuSTRING$(5, "*") → "*****"
SPACE$(n)n mezer
HEX$ / OCT$ / _BIN$číslo do soustavyHEX$(255) → "FF"
MKI$ MKL$ MKS$ MKD$číslo → binární řetězecpro binární soubory
CVI CVL CVS CVDbinární řetězec → čísloCVI(MKI$(500)) → 500
_STRCMP / _STRICMPporovnání (−1/0/1), i bez ohledu na velikost_STRICMP("a","A") → 0
s$ = "Ahoj QB64 světe"
MID$(s$, 6, 4) = "BASI"        ' MID$ jako příkaz přepíše znaky na místě
PRINT s$                       ' Ahoj BASI světe

' Rozdělení řetězce podle oddělovače
radek$ = "Praha;Brno;Kolín;Ostrava"
DO
    p = INSTR(radek$, ";")
    IF p = 0 THEN PRINT radek$: EXIT DO
    PRINT LEFT$(radek$, p - 1)
    radek$ = MID$(radek$, p + 1)
LOOP

' Otočení řetězce
t$ = "kobyla má malý bok"
r$ = ""
FOR i = LEN(t$) TO 1 STEP -1: r$ = r$ + MID$(t$, i, 1): NEXT
PRINT r$

' Nahrazení všech výskytů (vlastní funkce)
PRINT Nahrad$("a-b-c-d", "-", " + ")
END

FUNCTION Nahrad$ (src$, co$, cim$)
    DIM v$, p AS LONG
    v$ = src$
    p = INSTR(v$, co$)
    DO WHILE p > 0
        v$ = LEFT$(v$, p - 1) + cim$ + MID$(v$, p + LEN(co$))
        p = INSTR(p + LEN(cim$), v$, co$)
    LOOP
    Nahrad$ = v$
END FUNCTION

Počítání slov a písmen

LINE INPUT "Text: ", t$
t$ = UCASE$(t$)
DIM cetnost(65 TO 90) AS INTEGER
slova = 0: vSlove = 0
FOR i = 1 TO LEN(t$)
    c = ASC(t$, i)
    IF c >= 65 AND c <= 90 THEN
        cetnost(c) = cetnost(c) + 1
        IF vSlove = 0 THEN slova = slova + 1: vSlove = -1
    ELSE
        vSlove = 0
    END IF
NEXT
PRINT "Slov:"; slova
FOR c = 65 TO 90
    IF cetnost(c) THEN PRINT CHR$(c); ":"; STRING$(cetnost(c), "#")
NEXT

09Matematické funkce

FunkcePopis
ABS(x), SGN(x)absolutní hodnota, znaménko (−1, 0, 1)
INT(x), FIX(x)zaokrouhlení dolů / oříznutí desetinné části
_CEIL(x), _ROUND(x)zaokrouhlení nahoru / na nejbližší celé
SQR(x), x ^ yodmocnina, mocnina
EXP(x), LOG(x)ex, přirozený logaritmus (log10 = LOG(x)/LOG(10))
SIN COS TAN ATNgoniometrické funkce v radiánech
_ATAN2(y, x)úhel bodu, celý rozsah −π až π
_ASIN _ACOS _SINH _COSH _TANHdalší funkce QB64
_HYPOT(x, y)√(x² + y²)
_PI, _PI(n)π, případně n × π
_D2R(st), _R2D(rad)stupně ↔ radiány
RND, RANDOMIZEnáhodné číslo 0 ≤ r < 1; inicializace generátoru
RANDOMIZE TIMER                         ' jiná posloupnost při každém spuštění
kostka = INT(RND * 6) + 1               ' 1..6
nahodne = INT(RND * (max - min + 1)) + min

PRINT SQR(2), 2 ^ 0.5
PRINT SIN(_D2R(30))                     ' 0.5
PRINT _R2D(_ATAN2(1, 1))                ' 45
PRINT _HYPOT(3, 4)                      ' 5

' Faktoriál a největší společný dělitel
PRINT Faktorial&&(20)
PRINT NSD&(1071, 462)                   ' 21
END

FUNCTION Faktorial&& (n AS INTEGER)
    IF n <= 1 THEN Faktorial&& = 1 ELSE Faktorial&& = n * Faktorial&&(n - 1)
END FUNCTION

FUNCTION NSD& (a AS LONG, b AS LONG)
    DIM x AS LONG, y AS LONG, t AS LONG
    x = a: y = b
    DO WHILE y
        t = x MOD y: x = y: y = t
    LOOP
    NSD& = x
END FUNCTION

Prvočísla – Eratosthenovo síto

CONST LIMIT = 200
DIM slozene(LIMIT) AS _BYTE
FOR i = 2 TO SQR(LIMIT)
    IF slozene(i) = 0 THEN
        FOR j = i * i TO LIMIT STEP i: slozene(j) = -1: NEXT
    END IF
NEXT
FOR i = 2 TO LIMIT
    IF slozene(i) = 0 THEN PRINT i;
NEXT

10SUB a FUNCTION

  • SUB nevrací hodnotu a volá se bez závorek: Kresli 10, 20 (nebo CALL Kresli(10, 20)).
  • FUNCTION vrací hodnotu přiřazením do svého jména. Návratový typ určuje přípona jména (Soucet&, Text$) nebo DEFINT/_DEFINE.
  • Parametry se předávají odkazem: změna uvnitř se projeví venku. Předání hodnotou vynutíte uzavřením argumentu do závorek: Zmen (x).
  • Lokální proměnné jsou při každém volání nové; STATIC zachová hodnotu mezi voláními.
  • Globální proměnné: DIM SHARED v hlavním modulu, nebo SHARED x uvnitř podprogramu.
DIM SHARED pocitadlo AS LONG

a = 5
Zdvojnasob a
PRINT a                    ' 10 – předáno odkazem
Zdvojnasob (a)
PRINT a                    ' 10 – předáno hodnotou (kopie)

FOR i = 1 TO 3: PRINT Dalsi%;: NEXT    ' 1 2 3
PRINT
PRINT Prumer#(4, 8)                    ' 6
PRINT Opakuj$("ab", 3)                 ' ababab
END

SUB Zdvojnasob (x)
    x = x * 2
    pocitadlo = pocitadlo + 1
END SUB

FUNCTION Dalsi%
    STATIC n AS INTEGER     ' hodnota přežije mezi voláními
    n = n + 1
    Dalsi% = n
END FUNCTION

FUNCTION Prumer# (a AS DOUBLE, b AS DOUBLE)
    Prumer# = (a + b) / 2
END FUNCTION

FUNCTION Opakuj$ (s AS STRING, n AS INTEGER)
    DIM r AS STRING, i AS INTEGER
    FOR i = 1 TO n: r = r + s: NEXT
    Opakuj$ = r
END FUNCTION

Odkazem se předá jen proměnná stejného typu, jaký má parametr. Konstanty a výrazy (včetně (x)) se předávají jako kopie.

Rekurze – Hanojské věže

Hanoj 4, "A", "C", "B"
END

SUB Hanoj (n AS INTEGER, z AS STRING, cil AS STRING, pomocny AS STRING)
    IF n = 0 THEN EXIT SUB
    Hanoj n - 1, z, pomocny, cil
    PRINT "Disk"; n; "z "; z; " na "; cil
    Hanoj n - 1, pomocny, cil, z
END SUB

11Uživatelské typy (TYPE)

TYPE Bod
    x AS SINGLE
    y AS SINGLE
END TYPE

TYPE Hrac
    jmeno AS STRING * 20          ' klasicky pevná délka (pro RANDOM soubory)
    pozice AS Bod                 ' vnořený typ
    zivoty AS INTEGER
    skore AS LONG
END TYPE

' Alternativní zápis QB64
TYPE Barva
    AS _UNSIGNED _BYTE r, g, b
END TYPE

DIM h AS Hrac
h.jmeno = "Pavel"
h.pozice.x = 100: h.pozice.y = 50
h.zivoty = 3

DIM tym(1 TO 4) AS Hrac          ' pole záznamů
tym(1) = h                       ' kopie celého záznamu
tym(2).jmeno = "Vladimír"

PRINT RTRIM$(tym(1).jmeno); " na"; tym(1).pozice.x; ","; tym(1).pozice.y
PRINT LEN(tym(1))                ' velikost záznamu v bajtech

PosunHrace tym(1), 5, -3
PRINT tym(1).pozice.x
END

SUB PosunHrace (p AS Hrac, dx AS SINGLE, dy AS SINGLE)
    p.pozice.x = p.pozice.x + dx
    p.pozice.y = p.pozice.y + dy
END SUB

Pole uvnitř TYPE QB64 nepodporuje. Řešením je pevný řetězec jako buffer, nebo samostatné pole indexované stejně jako záznamy.

12Grafika

Grafické režimy

RežimRozlišeníBarvyPoznámka
SCREEN 080 × 25 znaků16textový, výchozí
SCREEN 7320 × 200168 stránek pro PCOPY
SCREEN 9640 × 35016 z 64EGA
SCREEN 12640 × 48016VGA, klasika QBasicu
SCREEN 13320 × 200256MCGA, paleta přes PALETTE
SCREEN _NEWIMAGE(š, v, 32)libovolné16,7 mil. + alfadoporučeno pro nové programy
SCREEN _NEWIMAGE(š, v, 256)libovolné256paletový režim libovolné velikosti

Základní kreslení

SCREEN _NEWIMAGE(800, 600, 32)
_TITLE "Kreslení"
_SCREENMOVE _MIDDLE                         ' okno doprostřed obrazovky

bila~& = _RGB32(255, 255, 255)
cervena~& = _RGB32(220, 40, 40)
pruhledna~& = _RGBA32(0, 120, 255, 128)     ' alfa 0–255

CLS , _RGB32(20, 20, 50)                    ' smazání barvou pozadí
PSET (10, 10), bila~&                       ' bod
LINE (50, 50)-(300, 50), bila~&             ' úsečka
LINE (50, 80)-(300, 180), cervena~&, B      ' obdélník
LINE (80, 100)-(330, 200), pruhledna~&, BF  ' vyplněný (poloprůhledný)
LINE (50, 220)-(300, 220), bila~&, , &HF0F0 ' čárkovaná (styl bitovou maskou)
CIRCLE (500, 150), 80, bila~&               ' kružnice
CIRCLE (500, 150), 60, cervena~&, , , 0.5   ' elipsa (poměr stran 0.5)
CIRCLE (650, 400), 70, bila~&, 0, _PI       ' oblouk 0..π
CIRCLE (300, 400), 50, _RGB32(0, 200, 0)
PAINT (300, 400), _RGB32(0, 120, 0), _RGB32(0, 200, 0)  ' výplň uvnitř hranice

COLOR _RGB32(255, 255, 0), _RGB32(20, 20, 50)
_PRINTSTRING (50, 500), "Text na pixelové pozici"
_PRINTMODE _KEEPBACKGROUND                  ' text bez podkladu
PRINT "x ="; _WIDTH; "  y ="; _HEIGHT

PRINT HEX$(POINT(10, 10))                   ' barva pixelu: FFFFFFFF
PRINT _RED32(cervena~&), _GREEN32(cervena~&), _BLUE32(cervena~&)
SLEEP

Souřadnicový systém a relativní pozice

SCREEN 12
WINDOW (-10, -10)-(10, 10)       ' matematické souřadnice, osa y nahoru
LINE (-10, 0)-(10, 0), 8         ' osa x
LINE (0, -10)-(0, 10), 8         ' osa y
FOR x! = -10 TO 10 STEP 0.01
    PSET (x!, 5 * SIN(x!)), 14   ' graf sinu
NEXT
VIEW (20, 20)-(200, 150), 1, 15  ' výřez obrazovky s podkladem a rámečkem
SLEEP

DRAW – želví grafika

SCREEN 12
PSET (320, 240), 15
DRAW "C14 U50 R50 D50 L50"       ' čtverec: barva 14, nahoru, vpravo, dolů, vlevo
DRAW "BM100,100 C12 E30 F30 G30 H30"   ' BM = přesun bez kreslení, E F G H = šikmo
FOR uhel = 0 TO 360 STEP 30
    DRAW "BM320,240 TA" + STR$(uhel) + " C10 U80"   ' TA = otočení o úhel
NEXT
SLEEP

Animace bez blikání: _DISPLAY a _LIMIT

SCREEN _NEWIMAGE(640, 480, 32)
TYPE Mic
    x AS SINGLE: y AS SINGLE
    dx AS SINGLE: dy AS SINGLE
    r AS INTEGER
    c AS _UNSIGNED LONG
END TYPE

RANDOMIZE TIMER
CONST POCET = 25
DIM m(1 TO POCET) AS Mic
FOR i = 1 TO POCET
    m(i).r = 5 + INT(RND * 15)
    m(i).x = m(i).r + RND * (640 - 2 * m(i).r)
    m(i).y = m(i).r + RND * (480 - 2 * m(i).r)
    m(i).dx = RND * 6 - 3: m(i).dy = RND * 6 - 3
    m(i).c = _RGB32(RND * 255, RND * 255, RND * 255)
NEXT

DO
    CLS , _RGB32(10, 10, 30)
    FOR i = 1 TO POCET
        m(i).x = m(i).x + m(i).dx
        m(i).y = m(i).y + m(i).dy
        IF m(i).x < m(i).r OR m(i).x > 640 - m(i).r THEN m(i).dx = -m(i).dx
        IF m(i).y < m(i).r OR m(i).y > 480 - m(i).r THEN m(i).dy = -m(i).dy
        CIRCLE (m(i).x, m(i).y), m(i).r, m(i).c
        PAINT (m(i).x, m(i).y), m(i).c, m(i).c
    NEXT
    _PRINTSTRING (5, 5), "Esc = konec"
    _DISPLAY                     ' zobraz hotový snímek (vypne automatické překreslování)
    _LIMIT 60                    ' 60 snímků za sekundu
LOOP UNTIL _KEYDOWN(27)
SYSTEM

Po prvním _DISPLAY se obrazovka obnovuje jen při dalším volání _DISPLAY. Zpět na automatické překreslování přepne _AUTODISPLAY.

Obrázky a obrazové buffery

SCREEN _NEWIMAGE(800, 600, 32)

obr& = _LOADIMAGE("postava.png", 32)        ' PNG, JPG, BMP, GIF, TGA…
IF obr& < -1 THEN                           ' platný handle je menší než -1
    _PUTIMAGE (100, 100), obr&                       ' v původní velikosti
    _PUTIMAGE (300, 100)-(500, 300), obr&            ' roztažený do obdélníku
    _PUTIMAGE (700, 100)-(600, 200), obr&            ' zrcadlově (prohozené x)
    PRINT "Velikost:"; _WIDTH(obr&); "x"; _HEIGHT(obr&)
ELSE
    PRINT "Obrázek nenalezen"
END IF

' Kreslení mimo obrazovku (offscreen buffer)
buf& = _NEWIMAGE(200, 200, 32)
_DEST buf&                                   ' kresli do bufferu
CLS , _RGB32(0, 80, 0)
CIRCLE (100, 100), 90, _RGB32(255, 255, 0)
_DEST 0                                      ' zpět na obrazovku (0 = aktivní obrazovka)
_PUTIMAGE (550, 380), buf&

' Výřez z obrázku: (zdroj x1,y1)-(x2,y2) za cílovým handlem
_PUTIMAGE (10, 400), buf&, 0, (50, 50)-(149, 149)

_CLEARCOLOR _RGB32(0, 80, 0), buf&           ' barva bude průhledná
_PUTIMAGE (580, 400), buf&

_SAVEIMAGE "snimek.png"                      ' QB64-PE: uložení obrazovky
_FREEIMAGE buf&                              ' vždy uvolnit nepotřebné obrázky
IF obr& < -1 THEN _FREEIMAGE obr&
SLEEP

Fonty TrueType

SCREEN _NEWIMAGE(800, 300, 32)
f& = _LOADFONT("C:\Windows\Fonts\arial.ttf", 36)   ' Linux: /usr/share/fonts/...
IF f& > 0 THEN
    _FONT f&
    COLOR _RGB32(255, 200, 0)
    _PRINTSTRING (20, 20), "Velký nápis"
    PRINT "Šířka textu:"; _PRINTWIDTH("Velký nápis"); "px"
    PRINT "Výška fontu:"; _FONTHEIGHT
    _FONT 16                     ' zpět na vestavěný 8×16
    _FREEFONT f&
END IF
SLEEP

Okno programu

$RESIZE:STRETCH                  ' uživatel může měnit velikost okna, obsah se roztáhne
SCREEN _NEWIMAGE(320, 200, 32)
_TITLE "Retro okno"
_FULLSCREEN _SQUAREPIXELS        ' celá obrazovka se zachováním poměru pixelů
' _FULLSCREEN _OFF               ' zpět do okna
PRINT _DESKTOPWIDTH; "x"; _DESKTOPHEIGHT
_ICON                            ' ikona okna (bez parametru = ikona EXE)
DO: _LIMIT 30: LOOP UNTIL INKEY$ <> "" OR _EXIT
SYSTEM

13Klávesnice a myš

_KEYDOWN – plynulé ovládání ve hrách

SCREEN _NEWIMAGE(640, 480, 32)
CONST K_NAHORU = 18432, K_DOLU = 20480, K_VLEVO = 19200, K_VPRAVO = 19712
CONST K_MEZERNIK = 32, K_ESC = 27
x = 320: y = 240
DO
    IF _KEYDOWN(K_VLEVO) THEN x = x - 4
    IF _KEYDOWN(K_VPRAVO) THEN x = x + 4
    IF _KEYDOWN(K_NAHORU) THEN y = y - 4
    IF _KEYDOWN(K_DOLU) THEN y = y + 4
    IF _KEYDOWN(K_MEZERNIK) THEN barva~& = _RGB32(255, 0, 0) ELSE barva~& = _RGB32(0, 255, 0)
    CLS
    LINE (x - 10, y - 10)-(x + 10, y + 10), barva~&, BF
    _DISPLAY
    _LIMIT 60
LOOP UNTIL _KEYDOWN(K_ESC)
SYSTEM

_KEYHIT – stisk i uvolnění

PRINT "Mačkej klávesy, Esc = konec"
DO
    k& = _KEYHIT
    IF k& > 0 THEN PRINT "stisk   "; k&
    IF k& < 0 THEN PRINT "uvolnění"; -k&
    _LIMIT 100
LOOP UNTIL k& = 27
_KEYCLEAR                        ' vyprázdni klávesový buffer

Myš

SCREEN _NEWIMAGE(800, 600, 32)
_TITLE "Kreslítko – levé tlačítko kreslí, pravé maže, kolečko mění tloušťku"
tl = 3
DO
    DO WHILE _MOUSEINPUT                 ' zpracuj všechny události myši
        tl = tl - _MOUSEWHEEL            ' kolečko: -1 nahoru, 1 dolů
        IF tl < 1 THEN tl = 1
        IF tl > 40 THEN tl = 40
    LOOP
    mx = _MOUSEX: my = _MOUSEY
    IF _MOUSEBUTTON(1) THEN
        IF kreslim THEN
            ' spojitá čára mezi posledními pozicemi
            dx = mx - px: dy = my - py
            krok = ABS(dx): IF ABS(dy) > krok THEN krok = ABS(dy)
            IF krok = 0 THEN krok = 1
            FOR i = 0 TO krok
                CIRCLE (px + dx * i / krok, py + dy * i / krok), tl, _RGB32(255, 220, 0)
                PAINT (px + dx * i / krok, py + dy * i / krok), _RGB32(255, 220, 0)
            NEXT
        END IF
        kreslim = -1
    ELSE
        kreslim = 0
    END IF
    IF _MOUSEBUTTON(2) THEN CLS
    px = mx: py = my
    _LIMIT 120
LOOP UNTIL _KEYDOWN(27)
SYSTEM

_MOUSEBUTTON(1) = levé, (2) = pravé, (3) = prostřední tlačítko. Další příkazy: _MOUSEHIDE, _MOUSESHOW, _MOUSEMOVE x, y.

14Zvuk a hudba

BEEP, SOUND, PLAY

BEEP
SOUND 440, 18.2                  ' 440 Hz, 1 s (délka v tikách: 18,2 tiku = 1 s)
SOUND 880, 9.1

' PLAY – jazyk MML: T tempo, O oktáva, L délka, < > o oktávu dolů/nahoru
PLAY "T140 O4 L8 C D E F G4 G4 A A A A G2"
PLAY "MB O3 L4 E E F G G F E D"   ' MB = hraje na pozadí, program pokračuje

' Pomlka P, tečka prodlouží, # nebo + = křížek, - = béčko
PLAY "L4 C E G P4 C. E8 G2 F# B-"

Zvukové soubory

hudba& = _SNDOPEN("hudba.ogg")            ' OGG, WAV, MP3, FLAC, MOD/XM/IT, MIDI (PE)
efekt& = _SNDOPEN("vystrel.wav")
IF hudba& = 0 THEN PRINT "Soubor se nenačetl": END

_SNDVOL hudba&, 0.6                       ' hlasitost 0..1
_SNDBAL hudba&, -1                        ' vyvážení: -1 vlevo .. 1 vpravo
_SNDLOOP hudba&                           ' opakovat dokola
PRINT "Délka:"; _SNDLEN(hudba&); "s   Mezerník = efekt, Esc = konec"
DO
    k$ = INKEY$
    IF k$ = " " THEN _SNDPLAYCOPY efekt&   ' kopie – může znít vícekrát současně
    LOCATE 3, 1: PRINT USING "Pozice: ###.# s"; _SNDGETPOS(hudba&)
    _LIMIT 30
LOOP UNTIL k$ = CHR$(27)
_SNDSTOP hudba&
_SNDCLOSE hudba&: _SNDCLOSE efekt&

Syntéza zvuku: _SNDRAW

' Generátor tónu – vzorky v rozsahu -1..1
DIM nota AS INTEGER
vzorkovani = _SNDRATE                     ' obvykle 44100 nebo 48000
FOR nota = 0 TO 7
    f# = 261.63 * 2 ^ (Stupnice%(nota) / 12)  ' C dur od C4
    FOR i& = 0 TO vzorkovani * 0.3
        obalka# = 1 - i& / (vzorkovani * 0.3)  ' lineární doznívání
        _SNDRAW SIN(2 * _PI * f# * i& / vzorkovani) * 0.4 * obalka#
    NEXT
NEXT
DO WHILE _SNDRAWLEN > 0: _LIMIT 50: LOOP  ' počkej, až buffer dohraje
END

FUNCTION Stupnice% (n AS INTEGER)
    Stupnice% = VAL(MID$("0002040507091112", n * 2 + 1, 2))  ' půltóny od C
END FUNCTION

15Soubory a adresáře

Režim OPENPoužitíČtení / zápis
FOR OUTPUTnový textový soubor (přepíše existující)PRINT #, WRITE #
FOR APPENDpřidávání na konecPRINT #, WRITE #
FOR INPUTčtení textu (soubor musí existovat)INPUT #, LINE INPUT #
FOR BINARYlibovolný přístup po bajtechGET #, PUT #
FOR RANDOMzáznamy pevné délkyGET #, PUT # s číslem záznamu

Textové soubory

f = FREEFILE                          ' volné číslo souboru
OPEN "poznamky.txt" FOR OUTPUT AS #f
PRINT #f, "První řádek"
PRINT #f, "Číslo:"; 42
WRITE #f, "Kolín", 280, 3.5           ' zapíše: "Kolín",280,3.5
CLOSE #f

OPEN "poznamky.txt" FOR APPEND AS #f
PRINT #f, "Přidaný řádek"
CLOSE #f

' Čtení po řádcích
OPEN "poznamky.txt" FOR INPUT AS #f
DO UNTIL EOF(f)
    LINE INPUT #f, radek$
    PRINT "> "; radek$
LOOP
CLOSE #f

' Čtení hodnot oddělených čárkou
OPEN "mesta.csv" FOR INPUT AS #f
DO UNTIL EOF(f)
    INPUT #f, mesto$, obyvatel&
    PRINT mesto$, obyvatel&
LOOP
CLOSE

Binární soubory

' Výpis prvních 64 bajtů souboru v hex (hexdump)
soubor$ = "program.exe"
IF NOT _FILEEXISTS(soubor$) THEN PRINT "Soubor neexistuje": END
f = FREEFILE
OPEN soubor$ FOR BINARY AS #f
PRINT "Velikost:"; LOF(f); "B"
DIM b AS _UNSIGNED _BYTE
FOR i = 1 TO 64
    IF EOF(f) THEN EXIT FOR
    GET #f, , b                           ' prázdná pozice = čti dál
    PRINT RIGHT$("0" + HEX$(b), 2); " ";
    IF i MOD 16 = 0 THEN PRINT
NEXT
CLOSE #f

' Celý soubor najednou do řetězce
OPEN soubor$ FOR BINARY AS #f
obsah$ = SPACE$(LOF(f))
GET #f, 1, obsah$                         ' čte tolik bajtů, kolik má řetězec
CLOSE #f

' Zápis čísel binárně
OPEN "cisla.bin" FOR BINARY AS #f
DIM hodnota AS LONG
hodnota = 123456: PUT #f, 1, hodnota      ' pozice 1 = první bajt
PRINT "Pozice:"; SEEK(f)                  ' 5
CLOSE #f

' QB64-PE: jednořádkové čtení a zápis celého souboru
_WRITEFILE "kopie.txt", obsah$
text$ = _READFILE$("kopie.txt")

Soubory s náhodným přístupem (RANDOM)

TYPE Zakaznik
    jmeno AS STRING * 30
    telefon AS STRING * 15
    kredit AS LONG
END TYPE
DIM z AS Zakaznik

f = FREEFILE
OPEN "zakaznici.dat" FOR RANDOM AS #f LEN = LEN(z)
z.jmeno = "Jan Novák": z.telefon = "777 123 456": z.kredit = 500
PUT #f, 1, z                         ' záznam číslo 1
z.jmeno = "Eva Malá": z.telefon = "603 987 654": z.kredit = 120
PUT #f, 2, z

pocet = LOF(f) \ LEN(z)
FOR i = 1 TO pocet
    GET #f, i, z
    PRINT i; RTRIM$(z.jmeno); " – "; RTRIM$(z.telefon); z.kredit
NEXT
CLOSE #f

Adresáře a správa souborů

PRINT "Aktuální adresář: "; _CWD$
PRINT "Adresář programu: "; _STARTDIR$

IF NOT _DIREXISTS("zalohy") THEN MKDIR "zalohy"
CHDIR "zalohy"
CHDIR ".."
IF _FILEEXISTS("stary.txt") THEN NAME "stary.txt" AS "zalohy/novy.txt"
IF _FILEEXISTS("smazat.tmp") THEN KILL "smazat.tmp"   ' KILL podporuje i *.tmp
' RMDIR "zalohy"                     ' smaže jen prázdný adresář

FILES "*.bas"                        ' vypíše soubory na obrazovku

' QB64-PE: procházení adresáře
soubor$ = _FILES$("*.bas")
DO WHILE LEN(soubor$)
    PRINT soubor$
    soubor$ = _FILES$                ' další položka, "" = konec
LOOP

Lomítko / funguje v cestách na Windows i Linuxu. Na Linuxu a macOS se v názvech souborů rozlišuje velikost písmen.

16Ošetření chyb a ladění

ON ERROR GOTO Chyba               ' handler musí ležet v hlavním modulu

OPEN "neexistuje.txt" FOR INPUT AS #1
PRINT "Pokračuji po chybě"
x = 10 \ nula                     ' celočíselné dělení nulou = chyba 11
PRINT "Konec programu"
END

Chyba:
    PRINT "Chyba"; ERR; "na řádku"; _ERRORLINE; ": "; _ERRORMESSAGE$(ERR)
    RESUME NEXT                   ' pokračuj příkazem za chybou
    ' RESUME                      ' zopakuj chybný příkaz
    ' RESUME Navesti              ' pokračuj na návěští
' Vyvolání chyby a dočasné vypnutí obsluhy
ON ERROR GOTO Obsluha
ERROR 53                          ' simuluje "File not found"
ON ERROR GOTO 0                   ' vypne vlastní obsluhu
END
Obsluha:
    PRINT "Zachyceno:"; ERR
    RESUME NEXT

Ladicí nástroje

$DEBUG                            ' v IDE: F7/F8 krokování, F9 breakpoint, sledování proměnných
$ASSERTS                          ' zapne _ASSERT (bez něj se ignoruje)
$CONSOLE

vek = 15
_ASSERT vek >= 0, "Věk nesmí být záporný"
_ECHO "vek =" + STR$(vek)          ' výpis do konzole bez zásahu do grafiky

$CHECKING:OFF                     ' vypne kontroly mezí polí (rychlejší, riskantnější)
' ... výkonově kritický kód ...
$CHECKING:ON

17Čas, systém a dialogy

Čas a datum

PRINT DATE$                        ' MM-DD-RRRR, např. 11-02-2026
PRINT TIME$                        ' HH:MM:SS
PRINT TIMER                        ' sekundy od půlnoci (SINGLE)
d$ = DATE$
PRINT MID$(d$, 4, 2); "."; LEFT$(d$, 2); "."; RIGHT$(d$, 4)   ' český formát

' Měření doby běhu
zacatek# = TIMER(0.001)            ' přesnost 1 ms
FOR i& = 1 TO 10000000: x# = x# + SQR(i&): NEXT
konec# = TIMER(0.001)
IF konec# < zacatek# THEN konec# = konec# + 86400   ' přes půlnoc
PRINT USING "Trvalo ##.### s"; konec# - zacatek#

' Odpočet
FOR s = 5 TO 1 STEP -1
    PRINT s; : _DELAY 1
NEXT
PRINT "Start!"

Operační systém

PRINT _OS$                          ' např. [WINDOWS][64BIT]
IF INSTR(_OS$, "[WINDOWS]") THEN prikaz$ = "dir /b" ELSE prikaz$ = "ls"

SHELL prikaz$                       ' spustí příkaz a čeká
SHELL _HIDE "cmd /c dir > seznam.txt"   ' bez okna konzole
SHELL _DONTWAIT "notepad.exe"       ' spustí a nečeká
kod& = _SHELLHIDE("ping -n 1 127.0.0.1")  ' vrátí návratový kód

PRINT ENVIRON$("PATH")
PRINT ENVIRON$("USERNAME")

_CLIPBOARD$ = "Text do schránky"
PRINT _CLIPBOARD$

' Zachycení zavření okna křížkem
DO
    IF _EXIT THEN
        PRINT "Ukládám a končím..."
        _DELAY 1: SYSTEM
    END IF
    _LIMIT 30
LOOP

Dialogová okna (QB64-PE)

_MESSAGEBOX "Informace", "Uloženo.", "info"

odp& = _MESSAGEBOX("Dotaz", "Opravdu smazat?", "yesno", "question")
IF odp& = 1 THEN PRINT "Ano" ELSE PRINT "Ne"
' typy: "ok", "okcancel", "yesno", "yesnocancel"; ikony: "info", "warning", "error", "question"

jmeno$ = _INPUTBOX$("Registrace", "Zadej jméno:", "Pavel")

soubor$ = _OPENFILEDIALOG$("Otevřít", _STARTDIR$, "*.bas|*.bi", "Zdrojové kódy QB64")
IF soubor$ <> "" THEN PRINT "Vybráno: "; soubor$

cil$ = _SAVEFILEDIALOG$("Uložit jako", "vystup.txt", "*.txt", "Textové soubory")
slozka$ = _SELECTFOLDERDIALOG$("Vyber složku")
_NOTIFYPOPUP "QB64", "Hotovo!", "info"     ' systémová notifikace

18Metapříkazy

Metapříkazy začínají znakem $ a řídí překlad. Starší tvar s komentářem ('$INCLUDE:, '$DYNAMIC) je kvůli kompatibilitě s QuickBASICem stále platný.

MetapříkazVýznam
$CONSOLEpřidá konzolové okno vedle grafického
$CONSOLE:ONLYpouze konzole, bez grafického okna
$SCREENHIDE / $SCREENSHOWskryje / zobrazí okno programu při startu
$RESIZE:ON / :STRETCH / :SMOOTHpovolí změnu velikosti okna (_RESIZE, _RESIZEWIDTH)
$EXEICON:'ikona.ico'ikona EXE souboru (Windows)
$VERSIONINFO:CompanyName=…metadata EXE (FileVersion#, ProductName…)
'$INCLUDE:'soubor.bi'vloží zdrojový soubor (hlavičky .bi nahoru, rutiny .bm dolů)
$DYNAMIC / $STATICvýchozí typ polí
$CHECKING:OFF / :ONvypne / zapne kontrolu chyb a mezí
$DEBUGladicí režim v IDE
$ASSERTS / $ASSERTS:CONSOLEaktivuje _ASSERT
$NOPREFIXklíčová slova QB64 bez podtržítka (NEWIMAGE místo _NEWIMAGE)
$COLOR:0 / $COLOR:32pojmenované konstanty barev (Red, SkyBlue…)
$LET, $IF … THEN / $ELSEIF / $ELSE / $END IFpodmíněný překlad
$ERROR zprávazastaví překlad s chybovou zprávou
$UNSTABLE:…zapne experimentální funkce
$CONSOLE
$EXEICON:'hra.ico'
$VERSIONINFO:ProductName=Moje hra
$VERSIONINFO:FileVersion#=1,0,0,0
$COLOR:32

$LET LADENI = 1
$IF WIN THEN
    CONST SYSTEM_NAZEV = "Windows"
$ELSEIF LINUX THEN
    CONST SYSTEM_NAZEV = "Linux"
$ELSE
    CONST SYSTEM_NAZEV = "macOS"
$END IF

SCREEN _NEWIMAGE(400, 200, 32)
COLOR Gold, NavyBlue
CLS
PRINT "Běží na: "; SYSTEM_NAZEV
$IF LADENI = 1 THEN
    _ECHO "ladicí sestavení"
$END IF
SLEEP

'$INCLUDE:'knihovna.bm'

Předdefinované proměnné pro $IF: WIN/WINDOWS, LINUX, MAC/MACOSX, 32BIT, 64BIT, VERSION.

19Přímý přístup do paměti (_MEM)

_MEM je struktura s poli .OFFSET, .SIZE, .TYPE a .ELEMENTSIZE. Umožňuje bezpečně a rychle pracovat s bloky paměti, obrazovými daty a poli bez volání po jednotlivých prvcích.

Příkaz / funkcePopis
_MEMNEW(bajtů)alokuje nový blok
_MEM(proměnná)blok nad existující proměnnou nebo polem
_MEMIMAGE(handle)blok nad pixely obrázku (0 = obrazovka)
_MEMGET(m, offset, typ)čte hodnotu daného typu
_MEMPUT m, offset, hodnota AS typzapíše hodnotu
_MEMFILL m, offset, bajtů, hodnota AS typvyplní oblast
_MEMCOPY zdroj, off, bajtů TO cil, offkopíruje blok
_MEMFREE muvolní (povinné u _MEMNEW a _MEMIMAGE)

Plazmový efekt přes _MEMIMAGE

SCREEN _NEWIMAGE(320, 240, 32)
_FULLSCREEN _SQUAREPIXELS
DIM m AS _MEM, o AS _OFFSET
DIM x AS LONG, y AS LONG, t AS SINGLE, v AS SINGLE, c AS LONG
m = _MEMIMAGE(0)
DO
    t = t + 0.05
    o = m.OFFSET
    FOR y = 0 TO 239
        FOR x = 0 TO 319
            v = SIN(x / 16 + t) + SIN(y / 8 - t) + SIN((x + y) / 16 + t)
            c = (v + 3) * 42                         ' 0..252
            _MEMPUT m, o, _RGB32(c, 255 - c, 128 + c \ 2) AS _UNSIGNED LONG
            o = o + 4                                ' 4 bajty na pixel (BGRA)
        NEXT
    NEXT
    _DISPLAY
    _LIMIT 30
LOOP UNTIL _KEYHIT = 27
_MEMFREE m
SYSTEM

Práce s polem a vlastním blokem

DIM a(1 TO 1000) AS LONG
DIM ma AS _MEM
ma = _MEM(a())
_MEMFILL ma, ma.OFFSET, ma.SIZE, 7 AS LONG     ' všechny prvky = 7
PRINT a(1), a(1000), ma.SIZE                   ' 7  7  4000

DIM b(1 TO 1000) AS LONG
DIM mb AS _MEM
mb = _MEM(b())
_MEMCOPY ma, ma.OFFSET, ma.SIZE TO mb, mb.OFFSET   ' rychlá kopie pole
PRINT b(500)

DIM buf AS _MEM
buf = _MEMNEW(16)
_MEMPUT buf, buf.OFFSET, 3.14159 AS SINGLE
_MEMPUT buf, buf.OFFSET + 4, 65535 AS _UNSIGNED INTEGER
PRINT _MEMGET(buf, buf.OFFSET, SINGLE)
PRINT _MEMGET(buf, buf.OFFSET + 4, _UNSIGNED INTEGER)
_MEMFREE buf: _MEMFREE ma: _MEMFREE mb

20Externí knihovny (DECLARE LIBRARY)

Windows API přes DLL

DECLARE DYNAMIC LIBRARY "user32"
    FUNCTION MessageBoxA& (BYVAL hwnd AS _OFFSET, zprava AS STRING, titulek AS STRING, BYVAL typ AS _UNSIGNED LONG)
    FUNCTION GetSystemMetrics& (BYVAL index AS LONG)
END DECLARE

DECLARE DYNAMIC LIBRARY "kernel32"
    SUB Sleep (BYVAL ms AS _UNSIGNED LONG)
END DECLARE

' Řetězce pro C funkce ukončete nulovým znakem
r& = MessageBoxA&(_WINDOWHANDLE, "Ahoj z WinAPI" + CHR$(0), "QB64" + CHR$(0), 4 + 64)
IF r& = 6 THEN PRINT "Zvoleno Ano" ELSE PRINT "Zvoleno Ne"
PRINT "Šířka obrazovky:"; GetSystemMetrics&(0)
Sleep 500

Vlastní C/C++ kód přes hlavičkový soubor

' Soubor pomoc.h ve stejném adresáři jako .bas:
'   int secti(int a, int b) { return a + b; }
'   double prumer3(double a, double b, double c) { return (a + b + c) / 3.0; }

DECLARE LIBRARY "pomoc"              ' název hlavičky bez přípony .h
    FUNCTION secti& (BYVAL a AS LONG, BYVAL b AS LONG)
    FUNCTION prumer3# (BYVAL a AS DOUBLE, BYVAL b AS DOUBLE, BYVAL c AS DOUBLE)
END DECLARE

PRINT secti&(40, 2)
PRINT prumer3#(1, 2, 6)

Standardní knihovna C

DECLARE LIBRARY                       ' bez názvu = funkce dostupné v runtime
    FUNCTION getpid& ()
END DECLARE
PRINT "PID procesu:"; getpid&

BYVAL je nutné u parametrů, které C očekává hodnotou. Řetězec bez BYVAL se předá jako ukazatel na data (char*). Typy: LONG = int32, _INTEGER64 = int64, _OFFSET = ukazatel / size_t.

21Kompletní programy

Hotové programy ke zkopírování a spuštění klávesou F5. Texty na obrazovce jsou bez diakritiky, aby se zobrazily správně i ve výchozí kódové stránce.

Hra Had

' HAD – šipky = směr, Esc = konec
SCREEN _NEWIMAGE(640, 480, 32)
_TITLE "Had"
RANDOMIZE TIMER

CONST BUNKA = 16, SL = 40, RA = 30           ' 40 × 30 políček po 16 px
DIM SHARED hx(1 TO 1200) AS INTEGER, hy(1 TO 1200) AS INTEGER
DIM SHARED delka AS INTEGER, jx AS INTEGER, jy AS INTEGER
DIM smer AS INTEGER, zadany AS INTEGER, i AS INTEGER
DIM nx AS INTEGER, ny AS INTEGER, skore AS LONG, rekord AS LONG
DIM k AS LONG, konec AS INTEGER

Restart:
delka = 4: smer = 1: zadany = 1: skore = 0
FOR i = 1 TO delka: hx(i) = 20 - i: hy(i) = 15: NEXT
NoveJidlo

DO
    ' --- vstup: vyber všechny stisky z bufferu ---
    DO
        k = _KEYHIT
        SELECT CASE k
            CASE 18432: zadany = 0        ' nahoru
            CASE 19712: zadany = 1        ' vpravo
            CASE 20480: zadany = 2        ' dolu
            CASE 19200: zadany = 3        ' vlevo
            CASE 27: SYSTEM
        END SELECT
    LOOP UNTIL k = 0
    IF zadany <> (smer + 2) MOD 4 THEN smer = zadany   ' zakaz otoceni o 180°

    ' --- pohyb ---
    nx = hx(1): ny = hy(1)
    SELECT CASE smer
        CASE 0: ny = ny - 1
        CASE 1: nx = nx + 1
        CASE 2: ny = ny + 1
        CASE 3: nx = nx - 1
    END SELECT

    konec = 0
    IF nx < 0 OR nx >= SL OR ny < 0 OR ny >= RA THEN konec = -1
    FOR i = 1 TO delka - 1
        IF hx(i) = nx AND hy(i) = ny THEN konec = -1
    NEXT
    IF konec THEN EXIT DO

    IF nx = jx AND ny = jy THEN               ' snedl jidlo – had se prodlouzi
        delka = delka + 1
        skore = skore + 10
        FOR i = delka TO 2 STEP -1: hx(i) = hx(i - 1): hy(i) = hy(i - 1): NEXT
        hx(1) = nx: hy(1) = ny
        NoveJidlo
        SOUND 880, 0.5
    ELSE
        FOR i = delka TO 2 STEP -1: hx(i) = hx(i - 1): hy(i) = hy(i - 1): NEXT
        hx(1) = nx: hy(1) = ny
    END IF

    ' --- vykresleni ---
    CLS , _RGB32(15, 25, 15)
    LINE (jx * BUNKA + 2, jy * BUNKA + 2)-STEP(BUNKA - 5, BUNKA - 5), _RGB32(230, 50, 50), BF
    FOR i = delka TO 1 STEP -1
        IF i = 1 THEN c~& = _RGB32(180, 255, 120) ELSE c~& = _RGB32(60, 190, 60)
        LINE (hx(i) * BUNKA, hy(i) * BUNKA)-STEP(BUNKA - 2, BUNKA - 2), c~&, BF
    NEXT
    _PRINTSTRING (8, 4), "Skore:" + STR$(skore) + "   Rekord:" + STR$(rekord)
    _DISPLAY
    _LIMIT 8 + delka \ 5                       ' had postupne zrychluje
LOOP

' --- konec hry ---
IF skore > rekord THEN rekord = skore
SOUND 150, 6
_PRINTSTRING (240, 220), "KONEC HRY! Skore:" + STR$(skore)
_PRINTSTRING (200, 240), "Enter = znovu,  Esc = konec"
_DISPLAY
_KEYCLEAR
DO
    k = _KEYHIT
    IF k = 13 THEN GOTO Restart
    _LIMIT 30
LOOP UNTIL k = 27
SYSTEM

SUB NoveJidlo
    DIM i AS INTEGER, volno AS INTEGER
    DO
        jx = INT(RND * SL): jy = INT(RND * RA)
        volno = -1
        FOR i = 1 TO delka
            IF hx(i) = jx AND hy(i) = jy THEN volno = 0
        NEXT
    LOOP UNTIL volno
END SUB

Mandelbrotova množina se zoomem

' Levé tlačítko = přiblížit, pravé = oddálit, Esc = konec
SCREEN _NEWIMAGE(800, 600, 32)
_TITLE "Mandelbrot"
DIM SHARED cx AS DOUBLE, cy AS DOUBLE, mer AS DOUBLE
DIM px AS LONG, py AS LONG, it AS LONG, maxIt AS LONG
DIM x AS DOUBLE, y AS DOUBLE, xt AS DOUBLE, x0 AS DOUBLE, y0 AS DOUBLE
cx = -0.5: cy = 0: mer = 3.2 / 800: maxIt = 256

Kresli:
FOR py = 0 TO 599
    y0 = cy + (py - 300) * mer
    FOR px = 0 TO 799
        x0 = cx + (px - 400) * mer
        x = 0: y = 0: it = 0
        DO WHILE x * x + y * y <= 4 AND it < maxIt
            xt = x * x - y * y + x0
            y = 2 * x * y + y0
            x = xt
            it = it + 1
        LOOP
        IF it = maxIt THEN
            PSET (px, py), _RGB32(0, 0, 0)
        ELSE
            PSET (px, py), _RGB32(127 + 127 * SIN(it * 0.15), 127 + 127 * SIN(it * 0.15 + 2), 127 + 127 * SIN(it * 0.15 + 4))
        END IF
    NEXT
    IF py MOD 25 = 0 THEN _DISPLAY
    IF _KEYDOWN(27) THEN SYSTEM
NEXT
_PRINTSTRING (5, 5), "Meritko:" + STR$(mer)
_DISPLAY

DO
    DO WHILE _MOUSEINPUT: LOOP
    IF _MOUSEBUTTON(1) OR _MOUSEBUTTON(2) THEN
        cx = cx + (_MOUSEX - 400) * mer
        cy = cy + (_MOUSEY - 300) * mer
        IF _MOUSEBUTTON(1) THEN mer = mer / 3 ELSE mer = mer * 3
        CekejNaUvolneni
        GOTO Kresli
    END IF
    _LIMIT 30
LOOP UNTIL _KEYDOWN(27)
SYSTEM

SUB CekejNaUvolneni
    DO
        DO WHILE _MOUSEINPUT: LOOP
        _LIMIT 60
    LOOP WHILE _MOUSEBUTTON(1) OR _MOUSEBUTTON(2)
END SUB

Analogové hodiny

SCREEN _NEWIMAGE(400, 400, 32)
_TITLE "Hodiny"
CONST STRED = 200
DIM i AS INTEGER, r1 AS INTEGER, a AS DOUBLE
DIM h AS DOUBLE, m AS DOUBLE, s AS DOUBLE

DO
    CLS , _RGB32(28, 30, 42)
    CIRCLE (STRED, STRED), 185, _RGB32(200, 200, 210)
    FOR i = 0 TO 59                                  ' ciferník
        a = _D2R(i * 6)
        IF i MOD 5 = 0 THEN r1 = 155 ELSE r1 = 170
        LINE (STRED + r1 * SIN(a), STRED - r1 * COS(a))-(STRED + 178 * SIN(a), STRED - 178 * COS(a)), _RGB32(220, 220, 230)
    NEXT
    s = VAL(RIGHT$(TIME$, 2))
    m = VAL(MID$(TIME$, 4, 2)) + s / 60
    h = (VAL(LEFT$(TIME$, 2)) MOD 12) + m / 60
    Rucicka h * 30, 100, 5, _RGB32(255, 255, 255)     ' hodinová
    Rucicka m * 6, 145, 3, _RGB32(200, 220, 255)      ' minutová
    Rucicka s * 6, 160, 1, _RGB32(255, 80, 80)        ' vteřinová
    CIRCLE (STRED, STRED), 6, _RGB32(255, 80, 80)
    PAINT (STRED, STRED), _RGB32(255, 80, 80)
    _PRINTSTRING (STRED - 32, 290), TIME$
    _DISPLAY
    _LIMIT 10
LOOP UNTIL _KEYHIT = 27
SYSTEM

SUB Rucicka (uhel AS DOUBLE, delka AS INTEGER, tloustka AS INTEGER, barva AS _UNSIGNED LONG)
    DIM a AS DOUBLE, ox AS INTEGER, oy AS INTEGER
    a = _D2R(uhel)
    FOR ox = -tloustka \ 2 TO tloustka \ 2           ' tloušťka – víc rovnoběžných čar
        FOR oy = -tloustka \ 2 TO tloustka \ 2
            LINE (STRED + ox, STRED + oy)-(STRED + ox + delka * SIN(a), STRED + oy - delka * COS(a)), barva
        NEXT
    NEXT
END SUB

Telefonní seznam (soubor RANDOM)

TYPE Kontakt
    jmeno AS STRING * 25
    telefon AS STRING * 15
    email AS STRING * 30
END TYPE

DIM SHARED k AS Kontakt
DIM SHARED f AS INTEGER
CONST SOUBOR = "kontakty.dat"

f = FREEFILE
OPEN SOUBOR FOR RANDOM AS #f LEN = LEN(k)

DO
    COLOR 15, 1: CLS
    PRINT STRING$(40, 205)
    PRINT "  TELEFONNI SEZNAM       zaznamu:"; Pocet%
    PRINT STRING$(40, 205)
    COLOR 14: PRINT "  1"; : COLOR 15: PRINT " Pridat kontakt"
    COLOR 14: PRINT "  2"; : COLOR 15: PRINT " Vypsat vse"
    COLOR 14: PRINT "  3"; : COLOR 15: PRINT " Hledat"
    COLOR 14: PRINT "  4"; : COLOR 15: PRINT " Smazat"
    COLOR 14: PRINT "  0"; : COLOR 15: PRINT " Konec"
    PRINT
    DO: v$ = INKEY$: _LIMIT 30: LOOP UNTIL v$ <> ""
    SELECT CASE v$
        CASE "1": Pridat
        CASE "2": Vypsat ""
        CASE "3": LINE INPUT "Hledany text: ", h$: Vypsat h$
        CASE "4": Smazat
        CASE "0", CHR$(27): EXIT DO
    END SELECT
LOOP
CLOSE #f
SYSTEM

FUNCTION Pocet%
    Pocet% = LOF(f) \ LEN(k)
END FUNCTION

SUB Pridat
    LINE INPUT "Jmeno:   ", j$
    IF _TRIM$(j$) = "" THEN EXIT SUB
    k.jmeno = j$
    LINE INPUT "Telefon: ", t$: k.telefon = t$
    LINE INPUT "E-mail:  ", e$: k.email = e$
    PUT #f, Pocet% + 1, k
END SUB

SUB Vypsat (filtr AS STRING)
    DIM i AS INTEGER, n AS INTEGER
    PRINT
    COLOR 11: PRINT " #   JMENO                    TELEFON         E-MAIL": COLOR 15
    FOR i = 1 TO Pocet%
        GET #f, i, k
        IF _TRIM$(k.jmeno) <> "" THEN
            IF filtr = "" OR INSTR(UCASE$(k.jmeno + k.telefon + k.email), UCASE$(filtr)) THEN
                PRINT USING "###"; i;
                PRINT "  "; k.jmeno; k.telefon; " "; RTRIM$(k.email)
                n = n + 1
            END IF
        END IF
    NEXT
    PRINT: PRINT "Nalezeno:"; n; "   (klavesa = zpet)"
    SLEEP: _KEYCLEAR
END SUB

SUB Smazat
    INPUT "Cislo zaznamu ke smazani: ", c%
    IF c% < 1 OR c% > Pocet% THEN EXIT SUB
    GET #f, c%, k
    k.jmeno = ""                 ' prázdné jméno = smazaný záznam
    PUT #f, c%, k
END SUB

Hvězdné pole (3D efekt)

SCREEN _NEWIMAGE(800, 600, 32)
_TITLE "Hvezdne pole – sipky nahoru/dolu = rychlost"
RANDOMIZE TIMER
CONST N = 600
DIM sx(N) AS SINGLE, sy(N) AS SINGLE, sz(N) AS SINGLE
FOR i = 0 TO N
    sx(i) = RND * 1600 - 800: sy(i) = RND * 1200 - 600: sz(i) = RND * 800 + 1
NEXT
rychlost = 6
DO
    IF _KEYDOWN(18432) THEN rychlost = rychlost + 0.2
    IF _KEYDOWN(20480) AND rychlost > 0.5 THEN rychlost = rychlost - 0.2
    CLS
    FOR i = 0 TO N
        sz(i) = sz(i) - rychlost
        IF sz(i) < 1 THEN sz(i) = 800: sx(i) = RND * 1600 - 800: sy(i) = RND * 1200 - 600
        x = 400 + sx(i) * 200 / sz(i)
        y = 300 + sy(i) * 200 / sz(i)
        jas = 255 - sz(i) * 255 / 800
        IF sz(i) < 200 THEN
            LINE (x, y)-STEP(1, 1), _RGB32(jas, jas, 255), BF   ' blízké hvězdy větší
        ELSE
            PSET (x, y), _RGB32(jas, jas, jas)
        END IF
    NEXT
    _DISPLAY
    _LIMIT 60
LOOP UNTIL _KEYDOWN(27)
SYSTEM

22Referenční tabulky

Barvy SCREEN 0 / 12 (COLOR 0–15)

0 černá 1 modrá 2 zelená 3 azurová 4 červená 5 purpurová 6 hnědá 7 světle šedá 8 tmavě šedá 9 světle modrá 10 světle zelená 11 světle azurová 12 světle červená 13 světle purpurová 14 žlutá 15 bílá

V textovém režimu přičtení 16 k barvě popředí zapne blikání: COLOR 14 + 16, 1.

Kódy kláves pro _KEYDOWN a _KEYHIT

KlávesaKódKlávesaKód
Šipka nahoru18432Esc27
Šipka dolů20480Enter13
Šipka vlevo19200Backspace8
Šipka vpravo19712Tab9
Home18176Mezerník32
End20224F1 … F1015104 … 17408 (krok 256)
Page Up18688F11 / F1234048 / 34304
Page Down20736Levý / pravý Shift100304 / 100303
Insert20992Levý / pravý Ctrl100306 / 100305
Delete21248Levý / pravý Alt100308 / 100307
A–Z65–90 (s Shiftem) / 97–1220–948–57

Rozšířené klávesy mají kód = druhý bajt z INKEY$ × 256. Šipka nahoru: INKEY$ vrátí CHR$(0) + CHR$(72), 72 × 256 = 18432.

Rozšířené kódy INKEY$ (CHR$(0) + kód)

KódKlávesaKódKlávesa
59–68F1–F1079End
71Home80Šipka dolů
72Šipka nahoru81Page Down
73Page Up82Insert
75Šipka vlevo83Delete
77Šipka vpravo133 / 134F11 / F12

Nejčastější chybové kódy (ERR)

KódChybaKódChyba
3RETURN bez GOSUB53Soubor nenalezen
4Došla data (READ)54Špatný režim souboru
5Neplatné volání funkce55Soubor už je otevřen
6Přetečení61Disk je plný
7Nedostatek paměti62Čtení za koncem souboru
9Index mimo rozsah pole63Špatné číslo záznamu
11Dělení nulou64Neplatný název souboru
13Neshoda typů70Přístup odepřen
52Špatné číslo souboru75 / 76Chyba přístupu k cestě / cesta nenalezena

Rámečky z CP437

JednoduchýKódDvojitýKódVýplňKód
┌ ┐ └ ┘218 191 192 217╔ ╗ ╚ ╝201 187 200 188░ ▒ ▓176 177 178
─ │196 179═ ║205 186█ ▄ ▀219 220 223
├ ┤ ┬ ┴ ┼195 180 194 193 197╠ ╣ ╦ ╩ ╬204 185 203 202 206■ ·254 250
' Okno ve stylu QBasicu v textovém režimu
SUB Okno (r AS INTEGER, s AS INTEGER, v AS INTEGER, sir AS INTEGER, titul AS STRING)
    DIM i AS INTEGER
    COLOR 15, 1
    LOCATE r, s: PRINT CHR$(201); STRING$(sir - 2, 205); CHR$(187);
    FOR i = 1 TO v - 2
        LOCATE r + i, s: PRINT CHR$(186); SPACE$(sir - 2); CHR$(186);
    NEXT
    LOCATE r + v - 1, s: PRINT CHR$(200); STRING$(sir - 2, 205); CHR$(188);
    LOCATE r, s + (sir - LEN(titul) - 2) \ 2: PRINT " "; titul; " ";
END SUB

Užitečné zdroje