_chdir, _wchdir

Article
03/26/2013

Modifie le répertoire de travail actuel.

Important

Cette API ne peut pas être utilisée dans les applications qui s'exécutent dans les fenêtres d'exécution.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 de répertoire de travail.

Valeur de retour

Ces fonctions retournent la valeur 0 si réussies.Une valeur de retour à 1 indique un échec.Si le chemin d'accès spécifié est introuvable, errnoa la valeur ENOENT.Si dirname est NULL, le gestionnaire de paramètre non valide est appelé, comme décrit dans Validation des paramètres.Si est autorisé à l'exécution pour continuer, errnoa la valeur EINVALet aux la fonction retourne -1.

Notes

Les modifications de fonction d' _chdirque le répertoire de travail actuel au répertoire a spécifiées par dirname.Le paramètre d' dirname doit faire référence à un dossier 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 Un est la lettre de lecteur par défaut et\COFFRE est le répertoire de travail actuel, les modifications suivantes d'appel le répertoire de travail actuel du lecteur C et établit C en tant que nouveau lecteur par défaut :

_chdir("c:\\temp");

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

_wchdirest une version à caractère élargi d' _chdir; l'argument d' dirname à _wchdirest une chaîne à caractères larges. _wchdiret _chdirse comportent de sinon.

Mappage de routines de texte générique :

Routine de Tchar.h	_UNICODE et non définis _MBCS	_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> ou <wchar.h>	<errno.h>

Pour plus d'informations de compatibilité, consultez l' Compatibilité dans l'introduction.

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