Ficheiros de Programas do Kwave

Estrutura Geral

Um programa do Kwave consiste numa lista de linhas, onde cada linha poderá ser:

  • um único comando,

  • uma lista de comandos, com dois ou mais comandos separados por ;.

  • um comentário,

  • uma legenda

  • ou uma linha vazia, contendo apenas espaços

Comentários e Linhas em Branco

Todos os caracteres a seguir a um # (excepto, quando for usado entre aspas ou quando estiver 'escapado') são tratados como comentários, sendo ignorados de forma silenciosa.

As linhas que tiverem apenas espaços em branco ou comentários também são ignoradas.

Terminação

Um programa 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 programa. Se quiser implementar uma possibilidade para o utilizador terminar um programa, poderá usar o comando msgbox(texto). Isto mostra uma janela de mensagem com os dois botões OK (que permite ao programa prosseguir) e Cancelar (que devolve um código de erro e termina o programa).

Legendas

As linhas que consistam apenas num identificador, seguido de um : são chamadas de legendas. As mesmas poderão ser referenciadas no programa com a palavra-chave especial GOTO [2], o que fará com que a execução do programa continue na localização dessa legenda (ver o exemplo abaixo).

Uma linha que tiver uma legenda não deverá conter mais conteúdos (excepto comentários ou espaços em branco) após o :.

Exemplo:

inicio:  # <= isto é uma legenda
                    # fazer algo...
                    msgbox(mais uma vez?)
                    GOTO inicio
        



[2] Nota: Não misture por favor a palavra-chave GOTO com o comando de texto goto (posição) !