HOWTO · R

Limpar a Consola em R

Este artigo introduz como limpar a consola R interactivamente.

Nesta página

Ao trabalhar com R, manter a sua consola limpa e organizada é essencial para uma análise de dados e programação eficientes. Uma consola desordenada pode dificultar o acompanhamento das saídas, a depuração de erros ou até mesmo a execução eficaz de novos comandos. Felizmente, limpar a consola R é um processo simples. Neste artigo, exploraremos diferentes métodos para limpar a consola R de forma interativa, garantindo que possa manter um espaço de trabalho arrumado.

Uma distinção atravessa todos os métodos abaixo: limpar a consola remove a saída exibida. Não elimina as variáveis, funções ou outro estado na sua sessão R — exceto o último método, um pacote de terceiros que alcança a área de trabalho, razão pela qual vem com uma cautela explícita.

Limpar a consola no RStudio com um atalho de teclado

No RStudio, a forma mais rápida de limpar a consola é o atalho de teclado: prima Ctrl + L no Windows, ou Command + Option + L no macOS, e a exibição da consola é limpa instantaneamente.

Os atalhos dependem do ambiente, por isso trate isto como a resposta do RStudio e não como uma universal: uma consola R diferente, uma plataforma diferente ou uma atribuição de teclas personalizada pode usar outro atalho ou nenhum. Se o atalho não fizer nada na sua consola, utilize em vez disso um dos métodos baseados em comandos abaixo.

Experimente cat("\014") apenas em consolas que suportem o avanço de página

O comando clássico do R para limpar a consola envia um caractere de avanço de página:

cat("\014")

Nas consolas que interpretam o avanço de página como uma instrução de limpeza — entre elas a consola do RStudio — a saída exibida desaparece. Nem todas as consolas o respeitam: em algumas implementações, como uma consola de sistema simples, o mesmo comando pode apenas mover o cursor ou imprimir um símbolo, e a saída permanece. O R não tem uma função incorporada que limpe nativamente todas as consolas, e é por isso que os restantes métodos existem.

Deslocar a saída anterior para fora da vista com linhas em branco

Uma abordagem diferente não limpa nada de todo: ela empurra a saída anterior para cima e para fora da vista imprimindo muitas linhas em branco — 50 geralmente é suficiente. Envolto numa pequena função, torna-se um comando reutilizável:

clear_con <- function() cat(rep("\n", 50))
clear_con()

Chame clear_con() sempre que quiser uma consola com aspeto limpo. Tenha clareza sobre o que ela faz: a saída anterior é deslocada para fora da vista, não apagada — desloque para trás e ela ainda está lá, e nada na sessão muda. Essa é também a sua vantagem: funciona em praticamente qualquer consola, porque depende apenas de imprimir quebras de linha.

Use um comando do sistema operativo apenas quando a consola R o suportar

Algumas consolas R permitem-lhe limpar a exibição enviando ao sistema operativo um comando que limpa o seu ecrã. No Windows, esse comando é:

shell("cls")

No Linux ou macOS, é:

shell("clear")

Se isto funciona depende inteiramente da implementação da consola e do ambiente em que é executada — várias consolas R e configurações de IDE não transmitem o comando de uma forma que limpe a exibição da consola R, por isso trate-o como uma opção que funciona em algumas configurações, não como uma garantia.

Use o pacote mise com cautela

Existe um pacote de terceiros chamado mise associado a esta tarefa. Ao contrário dos métodos acima, ele não se limita à exibição da consola: o pacote também atua sobre os objetos da área de trabalho, pelo que os objetos que criou — variáveis e, dependendo de como é usado, funções — podem ser removidos. Esse é um efeito materialmente mais forte do que limpar a saída, e é o motivo da cautela: leia a documentação da versão que instalar antes de o chamar, e não o execute numa sessão cujos objetos ainda lhe sejam necessários.

A instalação e o carregamento são dois comandos separados:

install.packages("mise")
library(mise)
mise()

Antes de o usar em trabalho real, experimente-o numa sessão descartável e confirme exatamente o que a versão instalada remove por predefinição e que argumentos aceita; não assuma nomes de argumentos ou valores predefinidos de exemplos escritos para outra versão.

Qualquer que seja o método que escolha, lembre-se da distinção do início deste artigo: o atalho, o avanço de página, as linhas em branco e o comando de shell afetam apenas o que a consola mostra. Apenas o método do pacote toca a própria sessão — e nenhum destes métodos reinicia uma sessão R.