`timer`

Cria um objeto timer que executa uma função após um atraso ou repetidamente.

Categoria: Programming > Programming Utilities

Sintaxe

t = timer

Cria um timer com as configurações padrão.

t = timer(Name, Value, ...)

Cria um timer e define propriedades como 'TimerFcn', 'StartDelay', 'Period', 'ExecutionMode', 'TasksToExecute' ou 'Name'.

Descrição

Criar um timer não faz nada por si só; start o arma e stop o desarma. O timer chama TimerFcn em segundo plano na sessão, o que o torna útil para consulta periódica, animações e ações atrasadas. As propriedades podem ser lidas e definidas com notação de ponto, por exemplo t.Period = 0.5, e TasksExecuted conta quantas vezes disparou.

Um timer que não é mais necessário deve ser removido com delete(t).

Argumentos de entrada

TimerFcn: Function handle chamado cada vez que o timer dispara. Recebe o objeto timer e um struct de evento.
StartDelay: Segundos de espera após start antes da primeira chamada. Padrão 0.
Period: Segundos entre chamadas nos modos repetitivos. Padrão 1.
ExecutionMode: 'singleShot' (padrão), 'fixedRate', 'fixedDelay' ou 'fixedSpacing'.
TasksToExecute: Número de disparos nos modos repetitivos. Padrão Inf.

Argumentos de saída

t: Objeto timer. É um handle: cópias se referem ao mesmo timer.

Exemplo

Três batidas em taxa fixa

t = timer('ExecutionMode', 'fixedRate', 'Period', 0.01, ...
          'TasksToExecute', 3, 'TimerFcn', @(~,~) disp('beat'));
start(t)
wait(t)
disp(t.TasksExecuted)
delete(t)

Saída

beat
beat
beat
     3

Veja também

start stop wait timerfind delete