HOWTO · R
Como verificar a versão de R
Aprenda a verificar a versão do R no console do R, a partir de um terminal e dentro de um script R, e entenda qual sessão ou executável cada método relata.
Nesta página
Use R.version.string dentro do R para um rótulo de versão conciso, ou execute R --version em um terminal para inspecionar o executável encontrado no PATH desse terminal. A expressão do console descreve a sessão do R que você abriu; o comando do terminal pode se referir a uma instalação diferente da selecionada por um IDE.
Verificar a versão do R no console do R
No prompt do R, avalie R.version.string para imprimir um rótulo curto que inclui o número da versão e quaisquer detalhes de build. Geralmente, essa é a maneira mais rápida de identificar a versão usada pelo console atual ou pela sessão do RStudio. A expressão lê um valor; ela não chama uma função.
cat(R.version.string, "\n")
Saída:
R version 4.2.2 Patched (2022-11-10 r83330)
Para detalhes estruturados, inspecione R.version. Ele é um objeto integrado, não uma função, e seus campos descrevem o build do R, incluindo os componentes major e minor, a plataforma e a cadeia de versão. Use $ para ler um campo específico, como R.version$major, ou exiba o objeto inteiro ao diagnosticar diferenças entre builds. Os campos e valores exatos dependem da instalação do R, portanto compare a cadeia de versão e os componentes relevantes em vez de confiar em um exemplo vinculado a outra máquina.
sessionInfo() responde a uma pergunta de solução de problemas mais ampla. Ela relata a versão do R junto com o sistema operacional, a localidade e as informações dos pacotes anexados ou carregados. Use-a quando um problema pode depender de pacotes ou da configuração da sessão; use R.version.string quando você só precisa do rótulo da versão.
Verificar a versão do R a partir da linha de comando
Em um terminal, execute R --version. Isso pede ao executável R resolvido a partir do PATH atual que imprima suas informações de versão. O comando é útil em um servidor ou em um shell em que você não está abrindo o console gráfico. Seu resultado identifica esse executável, não necessariamente todas as instalações do R no computador.
Se a versão impressa no terminal diferir de R.version.string no RStudio ou em outro IDE, os dois ambientes estão usando executáveis do R diferentes. Verifique qual executável o terminal resolve e qual instalação o IDE está configurado para usar. Uma verificação de versão pode ajudar a diagnosticar a compatibilidade de pacotes, mas por si só não estabelece qual versão do R um projeto requer; consulte as instruções de configuração e os requisitos de pacotes do projeto antes de mudar de instalação.
Verificar a versão do R em um script R
Um script R pode imprimir a versão que o está executando e comparar os componentes da versão com um mínimo. getRversion() retorna um valor de versão projetado para comparações, de modo que evita tratar os rótulos de versão como texto comum. Por exemplo, a ordenação de texto pode desordenar versões como 4.10 e 4.9; use, em vez disso, uma comparação consciente de versões.
cat(R.version.string, "\n")
required_version <- "4.0.0"
current_version <- getRversion()
if (current_version >= required_version) {
cat("The required R version is available.\n")
} else {
cat("This script expects R ", required_version, " or later.\n", sep = "")
}
Saída:
R version 4.2.2 Patched (2022-11-10 r83330)
The required R version is available.
A versão necessária é um valor de exemplo; substitua-a pelo mínimo suportado pelo seu código ou projeto. O script imprime a versão ativa do R e relata se esse R atende ao requisito, deixando a decisão sobre como instalar ou selecionar o R para a configuração do ambiente do projeto. Para um relatório de bug reproduzível, inclua sessionInfo() além do rótulo da versão, já que as versões dos pacotes e os detalhes da plataforma podem afetar o comportamento.