Partager via


_chdir, _wchdir

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

Équivalent .NET Framework

System::Environment::CurrentDirectory

Voir aussi

Référence

Contrôle de répertoire

_mkdir, _wmkdir

_rmdir, _wrmdir

system, _wsystem