_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