HOWTO · R

Comment vérifier la version de R

Apprenez à vérifier la version de R dans la console R, depuis un terminal et dans un script R, et comprenez quelle session ou quel exécutable chaque méthode rapporte.

Sur cette page

Utilisez R.version.string dans R pour une étiquette de version concise, ou exécutez R --version dans un terminal pour inspecter l’exécutable trouvé dans le PATH de ce terminal. L’expression de la console décrit la session R que vous avez ouverte ; la commande du terminal peut désigner une installation différente de celle sélectionnée par un IDE.

Vérifier la version de R dans la console R

À l’invite R, évaluez R.version.string pour afficher une courte étiquette qui inclut le numéro de version et d’éventuels détails de build. C’est généralement le moyen le plus rapide d’identifier la version utilisée par la console actuelle ou la session RStudio. L’expression lit une valeur ; elle n’appelle pas de fonction.

cat(R.version.string, "\n")

Sortie :

R version 4.2.2 Patched (2022-11-10 r83330)

Pour des détails structurés, inspectez R.version. C’est un objet intégré, et non une fonction, et ses champs décrivent le build de R, y compris les composants majeur et mineur, la plateforme et la chaîne de version. Utilisez $ pour lire un champ particulier, tel que R.version$major, ou affichez l’objet entier lorsque vous diagnostiquez des différences entre builds. Les champs et valeurs exacts dépendent de l’installation de R, comparez donc la chaîne de version et les composants pertinents plutôt que de vous fier à un exemple lié à une autre machine.

sessionInfo() répond à une question de dépannage plus large. Elle rapporte la version de R ainsi que le système d’exploitation, les paramètres régionaux et les informations sur les paquets attachés ou chargés. Utilisez-la lorsqu’un problème peut dépendre des paquets ou de la configuration de la session ; utilisez R.version.string lorsque vous n’avez besoin que de l’étiquette de version.

Vérifier la version de R depuis la ligne de commande

Dans un terminal, exécutez R --version. Cela demande à l’exécutable R résolu depuis le PATH actuel d’afficher ses informations de version. La commande est utile sur un serveur ou dans un shell où vous n’ouvrez pas la console graphique. Son résultat identifie cet exécutable, pas nécessairement toutes les installations de R sur l’ordinateur.

Si la version affichée dans le terminal diffère de R.version.string dans RStudio ou un autre IDE, les deux environnements utilisent des exécutables R différents. Vérifiez quel exécutable le terminal résout et quelle installation l’IDE est configuré pour utiliser. Une vérification de version peut aider à diagnostiquer la compatibilité des paquets, mais elle n’établit pas à elle seule quelle version de R un projet requiert ; consultez les instructions d’installation et les exigences de paquets du projet avant de changer d’installation.

Vérifier la version de R dans un script R

Un script R peut afficher la version qui l’exécute et comparer les composants de la version à un minimum. getRversion() renvoie une valeur de version conçue pour les comparaisons, ce qui évite de traiter les étiquettes de version comme du texte ordinaire. Par exemple, un tri textuel peut mal ordonner des versions telles que 4.10 et 4.9 ; utilisez plutôt une comparaison tenant compte des versions.

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 = "")
}

Sortie :

R version 4.2.2 Patched (2022-11-10 r83330)
The required R version is available.

La version requise est une valeur d’exemple ; remplacez-la par le minimum pris en charge par votre code ou votre projet. Le script affiche la version R active et indique si ce R satisfait l’exigence, en laissant la décision d’installer ou de sélectionner R à la configuration de l’environnement du projet. Pour un rapport de bogue reproductible, incluez sessionInfo() en plus de l’étiquette de version, car les versions des paquets et les détails de la plateforme peuvent affecter le comportement.