Variáveis
Uma variável é um valor salvo com um nome. Um passo a salva; os passos posteriores a usam
digitando $ e o nome em um campo, ou escolhendo-a em Salvo por etapas anteriores no menu de
valores (Parâmetros dos passos).
Salvar o resultado de um passo
Preencha Salvar resultado como em um passo para guardar o que ele devolve. Essa é a forma habitual de obter um valor: a janela que um passo encontrou, o texto que ele leu, a resposta que alguém escolheu.
O primeiro passo lê a área de transferência e salva o texto como copiado. O segundo o mostra em uma
caixa de mensagem.
Definir uma variável
O chip Definir variável adiciona um passo que guarda um valor que você digita. Ele tem três campos:
| Campo | O que contém |
|---|---|
| Variável | O nome. Um passo novo recebe um nome livre, como value ou value2. |
| Valor | O valor, $ e o nome de outra variável para copiar essa variável, ou uma leitura do menu de valores (Parâmetros dos passos), como Texto da área de transferência. |
| Tipo | Texto, Número inteiro, Número ou Verdadeiro ou falso. Fica oculto enquanto Valor contém uma leitura. |
O tipo é o que você escolhe, não o que o valor aparenta: com Texto, 42 é o texto "42", não o
número 42. O texto pode ficar vazio; os outros tipos precisam de um valor, verificado como em qualquer
campo (Parâmetros dos passos).
Uma leitura guarda o que lê quando o passo é executado, com o tipo próprio dessa leitura, então não há
Tipo a escolher. Digitar o nome de script da leitura com parênteses vazios, como
ClipboardGetText(), é o mesmo que escolhê-la, qualquer que seja o tipo. Um valor Texto que é uma
chamada de função interna com algo entre os parênteses, como WindowGetTitle($w), é guardado como
esses caracteres e não é executado; o formulário avisa isso. Para guardar o resultado dessa chamada,
use em vez disso Salvar resultado como no passo dessa função interna.
Definir uma variável que já existe substitui o valor dela.
Os tipos de valor
Todo valor tem um destes tipos. As palavras do editor e as da referência de script:
| No editor | Na referência de script | Exemplos |
|---|---|---|
| Texto | Text | Notepad, um texto vazio |
| Número inteiro | Integer | 0, -12, 0xB3, VirtualKey.F5 |
| Número | Real | 0.5, 2.0 |
| Verdadeiro ou falso | Bool | ligado / desligado, true / false |
| uma janela | Window | Janela de destino, uma janela que um passo encontrou |
Uma janela não pode ser digitada; ela vem do menu de valores ou do resultado de um passo. Como cada tipo conta como verdadeiro ou falso em uma condição está em Tipos de valor.
Nomes
Um nome de variável:
- usa letras, dígitos e
_, e não começa com um dígito; - não é
if,else,for,truenemfalse; - diferencia maiúsculas de minúsculas:
Windowewindowsão duas variáveis.
Um $ digitado no início de um nome é descartado, então $count e count nomeiam a mesma variável.
Regras importantes
- A ordem importa. Uma variável existe a partir do passo que a salva. O editor não verifica se uma variável é salva antes de ser usada, nem se, ao mover passos, o passo que a salva continua acima. Uma variável que nunca foi salva é lida como o número inteiro 0.
- As variáveis duram uma execução. Toda vez que a ação é executada, ela começa sem variáveis. Para guardar um valor entre execuções e reinicializações, use os passos Manter valor entre reinicializações e Ler valor mantido (de Todas as N funções internas…; consulte Como os scripts são executados).
- Um snippet tem as próprias variáveis. Um snippet chamado por uma ação não vê as variáveis da ação, e a ação não vê as do snippet.
- Não há aritmética. Um campo aceita um valor ou uma variável, nunca um cálculo como
$count + 1. Para isso, use Script (De Passos para Script).