Fitxers de script del Kwave

Estructura general

Un script del Kwave consisteix en una llista de línies, on cada línia pot ser:

  • una única ordre

  • una llista d'ordres, amb dues o més ordres concatenades per un caràcter de «;».

  • un comentari

  • una etiqueta

  • o una línia buida, la qual només contindrà espai/s en blanc

Comentaris i línies buides

Tots els caràcters que segueixin un caràcter de «#» (excepte quan s'utilitzen entre cometes o quan s'escapen) es tractaran com a comentaris, se'ls ignorarà silenciosament.

Les línies que només contenen espais en blanc o comentaris, s'ignoraran.

Finalització

Un script del Kwave finalitzarà quan totes les ordres s'hagin executat correctament sense cap error o quan una ordre hagi retornat un codi d'error. No hi ha cap ordre especial per a cancel·lar l'execució d'un script. Si voleu implementar una possibilitat perquè l'usuari finalitzi un script, podeu utilitzar l'ordre «msgbox(text)». Això mostrarà un quadre de missatge amb dos botons D'acord (permet continuar l'script) i Cancel·la (retornarà un codi d'error i aturarà l'script).

Etiquetes

Les línies que només consten d'un identificador, seguides d'un caràcter de «:» seran tractades com a etiquetes. A l'script es pot fer una referència posterior amb la paraula clau especial GOTO [2], la qual cosa farà que l'execució de l'script continuï a la ubicació d'aquesta etiqueta (vegeu l'exemple següent).

Una línia que contingui una etiqueta no haurà de contenir cap altre contingut (excepte els comentaris o espais en blanc) després del caràcter de «:».

Exemple:

inici:  # <= això és una etiqueta
                    # fer quelcom...
                    msgbox(una altra vegada?)
                    GOTO start
        



[2] Nota: no confondre la paraula clau «GOTO» amb l'ordre de text «goto(posició)»!