Fonction chdir - Entête <unistd.h>

#include <unistd.h>

Fonction chdir

int chdir( const char * path );

Cette fonction permet de changer le répertoire courant de travail. Le chemin vers le nouveau dossier doit être passé en paramètre. Le nouveau chemin peut être exprimé en absolu (à partir de la racine de votre système de fichier) ou relativement au répertoire courant.

Paramètre

• path : ce paramètre permet d'indiquer le nouveau répertoire de travail.

Valeur de retour

Si tout se passe bien, la fonction renvoie la valeur 0. Dans le cas contraire, la valeur -1 vous sera retournée et la variable errno sera fixée avec le code erreur constaté.

Codes erreurs pouvant être retournés

• EACCES : vous n'avez pas les droits nécessaires pour accéder au dossier.
• EFAULT : le pointeur path spécifié en paramètre pointe en dehors de l'espace d'adressage autorisé.
• EINTR : un signal a interrompu l'execution de la fonction.
• EIO : une erreur d'entrée/sortie s'est produite.
• ELOOP : le chemin spécifié contient une référence circulaire, certainement au travers d'un lien symbolique.
• ENAMETOOLONG : le chemin spécifié dépasse PATH_MAX caractères, ou l'un de ses éléments constitutifs dépasse NAME_MAX.
• ENOENT : le chemin spécifié n'existe pas.
• ENOMEM : il n'y a plus assez de mémoire pour le noyau.
• ENOTDIR : un des éléments du chemin spécifié n'est pas un dossier.

Exemple de code

L'exemple de code suivant permet de créer un dossier test dans le répertoire courant et de s'y placer avant de créer un nouveau fichier.

 1 
 2 
 3 
 4 
 5 
 6 
 7 
 8 
 9 
 10 
 11 
 12 
 13 
 14 
 15 
 16 
 17 
 18 
 19 
 20 
 21 
 22 
 23 
 24 
 25 
 26 
 27 
 28 
 29 
 30 
 31 

#include <stdio.h>
#include <stdlib.h>

#include <unistd.h>        // chdir
#include <sys/stat.h>      // mkdir

#define PATH "test"

int main() {

    if ( mkdir( PATH, 0755 ) != 0 ) {
        fprintf( stderr, "Impossible de créer le dossier %s.\n", PATH );
        exit( EXIT_FAILURE );
    }
    
    if ( chdir( PATH ) != 0 ) {
        fprintf( stderr, "Impossible de se placer dans le dossier %s.\n", PATH );
        exit( EXIT_FAILURE );
    }
    
    FILE * file = fopen( "essai.txt", "w" );
    if ( file == NULL ) {
        fprintf( stderr, "Impossible d'ouvrir le fichier en écriture.\n" );
        exit( EXIT_FAILURE );
    }

    fprintf( file, "Ok" );
    fclose(file);
    
    return EXIT_SUCCESS;
}

Conformité

POSIX 88 (IEEE Std 1003.1-1988) et versions ultérieures.

Sujets connexes