Arquivos de script do Kwave

Estrutura geral

Um script Kwave consiste em uma relação de linhas,onde cada linha pode ser:

  • um único comando,

  • uma lista de comando, com dois ou mais comandos associados por um ;.

  • um comentário,

  • um rótulo

  • ou uma linha vazia, que contém apenas espaço em branco

Comentários e linhas vazias

Todos os caracteres que seguem um # (exceto quando usado entre aspas ou quando esquecido) são tratados como comentários, e serão ignorados de forma silenciosa.

Linhas que contêm apenas espaço em branco ou comentários são também ignoradas.

Terminação

Um script do Kwave termina quando todos os comandos tiverem sido executados com sucesso e sem erros, ou quando um comando tiver devolvido um código de erro. Não existe nenhum comando especial para interromper a execução de um script. Se quiser implementar uma possibilidade para o usuário terminar um programa, poderá usar o comando msgbox(texto). Isto mostra uma janela de mensagem com dois botões ‘OK’ (que permite que o s cript continue) e ‘Cancelar’ (que devolve um código de erro e para o script).

Rótulos

Linhas que consistem apenas em um identificador, seguidas por um : são chamados de rótulos. Eles podem ser referenciados posteriormente no script pela palavra-chave especial GOTO [2], que fará com que a execução do script continue no local desse rótulo (ver o exemplo abaixo).

Uma linha que contém um rótulo não deve conter nenhum outro conteúdo (exceto comentários ou espaços em branco) após o :.

Exemplo:

início:  # <= isto é um rótulo
                    # fazer algo...
                    msgbox(mais uma vez?)
                    GOTO início
        



[2] Observação: Não misture a palavra-chaveGOTO com o comando de texto goto (posição) !