Instruções de loop
As informações desta página de ajuda se aplicam tanto a Studio quanto a Desktop Studio.
Instruções de loop permitem que você faça o script desempenhar uma tarefa ou uma série de tarefas repetidamente até que a condição específica de encerramento seja atendida. Isso é útil se você tiver uma série de tarefas que deseja executar em cada membro de um conjunto.
As palavras-chave para instruções de loop são:
- FOR: Executa as instruções incorporadas enquanto uma expressão Booleana
Um tipo de dados que tem dois valores possíveis: verdadeiro e falso. for avaliada como verdadeira. - FOREACH: Executa as instruções incorporadas uma vez para cada elemento em uma matriz.
- REPEAT: executa as instruções incorporadas por um número especificado de vezes.
Instruções de loop sempre exigem blocos de código condicionais. Os blocos são delimitados por chaves (
BREAK: encerra um conjunto de instruções de loop.
Limites de tempo de instrução de loop
Cada loop FOR, FOREACH ou REPEAT loop dentro de um SNIPPET é protegido por um limite de tempo de 500 ms. Se um loop exceder esse limite, a ação SNIPPET segue a ramificação de erro com o erro Too much time has elapsed. Isso evita o uso excessivo de recursos do sistema para loops fora de controle. O limite de tempo de 500 ms aplica-se somente ao trabalho do lado do script, incluindo atribuições, operações aritméticas, condições, acesso a matrizes, entre outros. Não se aplica à execução de ponta a ponta do código do snippet. Por exemplo, o tempo de espera por um sistema externo, como uma chamada de API REST ou de banco de dados, não conta para esse limite.
FOR instruções
Descrição: Repete uma instrução ou uma série de instruções por um número específico de vezes.
Sintaxe: FOR <var> = <start> TO <end> <{ ... [BREAK] }>
Detalhes: Um loop FOR repete o código entre chaves {...} uma vez para cada valor inteiro no alcance de <start> até <end>. As cláusulas <start> e <end>podem ser expressões ou valores literais. Com cada iteração, o valor atual no intervalo é atribuído a uma variável <var> nomeada na linha de cabeçalho do loop. Isso é chamado de variável da iteração.
A disposição opcional BREAK aborta o loop. O script então continua, executando o código após a chave de fechamento ou passando para a próxima Studio ação
Executa um processo em um script do Studio, como coletar dados de clientes ou reproduzir música..
O valor inicial de <start> e <end> são avaliados uma vez, no início do loop. Você pode modificar o valor <end> nas declarações do código dentro das chaves {...}. Também é possível modificar o valor de <var> de dentro do loop.
O valor de <start> não precisa ser menor que <end>. Se <end> for menor que <start>, o loop atravessa para baixo. Pelo menos uma iteração do loop sempre ocorrerá. Esse comportamento é diferente do de algumas outras linguagens de programação. Os exemplos a seguir ilustram este comportamento.
Neste exemplo, <end> é maior que <start>.O resultado é ph="123456789".
FOR i=1 TO 9
{
ph = "{ph}{i}"
}
Neste exemplo, <start> é maior que <end>.O resultado é ph="987654321".
FOR i=9 TO 1
{
ph = "{ph}{i}"
}
Exemplos
IF TEST = 1
{
ASSIGN Names = "Wes|Nate|Dan|Clay"
ASSIGN EyeColors = "Blue|Blue|Brown|Brown"
ASSIGN Signs = "Aquarius|Aries|Pisces|Leo"
ASSIGN Foods = "Spagetti|Pizza|Sushi|Deep Fried Twinkies"
}
DYNAMIC Persons
ASSIGN PeopleCount = Names.size
FOR i = 1 TO PeopleCount
{
ASSIGN Persons[i].Name = "{Names[i]}"
ASSIGN Persons[i].Eyecolor = "{EyeColors[i]}"
ASSIGN Persons[i].Sign = "{Signs[i]}"
ASSIGN Persons[i].Food = "{Foods[i]}"
}FOR i=1 TO 9
{
a = "{a}{i}"
}
//Result: a="123456789"
FOR i=9 TO 1
{
b = "{b}{i}"
}
//Result: b="987654321"
FOREACH instruções
Descrição: Repete um Loop uma vez para cada elemento na matriz de strings especificada.
Formato: FOREACH <var> IN <array> <{ ... [ BREAK ] }>
Detalhes: Um loop FOREACH repete o código dentro das chaves {...} uma vez para cada elemento de uma matriz de strings ou objeto de dados dinâmicos matriz. O valor de cada elemento da matriz é atribuído a uma variável <var> nomeada na linha de cabeçalho do loop.
A disposição opcional BREAK aborta o loop. O script então continua, executando o código após a chave de fechamento ou passando para a próxima Studio ação
Executa um processo em um script do Studio, como coletar dados de clientes ou reproduzir música..
O exemplo a seguir mostra um loop FOREACH que inclui uma instrução IF.
IF TEST = 1
{
ASSIGN Names="Odin|Freya|Thor|Loki"
}
ASSIGN SubCounter=1
FOREACH Name IN Names
{
IF Name = "Odin" | Name = "Freya"
{
ASSIGN NewNames[SubCounter]= "{Name}"
ASSIGN SubCounter=SubCounter + 1
}
}
REPEAT instruções
Descrição: executa os comandos designados um número especificado de vezes.
Sintaxe: REPEAT <expression> <{ ... [ BREAK ]}>
Detalhes: Este comando repete o código que está contido nas chaves {...} um número de vezes definido por <expression>. <expression> pode ser qualquer número inteiro positivo ou uma expressão avaliada como zero ou um número inteiro positivo.
Inclua a palavra-chave opcional
Executa um processo em um script do Studio, como coletar dados de clientes ou reproduzir música..
REPEAT 10
{
phone = "{phone}{random(10)}"
}
Instruções
Descrição: Imediatamente encerra um loop.
Sintaxe: BREAK
Detalhes: Quando a instrução BREAK é atingida, o Loop atual termina imediatamente. O script continua a executar o código snippet abaixo do loop até o fim.
BREAK é opcional. Se não estiver incluído, o loop continuará até que a condição de pausa definida seja atendida.