_chdir, _wchdir

Article
06/09/2015

Modifie le répertoire de travail en cours.

Important

Cette API ne peut pas être utilisée dans les applications qui s'exécutent dans le Windows Runtime.Pour plus d'informations, consultez Fonctions CRT non prises en charge avec /ZW.

int _chdir( 
   const char *dirname 
);
int _wchdir( 
   const wchar_t *dirname 
);

Paramètres

dirname
Chemin d'accès du nouveau répertoire de travail.

Valeur de retour

Ces fonctions retournent la valeur 0 si réussies. Une valeur de retour de – 1 indique un échec. Si le chemin d'accès spécifié est introuvable, errno a la valeur ENOENT. Si dirname a la valeur NULL, le gestionnaire de paramètres non valides est appelé, comme décrit dans Validation de paramètre. Si l'exécution est autorisée à poursuivre, errno est définie à EINVAL et la fonction renvoie -1.

Notes

La fonction _chdir remplace le répertoire de travail actuel par le répertoire spécifié par dirname. Le paramètre dirname doit faire référence à un répertoire existant. Cette fonction peut modifier le répertoire de travail actuel sur tout lecteur. Si une nouvelle lettre de lecteur est spécifiée dans dirname, la lettre de lecteur par défaut est également modifiée. Par exemple, si A est la lettre de lecteur par défaut et \BIN est le répertoire de travail actuel, cet appel modifie le répertoire de travail actuel du lecteur C et établit C comme nouveau lecteur par défaut :

_chdir("c:\\temp");

Lorsque vous utilisez la barre oblique inverse facultative (\) dans les tracés, vous devez placer deux barres obliques inverses (\\) dans le littéral de chaîne C pour représenter une barre oblique inverse unique (\).

_wchdir est une version à caractère élargi de _chdir; l'argument dirname de _wchdir est une chaîne à caractères larges. _wchdir et _chdir se comportent de la même façon par ailleurs.

Mappage de routines de texte générique

Routine Tchar.h	_UNICODE et _MBCS non définis	_MBCS défini	_UNICODE défini
_tchdir	_chdir	_chdir	_wchdir

Configuration requise

Routine	En-tête requis	En-tête facultatif
_chdir	<direct.h>	<errno.h>
_wchdir	<direct.h> or <wchar.h>	<errno.h>

Pour plus d'informations sur la compatibilité, consultez Compatibilité.

Exemple

// crt_chdir.c
// arguments: C:\WINDOWS

/* This program uses the _chdir function to verify
   that a given directory exists. */

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

int main( int argc, char *argv[] )
{

   if(_chdir( argv[1] ) )
   {
      switch (errno)
      {
      case ENOENT:
         printf( "Unable to locate the directory: %s\n", argv[1] );
         break;
      case EINVAL:
         printf( "Invalid buffer.\n");
         break;
      default:
         printf( "Unknown error.\n");
      }
   }
   else
      system( "dir *.exe");
}