Begin'R

Navigation

# Utilisation de fonctions

:Objectifs
        
        * Utiliser des fonctions avec R.  
        
  
        
    Certaines des instructions précédentes sont en réalité 
    des appels à des fonctions. Certaines fonctions sont 
    relativement intuitives. D'autres le sont moins et nécessitent 
    de connaître l'ordre et le nom des arguments.
    
    Par exemple, l'instruction `exp(-4)` réalise l'appel de la 
    fonction **`exp()`** avec pour argument le nombre `-4`.
    
    On reconnait l'appel d'une fonction à l'utilisation des 
    parenthèses. Un ou plusieurs arguments peuvent être fournis. 
    Dans le cas de la fonction `exp()`, seul un argument est 
    attendu. D'autres fonctions comme la fonction **`log()`** peuvent 
    nécessiter plusieurs arguments. Si l'on ne connait pas les arguments d'une fonction, il est toujours possible de se 
    référer à l'aide en ligne de R.
    
    :Exemple de la fonction log {#exemple_log, title-display=show}
        
        L'[aide en ligne](caps_1_5_aide.html) 
        de la fonction `log()` montre que l'on peut indiquer deux 
        arguments. Le premier nommé `x` désigne le nombre dont on 
        désire calculer le logarithme. Le second nommé `base` fait 
        référence à la base dans laquelle est calculée ce 
        logarithme. Dans l'exemple ci-dessous, la première 
        instruction permet de calculer le logarithme népérien de 2, 
        tandis que la deuxième le calcule en base 10.
        
        
        ```r
            log(x=2)
            log(x=2, base=10)
        ```
        
        L'ordre des arguments n'est pas important dans la 
        mesure où l'on indique leur nom. Dans le cas où celui-ci 
        n'est pas indiqué, l'ordre des arguments doit être celui fourni 
        dans l'aide de R. Les trois instructions suivantes sont 
        donc strictement équivalentes :
        
        
        ```r
            log(x=2, base=10)
            log(base=10, x=2)
            log(2,10)
        ```
        
        De plus, si un argument n'est pas renseigné, il est laissé
        à sa valeur par défaut (s'il en possède une, voir pour cela
        dans l'aide). Ainsi les deux instructions suivantes sont
        également strictement équivalentes :
        
        
        ```r
            log(x=2)
            log(x=2, base=exp(1))
        ```
        
    :Remarque : la complétion automatique {#remarque_completion}
    
        Une autre fonctionnalité intéressante de RStudio est la 
        complétion automatique. 
        
        Supposons que l'on saisisse la première partie de 
        l'instruction "`log(x=2,`". L'appui sur la touche **tabulation $\rightarrow|$** 
        du clavier fait alors apparaître une fenêtre d'aide 
        contextuelle fournissant la liste des arguments possibles 
        et leurs valeurs par défaut. Il est possible de naviguer dans 
        cette fenêtre d'un argument à l'autre à l'aide des flèches 
        (haut et bas) du clavier.

![image](image/fonction_log.PNG)

:Suite de la prise en main de R {#priseenmain, toggle=collapse, title-display=hidden}
    
        [Téléchargement et installation du logiciel R et de RStudio](caps_1_1_installation.html)
            
        [Premiers pas avec RStudio](caps_1_2_premiers_pas.html)
            
        [Les variables](caps_1_3_variables.html)
        
        [Utilisation de fonctions](caps_1_4_fonctions.html)
        
        [Rubrique d'aide](caps_1_5_aide.html)

[Installation de packages](caps_1_6_packages.html)

[Gestion des scripts](caps_1_7_scripts.html)
          
        [Editer des rapports](caps_1_8_rapports.html)
        
        [Editer des rapports Rmarkdown](caps_1_9bis_rapports_rmd.html)