Obtenir de l’aide dans R : ?, help(), example() et apropos()

Q: Comment obtenir de l’aide pour une fonction dans R ?

Tapez ? devant son nom — ?mean — ou appelez help(mean) ; les deux ouvrent la même page d’aide avec la description de la fonction, ses arguments, sa valeur de retour et des exemples exécutables. Pour un opérateur ou un mot-clé, mettez le nom entre guillemets : ?`+` ou ?"if".

Q: Comment chercher une fonction R quand je ne connais pas son nom ?

Utilisez ??"keyword" (raccourci pour help.search()) pour chercher un terme dans la documentation de tous les packages installés, par exemple ??"standard deviation". Pour lister les objets déjà chargés dont le nom correspond à un motif, utilisez apropos("cor"). ?? découvre des fonctionnalités ; apropos() retrouve un nom à moitié oublié.

Q: Quelle est la différence entre ? et ?? dans R ?

?name ouvre la page d’aide d’une fonction précise et connue. ??"term" cherche un mot-clé dans le texte de toutes les pages d’aide installées quand vous ne connaissez pas le nom exact de la fonction. Utilisez ? quand vous connaissez le nom, ?? quand vous en cherchez un.

Q: Comment voir quels sont les arguments d’une fonction ?

args(name) affiche uniquement la liste des arguments et leurs valeurs par défaut — args(round) — ce qui est plus rapide que d’ouvrir toute la page d’aide. Pour obtenir les arguments sous forme de liste manipulable par programme, utilisez formals(name).

Q: Comment inspecter un objet R inconnu ?

Exécutez str(object) pour une vue compacte de son type, de sa taille et de son contenu ; class(object) pour voir de quel type d’objet il s’agit ; et summary(object) pour un résumé adapté au type. str() est la première chose à exécuter sur un data frame importé, une liste ou un résultat de modèle.

Répondez vous-même à vos questions R depuis la console — rapidement

Obtenez de l’aide dans R sans quitter la console : ouvrez la page d’aide d’une fonction avec ? et help(), cherchez quand vous ignorez le nom avec ?? et apropos(), listez les arguments d’une fonction avec args(), exécutez ses exemples documentés avec example(), inspectez n’importe quel objet avec str(), et lisez les vignettes des packages — pour répondre vous-même à vos questions, rapidement.

Date de publication

16 juillet 2026

Modifié

17 juillet 2026

Points clés

?name ou help(name) ouvre la page d’aide d’une fonction — les arguments, ce qu’elle retourne, et les exemples en bas.
Vous ne connaissez pas le nom exact ? ??"keyword" cherche dans toute l’aide installée ; apropos("pattern") liste les objets dont le nom correspond.
args(name) affiche uniquement la liste des arguments — le moyen le plus rapide de se rappeler « que prend cette fonction ? »
example(name) exécute les exemples d’une page d’aide pour que vous voyiez la fonction à l’œuvre, sans vous contenter de la lire.
str(object) montre la structure de n’importe quelle valeur — l’outil de référence pour « qu’est-ce que je tiens au juste ? »
Les packages livrent des guides détaillés : vignette() les liste, browseVignettes("pkg") les ouvre.
Réduisez un cas défaillant à un petit exemple reproductible avant de demander en ligne — souvent, vous le résolvez vous-même au passage.

Introduction

Chaque session R tombe sur une fonction inconnue ou un argument dont vous ne vous souvenez plus tout à fait. Pour la plupart, nul besoin de basculer vers un navigateur — R livre sa propre documentation, et une poignée de commandes en console répondent aux questions courantes : que fait cette fonction, quels arguments prend-elle, et qu’est-ce que je tiens dans cet objet ?

Cette leçon couvre les outils d’aide intégrés dans l’ordre où vous les mobilisez réellement : ouvrir une page d’aide quand vous connaissez le nom, chercher quand vous ne le connaissez pas, lister les arguments pour rafraîchir votre mémoire, exécuter les exemples pour voir la fonction à l’œuvre, et inspecter la structure d’un objet quand c’est la donnée — non la fonction — qui fait mystère.

Ouvrir une page d’aide : `?` et `help()`

Quand vous connaissez le nom d’une fonction, ? ouvre sa page d’aide. ?mean et help(mean) sont identiques :

# These open the same help page for mean() (run them to open the viewer)
?mean
help(mean)

Une page d’aide comporte toujours les mêmes sections : une Description d’une ligne, l’Usage (la fonction avec ses arguments et leurs valeurs par défaut), une liste Arguments expliquant chacun d’eux, Value (ce qu’elle retourne) et — souvent la plus utile — les Examples en bas. Lisez d’abord Usage et Arguments ; faites défiler jusqu’aux Examples pour la voir à l’œuvre.

Pour un opérateur ou un mot réservé, entourez le nom de backticks ou de guillemets afin que R n’essaie pas de l’évaluer :

?`+`          # help on the addition operator
?`if`         # help on the if control-flow construct

Chercher quand vous ne connaissez pas le nom : `??` et `apropos()`

Souvent, vous savez ce que vous voulez faire mais pas quelle fonction le fait. ?? (un raccourci pour help.search()) cherche un terme dans les titres et mots-clés de chaque page d’aide installée :

??"standard deviation"    # find functions related to standard deviation

Cela retourne une liste de rubriques d’aide correspondantes parmi vos packages installés — un bon moyen de découvrir que vous cherchiez sd().

Si vous vous souvenez vaguement du nom, apropos() liste tous les objets actuellement disponibles dont le nom correspond à un motif. Idéal pour « il y a une fonction cor-quelque-chose… » :

apropos("cor")            # objects whose name contains "cor"

[1] "cancor"         "cor"            "cor.test"       "cov2cor"       
[5] "Harman23.cor"   "Harman74.cor"   "recordGraphics" "recordPlot"

apropos() cherche dans les noms des objets déjà chargés ; ?? cherche dans le texte de la documentation, y compris des packages que vous n’avez pas attachés. Recourez à apropos() pour retrouver un nom, et à ?? pour découvrir une fonctionnalité.

Lister les arguments d’une fonction : `args()`

Vous n’avez pas toujours besoin de toute la page d’aide — parfois, il vous suffit de vous rappeler les arguments et leur ordre. args() affiche exactement cela :

args(round)           # what does round() take?

function (x, digits = 0, ...) 
NULL

args(paste)           # positional args plus sep and collapse

function (..., sep = " ", collapse = NULL, recycle0 = FALSE) 
NULL

C’est le moyen le plus rapide de répondre à « round() prend-il d’abord les décimales ou d’abord le nombre ? » sans ouvrir toute la documentation. Pour obtenir les noms et valeurs par défaut des arguments sous forme de données manipulables par programme, formals() les retourne dans une liste.

Exécuter les exemples documentés : `example()`

Chaque page d’aide se termine par des exemples exécutables. Au lieu de les recopier à la main, example() les exécute pour vous et affiche les résultats — vous apprenez la fonction en la regardant fonctionner :

example(mean)         # run the examples from ?mean


mean> x <- c(0:10, 50)

mean> xm <- mean(x)

mean> c(xm, mean(x, trim = 0.10))
[1] 8.75 5.50

Voir les exemples s’exécuter — avec une entrée et une sortie réelles — est généralement plus rapide que de décortiquer le texte. Quand une fonction ne se comporte pas comme prévu, exécuter ses propres exemples documentés est un moyen rapide de confirmer à quoi ressemble le « correct ».

Inspecter ce que vous tenez : `str()`

Parfois la fonction est claire mais c’est l’objet qui fait mystère — une liste inconnue, un résultat de modèle, un data frame que vous venez d’importer. str() (structure) affiche un résumé compact, tenant sur un écran, de n’importe quel objet : son type, ses dimensions et un aperçu du contenu :

str(iris)             # a data frame: 150 rows, 5 columns, and each column's type

'data.frame':   150 obs. of  5 variables:
 $ Sepal.Length: num  5.1 4.9 4.7 4.6 5 5.4 4.6 5 4.4 4.9 ...
 $ Sepal.Width : num  3.5 3 3.2 3.1 3.6 3.9 3.4 3.4 2.9 3.1 ...
 $ Petal.Length: num  1.4 1.4 1.3 1.5 1.4 1.7 1.4 1.5 1.4 1.5 ...
 $ Petal.Width : num  0.2 0.2 0.2 0.2 0.2 0.4 0.3 0.2 0.2 0.1 ...
 $ Species     : Factor w/ 3 levels "setosa","versicolor",..: 1 1 1 1 1 1 1 1 1 1 ...

Pour un modèle ajusté ou une liste imbriquée, str() est la première chose à exécuter — il vous montre les morceaux que vous pouvez extraire avec $. Associez-le à class() (quel type d’objet est-ce ?) et à summary() (un résumé adapté au type), et vous pouvez vous orienter dans n’importe quelle valeur inconnue.

class(iris)           # what kind of object?

[1] "data.frame"

summary(iris$Sepal.Length)   # a numeric summary of one column

   Min. 1st Qu.  Median    Mean 3rd Qu.    Max. 
  4.300   5.100   5.800   5.843   6.400   7.900

Lire les guides détaillés : les vignettes

Les pages d’aide documentent une fonction ; les vignettes sont des tutoriels plus longs et détaillés qu’un auteur de package écrit pour montrer comment les pièces s’assemblent. Listez celles disponibles et ouvrez un guide précis avec :

vignette()                    # all vignettes from installed packages
browseVignettes("stats")      # vignettes for a specific package
vignette("some-topic")        # open one by name

Quand un package ressemble à un tas de fonctions sans lien, c’est généralement dans sa vignette que le flux de travail prévu est explicité. (Celles-ci ouvrent un navigateur ou une visionneuse, elles sont donc montrées ici plutôt qu’exécutées.)

De l’aide au-delà de la console : les exemples reproductibles

Quand la documentation intégrée ne tranche pas et qu’il vous faut demander en ligne (Stack Overflow, la communauté Posit, les issues GitHub d’un package), le moyen le plus rapide d’obtenir une bonne réponse est un exemple reproductible — un extrait minimal que quelqu’un peut copier, exécuter et sur lequel voir votre problème. Réduisez votre code aux quelques lignes qui montrent encore le souci, utilisez un jeu de données intégré (comme iris ou mtcars) ou un petit vecteur inventé plutôt que vos données privées, et incluez le message d’erreur. Réduire le problème à ce point révèle souvent la solution avant même que vous ne postiez.

Essayez en direct

Les blocs ci-dessus se sont exécutés au moment de la génération. Modifiez celui-ci et appuyez sur Run pour explorer vous-même les outils d’aide de R — il s’exécute dans votre navigateur via webR (aucune installation).

🟢 Avec un agent IA

Bloqué sur une fonction inconnue ou un objet obscur ? Collez-le et demandez à Prova « que retourne ceci et comment l’utiliser ? » — elle explique les arguments et montre un appel concret. Ensuite, parce que le runtime est juste ici, exécutez vous-même args(), example() et str() dessus et confirmez que la réponse correspond à ce que R fait réellement — la documentation n’a raison que si le code est d’accord. Demander à Prova →

Vous travaillez en Python ? help(obj) et ?obj dans IPython/Jupyter, dir(obj) pour lister les noms, et la documentation d’une bibliothèque couvrent le même terrain — un guide d’aide Python arrive dans la série Python.

Problèmes fréquents

?somefun affiche « No documentation found ». Le package de la fonction n’est pas installé ou n’est pas chargé. S’il est installé mais non attaché, utilisez la forme pleinement qualifiée ?package::somefun ou library(package) d’abord. S’il n’est pas installé du tout, ??"some words" ne cherchera toujours rien en local — installez le package, et la page d’aide apparaît.

? ne fonctionne pas sur un opérateur ou un mot-clé. ?+ ou ?if provoque une erreur parce que R tente d’analyser le symbole. Mettez-le entre guillemets ou backticks : ?`+`, ?`if`, ?"[". Il en va de même pour ?function`` et d’autres mots réservés.

?? ne retourne rien d’utile. ?? ne cherche que dans l’aide des packages installés, donc une fonction d’un package que vous n’avez pas installé n’apparaîtra pas. Élargissez le terme (cherchez "standard deviation", pas "stdev"), ou cherchez la fonctionnalité sur le web, puis installez le package indiqué par la documentation et cherchez à nouveau.

Questions fréquentes

Comment obtenir de l’aide pour une fonction dans R ?

Tapez ? devant son nom — ?mean — ou appelez help(mean) ; les deux ouvrent la même page d’aide avec la description de la fonction, ses arguments, sa valeur de retour et des exemples exécutables. Pour un opérateur ou un mot-clé, mettez le nom entre guillemets : ?`+` ou ?"if".

Comment chercher une fonction R quand je ne connais pas son nom ?

Utilisez ??"keyword" (raccourci pour help.search()) pour chercher un terme dans la documentation de tous les packages installés, par exemple ??"standard deviation". Pour lister les objets déjà chargés dont le nom correspond à un motif, utilisez apropos("cor"). ?? découvre des fonctionnalités ; apropos() retrouve un nom à moitié oublié.

Quelle est la différence entre ? et ?? dans R ?

?name ouvre la page d’aide d’une fonction précise et connue. ??"term" cherche un mot-clé dans le texte de toutes les pages d’aide installées quand vous ne connaissez pas le nom exact de la fonction. Utilisez ? quand vous connaissez le nom, ?? quand vous en cherchez un.

Comment voir quels sont les arguments d’une fonction ?

args(name) affiche uniquement la liste des arguments et leurs valeurs par défaut — args(round) — ce qui est plus rapide que d’ouvrir toute la page d’aide. Pour obtenir les arguments sous forme de liste manipulable par programme, utilisez formals(name).

Comment inspecter un objet R inconnu ?

Exécutez str(object) pour une vue compacte de son type, de sa taille et de son contenu ; class(object) pour voir de quel type d’objet il s’agit ; et summary(object) pour un résumé adapté au type. str() est la première chose à exécuter sur un data frame importé, une liste ou un résultat de modèle.

Testez vos connaissances

Exercice : trouver et inspecter une fonction que vous ne connaissez pas

Vous voulez les quantiles empiriques d’un vecteur numérique mais vous ne vous rappelez plus la fonction. Cherchez-la d’abord, puis ouvrez son aide, listez ses arguments, et exécutez-la sur la colonne mtcars$mpg.

apropos("quant")           # -> "quantile"
args(quantile)             # function (x, ...) — quantile is generic; the full
                           # argument list lives on the method, args(quantile.default)
quantile(mtcars$mpg)       # 0% 25% 50% 75% 100%

Vérification rapide : quel outil pour quelle question ?

Vous venez d’importer un data frame nommé df et vous voulez savoir combien de colonnes il possède et de quel type est chacune. Quelle est la meilleure première commande ?

A. ?df B. ??"data frame" C. str(df)

Afficher la réponse

C. str(df) affiche la structure — le nombre de colonnes, le nom et le type de chaque colonne, et un aperçu des valeurs. ?df cherche une page d’aide nommée df (il n’y en a pas pour votre objet), et ??"data frame" cherche dans le texte de la documentation, pas dans vos données.

Conclusion

R répond à la plupart de vos questions sans quitter la console : ? et help() ouvrent la page d’une fonction connue, ?? et apropos() en trouvent une que vous ne savez pas nommer, args() rappelle les arguments, example() exécute la documentation pour vous, et str()/class()/summary() révèlent ce qu’est réellement un objet. Recourez-y avant le navigateur — et quand vous demandez en ligne, un petit exemple reproductible vous vaut une réponse rapide (et vous fait souvent trouver la solution par vous-même). Apprendre à lire l’aide est la compétence qui rend toute autre fonction R apprenable.

Leçons connexes

Installer des packages en R — récupérez d’abord le package, puis ses pages d’aide et ses vignettes apparaissent. · Les jeux de données intégrés à R — les données iris/mtcars que vous utilisez pour tester une fonction inconnue. · Écrire des fonctions — documentez vos propres fonctions pour qu’elles se lisent comme les pages d’aide ici. · Vecteurs et types — ce sur quoi str() et class() renseignent.
Pour aller plus loin : Fondamentaux de R — la série complète. · Science computationnelle et IA — le pilier.

Cette page vous a-t-elle été utile ?

Prouvez que vous savez le faire. Maîtrisez toute la série Les bases de R — suivez votre parcours, construisez des projets et obtenez un certificat.

Commencer gratuitement →

Passez à Pro — Prova illimité sur vos propres données et un certificat vérifiable qui atteste la compétence.

dès 15 $/mois facturé annuellement

Passer à Pro →

✓ Vous êtes Pro — continuez. The runtime is the judge.

Note

Cette leçon est reproductible : chaque résultat de cette page a été produit par le code affiché — modifiez n’importe quel bloc et appuyez sur Run pour le reproduire dans votre navigateur. The runtime is the judge.

Réutilisation

CC BY-NC-SA 4.0

Citation

BibTeX

@online{2026,
  author = {},
  title = {Obtenir de l’aide dans R :\,?, help(), example() et
    apropos()},
  date = {2026-07-16},
  url = {https://www.datanovia.com/learn/programming/r-foundations/getting-help-in-r},
  langid = {fr}
}

Veuillez citer ce travail comme suit :

“Obtenir de l’aide dans R : ?, help(), example() et apropos().” 2026. July 16. https://www.datanovia.com/learn/programming/r-foundations/getting-help-in-r.