' Rapid-Q by William Yu (c)1999-2000                                             .
' ================================================================================
' Upload_il_tuo_script_su_Rapidq.it

' Capitolo_2__Nozioni_di_base_di_Rapid-Q

****** 2. Nozioni di base di Rapid-Q ******
Prima di affrontare qualunque linguaggio, è utile sapere prima come utilizzarlo.
Questo capitolo vi descriverà l'ambiente di Rapid-Q, come compilare ed eseguire i
vostri programmi, e come appare la struttura generale dei vostri programmi Rapid-Q.

2.1 Ambiente Rapid-Q
Il pacchetto di distribuzione di Rapid-Q dovrebbe comprendere un semplice IDE
(ambiente di sviluppo integrato), chiamato RAPIDQ.EXE, oltre al compilatore Rapid-
Q vero e proprio (RC.EXE). Per compilare qualunque programma sono anche necessari
RAPIDQ32.LIB e RAPIDQCC.LIB. Questi sono i quattro programmi principali necessari
per sviluppare e compilare il vostro codice sorgente Rapid-Q. L'IDE è strettamente
opzionale. Se preferite scrivere i nostri programmi con Blocco Note o qualunque
altro editor a vostra scelta, va bene. In questo caso, potete saltare la prossima
sezione che riguarda l'utilizzo dell'IDE di Rapid-Q. Tutti questi file devono
essere nella stessa cartella.

2. 2 Utilizzo dell'IDE Rapid-Q
Contrariamente ad alcuni IDE che offrono la possibilità di effettuare il debug,
l'IDE di Rapid-Q non è altro che un ambiente per scrivere i vostri programmi,
eseguirli, e fornire comandi opzionali all'esecuzione. Possiede qualche rudimentale
controllo di errore, ma dico rudimentale in quanto l'IDE non fa alcun controllo di
errore, li fa tutti il compilatore (RC.EXE). L'IDE si interfaccia molto bene con
RC.EXE, cosicché questo non è molto evidente. Inoltre, possiede un evidenziatore di
sintassi che rende molto più facile l'utilizzo di Rapid-Q.
    * Quali sono le limitazioni:
    * Non tutti i componenti sono disponibili nel disegnatore di form
    * Quando un file viene eseguito, viene automaticamente salvato
    * Tutti i file vengono compilati prima di essere eseguiti
Non posso parlare per chiunque, ma anche se l'IDE di Rapid-Q è un valido strumento
per imparare il linguaggio Rapid-Q, molti preferiranno tornare al loro editor di
testo preferito una volta acquisita una certa pratica con il linguaggio. Io
preferisco scrivere i programmi in DOS (EDIT.COM). Ciò non significa che dobbiate
smettere per forza di utilizzare l'IDE, se vi fa sentire a vostro agio, continuate
tranquillamente ad usarlo.

2. 3 Compilare ed eseguire un semplice programma
Aspetta un minuto, non abbiamo ancora parlato delle nozioni basilari per scrivere
un semplice programma. Non preoccupatevi, ci arriveremo, è meglio sapere come
compilare ed eseguire prima di qualsiasi altra cosa. Ecco un'applicazione GUI molto
semplice che potete scrivere e compilare voi stessi.
            DIM MainForm AS QFORM
            MainForm.ShowModal
Se state usando l'IDE Rapid-Q, digitate semplicemente questo codice (o se preferite
fate taglia & incolla). Cliccate sul menù Run e selezionate Run. Se va tutto
bene, dovreste vedere una finestra Windows posta nell'angolo alto a sinistra dello
schermo. Chiudetela e tornate al vostro IDE. Se preferite compilare dalla riga di
comando, aprite il vostro editor preferito, copiate il codice sopraindicato, e
salvatelo in un file (Forms.BAS). Poi, per compilarlo, digitate:
          RC Forms.BAS
Se va tutto bene, dovreste ottenere un file Forms.EXE nella directory corrente. Per
eseguirlo digitate semplicemente Forms. Se va tutto bene, continuate nella lettura.
In caso contrario, c'è qualche problema; in questo caso andate alla sezione
Risoluzione dei Problemi.

2. 4 Parametri della riga di comando per RC.EXE
Tratterò solo dei tre più importanti:
      -I[Path] Cambia Percorso Inclusioni
      -L[Path] Cambia Percorso Librerie
      -G[File] File icona
Il compilatore per default cerca i file .LIB e tutti i file da includere nella
directory corrente. Questo si può cambiare specificando i parametri della riga di
comando sopra indicati. Siccome si tratta di parametri di tipo C, ci sono alcuni
particolari che bisogna conoscere; prima di tutto i percorsi vanno indicati come
segue:
      RC -Ic:/rapidq/includes
Potete utilizzare \ invece di / ma c'è un motivo per cui / è preferibile;
considerate questo:
      RC -I'c:\rapidq long dir\includes\'
vete mai utilizzato C C++), probabilmente capirete cosa intendo. Se preferite
questa riga di comando, dovete aggiungere un?ulteriore \ alla fine (o non indicarla
del tutto), come segue:
      RC -I'c:\rapidq long dir\includes\\'
o
      RC -I'c:\rapidq long dir\includes'
Questo succede perché C traduce \' in ', e questo per un programmatore C è ovvio.
Inoltre, i nomi di file lunghi vanno indicati fra virgolette. Questi sono i
trucchi, adesso lo sapete (o lo sapevate già ). Inoltre, per cambiare l'icona del
vostro file .EXE, potete usare il parametro G:
      RC -Gzip.ico zipview.bas
Quando viene generato il vostro file ZIPVIEW.EXE, il file 'zip.ico' sostituirà 
l'icona standard. Notate che la vostra icona dovrà essere 32x32 e 16 colori (e 766
bytes).

2. 5 Struttura generale di un programma Rapid-Q
In realtà non esiste una struttura predefinita per un programma Basic, ma c'è uno
schema generale seguito quasi da tutti.
    * Direttive
      Dichiarazioni
      Variabili globali
      Programma principale
Questo è solo uno schema generale, i vostri programmi Rapid-Q possono essere
strutturati in diversi modi. Alcuni di questi danno risultati simili, mentre altri
danno risultati devastanti o più personalizzati. Per esempio, $INCLUDE è una
direttiva per importare un file in una determinata posizione. Se utilizzate
$INCLUDE da qualche parte nel vostro programma principale, esso avrà un effetto
diverso da quello che otterreste includendolo all'inizio del vostro programma.

2. 6 Quanto simile al linguaggio Basic è Rapid-Q?
Molto simile, tutti i comandi principali come DIM, PRINT, MID$, ecc. sono
ereditati. Ciò non significa che potrete trasferire in Rapid-Q i vostri programmi
QBasic basati sul DOS senza modifiche. Dal momento che Rapid-Q è basato su Windows,
con un supporto rudimentale per CONSOLE, si può tranquillamente affermare che non
potrete convertire direttamente i vostri programmi QBasic in Rapid-Q senza dover
riscrivere il 50-90% del codice sorgente (a seconda di cosa fa il codice). I
commenti in Rapid-Q cominciano con il simbolo ', proprio come QBasic, oppure potete
utilizzare REM. Potete inoltre separare le righe utilizzando il simbolo due punti
(:). Ciò ha lo stesso effetto dell'inizio di una nuova riga.
             PRINT 'Hello' : PRINT 'World'
         o
             PRINT 'Hello'
             PRINT 'World'
La maggior parte dei programmatori Basic si abiteranno facilmente al linguaggio.
Tuttavia, Rapid-Q non eredita le proprietà di Visual Basic. Ad esempio, non esiste
una procedura SUB MAIN, e nemmeno esistono identificatori pubblici o privati in
Rapid-Q. Il vostro programma è considerato per intero il programma MAIN. Passare da
Rapid-Q a Visual Basic probabilmente è un po' più difficile che non il contrario.



' ===============================================================================
'                      2003 Holyguard.net - 2007_Abruzzoweb