Consola

Introdução

A consola do VEXcode IQ (2ª geração) é apresentada na janela Monitor do VEXcode. Os métodos de consola podem apresentar texto, números e valores de variáveis ​​enquanto um projeto está a ser executado. Podem também limpar a consola, ler a entrada do utilizador e definir a cor do texto impresso após a alteração da cor.

Ao utilizar o VS Code, a saída da Consola baseada em texto aparece no terminal em vez da Consola VEXcode.

Nota: Ao utilizar o Consola VEXcode, deve ligar-se à Porta Série da Consola antes que qualquer saída possa ser impressa no Consola.

Segue-se uma lista de todos os métodos:

Ações — Visualizar texto ou limpar a Consola.

• print — Apresenta o texto, os números ou os valores das variáveis ​​na consola ou no terminal.

• clear_console — Limpa todas as linhas da Consola.

Getter — Lê a entrada do utilizador.

• input — Apresenta uma string de prompt opcional, aguarda a entrada do utilizador e devolve a resposta como texto.

Mutator — Formata o texto impresso.

• set_console_text_color — Define a cor utilizada para o texto impresso na Consola.

Ações

print

print apresenta texto, números ou valores de variáveis ​​na Consola. No VS Code, print apresenta a saída no terminal.

Utilize a formatação de cadeias personalizada quando pretender que uma mensagem impressa inclua valores do seu projeto, como uma pontuação, um temporizador ou uma leitura de sensor. Consulte a página Formatação de cadeias para obter mais informações.

Por defeito, cada instrução print() termina com \n, que representa uma nova linha. Isto move o cursor para a linha seguinte após o valor ser impresso. O parâmetro opcional end altera o que é adicionado após o valor impresso.

Usage:
print(value, end=“\n”)

Parâmetro	Descrição
value	O texto, número ou valor de variável a ser apresentado na consola ou terminal.
end	Opcional. O texto adicionado após o valor value é impresso. O predefinido é “\n”, que move o cursor para a linha seguinte. Utilize end=“” para manter o próximo valor impresso imediatamente a seguir ao valor anterior na mesma linha. Utilize outra string, como por exemplo end=”, “, para adicionar texto entre os valores impressos.

# Display two messages on separate lines
print("Hello, robot!")
print("This prints on the next line.")

# Display two messages on the same line
print("Hello,", end=" ")
print("robot!")

# Print three colors on one line, separated by commas
colors = ["Red", "Green", "Blue"]

for color in colors:
    print(color, end=", ")

Sequências de Escape

As sequências de escape são códigos curtos que podem ser impressos com print para alterar a forma como o texto aparece na consola.

A maioria dos projetos deve utilizar set_console_text_color para alterar a cor do texto e clear_console para limpar a consola. As sequências de escape são úteis quando se pretende fazer estas coisas directamente dentro de uma instrução print.

Para alterar a cor do texto, imprima \033 seguido de um código de cor.

Cor	Sequência de escape
Vermelho	\033[31m
Verde	\033[32m
Azul	\033[34m
Preto	\033[30m
Branco	\033[37m
Amarelo	\033[33m
Laranja	\033[91m
Roxo	\033[35m
Ciano	\033[36m
Transparente	\033[97m

# Print VEXcode in red
print("\033[31mVEXcode")

# Set the Console text color to red before printing
print("\033[31m")
print("VEXcode")

Para limpar todo o Consola com uma sequência de escape, imprima \033[2J. Isto também move o cursor de volta para a linha 1.

# Clear the Console after two seconds
print("VEXcode")
wait(2, SECONDS)
print("\033[2J")

clear_console

clear_console limpa todas as linhas da Consola.

Usage:
clear_console()

Parâmetros	Descrição
	Este método não tem parâmetros.

# Display text, then clear it after two seconds
print("This will disappear...")
wait(2, SECONDS)
clear_console()

Getter

input

input apresenta uma string de pedido opcional, aguarda que o utilizador introduza uma resposta e, em seguida, devolve essa resposta como texto.

O projeto faz uma pausa em input() até que uma resposta seja introduzida na Consola. No VS Code, a resposta é introduzida no terminal.

O valor devolvido por input() é sempre texto. Para utilizar a resposta como número, converta-a primeiro com int() ou float().

Usage:
input(prompt)

Parâmetro	Descrição
prompt	Opcional. Uma string para apresentar na consola ou terminal antes de aguardar uma resposta. Se não for incluída nenhuma mensagem, não será apresentada nenhuma mensagem antes de aguardar.

# Ask for a name, then print a greeting
answer = input("What's your name?")
print("Hello, " + answer)

# Ask for a number, then use it in math
answer = input("Enter a number:")
number = float(answer)
print(number + 1)

Mutador

set_console_text_color

set_console_text_color define a cor utilizada para o texto impresso na Consola após este método ser utilizado. No início de um projeto, a cor do texto da Consola é definida como BLUE.

Este método altera a cor do texto na Consola VEXcode. No VS Code, o suporte de cores no terminal pode variar de acordo com o terminal.

Usage:
set_console_text_color(color)

Parâmetro	Descrição
color	Cor a utilizar para o texto impresso na Consola: Color.BLACK Color.BLUE Color.CYAN Color.GREEN Color.ORANGE Color.PURPLE Color.RED Color.WHITE Color.YELLOW

# Print text in different colors
print("Default text color")
set_console_text_color(Color.RED)
print("Red text color")