Variáveis#

Introdução #

Os blocos de Variáveis no VEXcode VR permitem armazenar informação que o seu projeto poderá utilizar posteriormente. Uma variável é como um contentor rotulado que armazena um valor, como um número, um valor booleano ou uma lista de itens.

Utilizaria uma variável quando quisesse que o seu projeto se lembrasse de algo enquanto estivesse a ser executado. Por exemplo, uma variável poderia registar quantas vezes o robô se moveu, quantos objetos contou ou se um objetivo foi alcançado.

As variáveis são úteis quando a informação de um projeto pode mudar. Em vez de escrever o mesmo número ou resposta em vários locais, pode armazená-lo numa variável e atualizá-lo à medida que o projeto é executado. Isto torna o seu projeto mais fácil de modificar, verificar e compreender.

No VEXcode VR, os blocos de variáveis podem armazenar diferentes tipos de informação, incluindo números, valores booleanos como verdadeiro ou falso, listas e listas bidimensionais. Estes blocos são úteis quando um projeto precisa de contar, tomar decisões, acompanhar o progresso ou organizar informação.

Segue abaixo a lista dos blocos disponíveis:

Variáveis numéricas - Armazenam e modificam números.

variável numérica – Reporta o valor de uma variável numérica.
definir variável numérica – Atribui um valor a uma variável numérica.
alterar variável numérica – Aumenta ou diminui uma variável numérica por um valor definido.

Variáveis booleanas – Armazenam valores verdadeiro ou falso.

Variável booleana – Reporta o valor de uma variável booleana.
Definir variável booleana – Atribui um valor Verdadeiro ou Falso a uma variável booleana.

Listas – Armazene e gerencie coleções de valores.

item da lista – Reporta um valor de uma lista com base na sua posição.
substituir item da lista – Atualiza um item específico de uma lista.
set list items – Atribui valores a uma lista.
comprimento da lista – Reporta o número de itens de uma lista.

Listas 2D – Armazene e gerencie coleções de valores numa grelha.

Item de lista 2D – Reporta um valor de uma linha e coluna específicas numa lista 2D.
substituir item de lista 2D – Atualiza um item específico numa lista 2D.
definir itens de lista 2D – Atribui valores a uma lista 2D.
comprimento da lista 2D – Reporta o número de linhas ou colunas de uma lista 2D.

variável numérica #

O bloco de relatório de variável numérica reporta o valor numérico atribuído à variável.

O bloco de relatório de variáveis numéricas.#

(my_variable)

Parâmetro	Descrição
	Este bloco não possui parâmetros.

Exemplo

quando iniciar
[Display the value of the variable.]
definir [deliveries v] para [2]
imprimir (deliveries) ▶

definir variável numérica #

O bloco de pilha definir variável numérica atribui um valor a uma variável numérica.

Parâmetro	Descrição
variável	A variável numérica à qual será atribuído um valor. Os utilizadores podem selecionar uma variável existente, renomeá-la ou eliminá-la.
valor	O número atribuído à variável (pode ser um número inteiro, decimal ou um bloco numérico).

Exemplo

quando iniciar
[Display the value of the variable.]
definir [deliveries v] para [2]
imprimir (deliveries) ▶

alterar variável numérica #

O bloco de pilha alterar variável numérica aumenta ou diminui o valor de uma variável por uma determinada quantidade.

O bloco de pilha Alterar Variável Numérica.#

alterar [my_variable v] por (1)

Parâmetro	Descrição
variável	A variável numérica a modificar. Os utilizadores podem selecionar uma variável existente, renomeá-la ou eliminá-la.
valor	O valor pelo qual a variável deve ser aumentada ou diminuída.

Exemplo

quando iniciar
[Deliver a package twice.]
definir [deliveries v] para [0]
conduzir [frente v] por (100) [mm v] ▶
alterar [deliveries v] por [1]
conduzir [frente v] por (100) [mm v] ▶
alterar [deliveries v] por [1]
imprimir (deliveries) ▶

Variável booleana #

O bloco Variável booleana devolve um valor Verdadeiro ou Falso.

O bloco de relatório de variáveis booleanas.#

<my_boolean>

Parâmetro	Descrição
	Este bloco não possui parâmetros.

Exemplo

quando iniciar :: hat events
[Display a message if the variable is set to True.]
definir [my_boolean v] para <verdadeiro v>
se <my_boolean> então
imprimir [Boolean is True!] ▶
fim

definir variável booleana #

O bloco de pilha definir variável booleana atribui um valor Verdadeiro ou Falso a uma variável booleana.

O bloco de pilha “Definir variável booleana”.#

definir [my_boolean v] para <verdadeiro v>

Parâmetro	Descrição
variável	A variável booleana à qual será atribuído um valor. Os utilizadores podem selecionar uma variável existente, renomeá-la ou eliminá-la.
valor	Um valor booleano (Verdadeiro ou Falso).

Exemplo

quando iniciar
[Repeat until 3 deliveries are made.]
definir [finished v] para <falso v>
definir [deliveries v] para [0]
repetir até <finished>
conduzir [frente v] por (100) [mm v] ▶
alterar [deliveries v] por [1]

se <(deliveries) [math_equal v] [3]> então
definir [finished v] para <verdadeiro v>

item da lista #

O bloco de relatório item de lista reporta o valor de um item numa lista. Uma lista é uma variável que pode armazenar múltiplas variáveis do mesmo tipo.

O bloco de relatório de itens da lista.#

(item (1) de [my_list v])

Parâmetro	Descrição
índice	A posição do item na lista (a partir de 1).
variável	A variável de lista a partir da qual um item será reportado. Os utilizadores podem selecionar uma lista existente, renomeá-la ou eliminá-la.

Exemplo

quando iniciar
[Display the delivery locations.]
definir [delivery_spots v] para [Red House] [Green House] [Blue House]
conduzir [frente v] por (100) [mm v] ▶
imprimir (item (1) de [delivery_spots v]) ▶
conduzir [frente v] por (100) [mm v] ▶
imprimir (item (2) de [delivery_spots v]) ▶
conduzir [frente v] por (100) [mm v] ▶
imprimir (item (3) de [delivery_spots v]) ▶

substituir item da lista #

O bloco de pilha substituir item da lista atualiza um item específico de uma lista.

O bloco de pilha “Substituir item da lista”.#

substituir item (1) de [my_list v] por (1)

Parâmetro	Descrição
variável	A variável de lista que contém o item a modificar. Os utilizadores podem selecionar uma lista existente, renomeá-la ou eliminá-la.
índice	A posição do item na lista (a partir de 1).
valor	O novo valor atribuído ao item da lista especificado.

Exemplo

quando iniciar :: hat events
[Replace the first item in a list with 4.]
definir [my_list v] para (5) (1) (9)
substituir item (1) de [my_list v] por (4)
imprimir (item (1) de [my_list v]) ▶

itens da lista de conjuntos #

O bloco de pilha definir itens da lista define todos os itens da lista com os valores introduzidos.

O bloco de pilha de artigos da lista de conjuntos.#

definir [my_list v] para (0) (0) (0)

Parâmetro	Descrição
variável	A variável de lista está a receber valores. Os utilizadores podem selecionar uma lista existente, renomeá-la ou eliminá-la.
valores	Os valores a armazenar na lista, introduzidos como itens individuais.

Exemplo

quando iniciar :: hat events
[Display the last item in a list.]
definir [my_list v] para (1) (2) (3)
imprimir (item (3) de [my_list v]) ▶

comprimento da lista #

O bloco de relatório comprimento da lista informa o número de itens de uma lista.

O bloco de relatório “Comprimento da Lista”.#

(comprimento de [my_list v])

Parâmetro	Descrição
variável	A variável de lista para indicar o comprimento. Os utilizadores podem selecionar uma lista existente, renomeá-la ou eliminá-la.

Exemplo

quando iniciar :: hat events
[Display how many items are in a list.]
definir [my_list v] para (1) (2) (3)
imprimir (comprimento de [my_list v]) ▶

Item de lista 2D #

O bloco de relatório item de lista 2D reporta o valor de um item numa lista 2D. As listas 2D são variáveis que armazenam múltiplas variáveis lista.

O bloco de relatório de itens de lista 2D.#

(item (1)(1) de [my_2d_list v])

Parâmetro	Descrição
linha	A linha do item (a partir de 1).
coluna	A coluna do item (a partir de 1).
variável	A variável de lista 2D a partir da qual um item será reportado. Os utilizadores podem selecionar uma lista 2D existente, renomeá-la ou eliminá-la.

Exemplo

quando iniciar :: hat events
[Display an item from a 2D list.]
definir [my_2d_list v] para ([1] [7]) ([2] [8])
imprimir (item (2)(2) de [my_2d_list v]) ▶

Substituir item de lista 2D #

O bloco de pilha substituir item de lista 2D atualiza um item específico numa lista 2D.

O bloco de pilha Substituir Item de Lista 2D.#

substituir item (1)(1) de [my_2d_list v] por (1)

Parâmetro	Descrição
linha	O índice da linha do item (com início em 1).
coluna	O índice da coluna do item (a partir de 1).
variável	A variável de lista 2D que contém o item a modificar. Os utilizadores podem selecionar uma lista 2D existente, renomeá-la ou eliminá-la no menu suspenso.
valor	O novo valor atribuído ao item da lista 2D especificado.

Exemplo

quando iniciar :: hat events
[Replace a value in a 2D list and print the updated item.]
definir [my_2d_list v] para ([1] [2]) ([3] [4])
substituir item (2)(2) de [my_2d_list v] por (25)
imprimir (item (2)(2) de [my_2d_list v]) ▶

Conjunto de itens de lista 2D #

O bloco de pilha definir itens da lista 2D define todos os itens da lista 2D com os valores introduzidos.

O bloco de pilha Substituir Item de Lista 2D.#

definir [my_2d_list v] para ([0] [0]) ([0] [0])

Parâmetro	Descrição
variável	A variável da lista 2D está a receber valores. Os utilizadores podem selecionar uma lista 2D existente, renomeá-la ou eliminá-la.
valores	Os valores a armazenar na lista 2D, introduzidos linha a linha.

Exemplo

quando iniciar :: hat events
[Display an item from a 2D list.]
definir [my_2d_list v] para ([1] [4]) ([2] [15])
imprimir (item (1)(2) de [my_2d_list v]) ▶

comprimento da lista 2D #

O bloco de relatório comprimento da lista 2D informa o número de linhas ou colunas de uma lista 2D.

O comprimento do bloco de relatório da lista 2D.#

comprimento de [my_2d_list v] [linhas v]

Parâmetro	Descrição
variável	Lista bidimensional variável cujo comprimento pode ser verificado. Os utilizadores podem selecionar uma lista bidimensional existente, renomeá-la ou eliminá-la.
linhas/colunas	Indica se o número de linhas ou colunas deve ser introduzido.

Exemplo

quando iniciar :: hat events
[Set a 2D list and print the number of rows it has.]
definir [my_2d_list v] para ([1] [5]) ([3] [6])
imprimir (comprimento de [my_2d_list v] [linhas v]) ▶