Partager via


_mkdir, _wmkdir

Crée un nouveau répertoire.

int _mkdir(
   const char *dirname 
);
int _wmkdir(
   const wchar_t *dirname 
);

Paramètres

  • dirname
    Chemin d'accès d'un répertoire.

Valeur de retour

Chacune de ces fonctions retourne la valeur 0 si le nouveau répertoire a été créé.Sur une erreur, la fonction retourne la valeur - 1 et définit errno comme suit.

  • EEXIST
    Le répertoire n'a pas été créé car dirname est le nom d'un fichier existant, d'un répertoire, ou d'un périphérique.

  • ENOENT
    Le chemin d'accès est introuvable.

Pour plus d'informations sur ces éléments et d'autres codes de retour, consultez _doserrno, errno, _sys_errlist, et _sys_nerr.

Notes

la fonction d' _mkdir crée un nouveau répertoire avec le dirnamespécifié . _mkdir peut créer uniquement un nouveau répertoire par appel par conséquent, seul le dernier composant d' dirname peut nommer un nouveau répertoire._mkdir ne convertit pas les séparateurs de chemin d'accès.Sous Windows NT, la barre oblique inverse (\) et la barre oblique (/) sont des séparateurs valides de chemin d'accès dans les chaînes de caractères dans des routines de service.

_wmkdir est une version à caractère élargi d' _mkdir; l'argument d' dirname à _wmkdir est une chaîne à caractères larges._wmkdir et _mkdir se comportent de sinon.

mappages de routines de texte générique

routine de Tchar.h

_UNICODE et _MBCS non définis

_MBCS défini

_UNICODE défini

_tmkdir

_mkdir

_mkdir

_wmkdir

Configuration requise

routine

en-tête requis

_mkdir

<direct.h>

_wmkdir

<direct.h> ou <wchar.h>

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

bibliothèques

toutes les versions de Bibliothèques runtime C.

Exemple

// crt_makedir.c

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

int main( void )
{
   if( _mkdir( "\\testtmp" ) == 0 )
   {
      printf( "Directory '\\testtmp' was successfully created\n" );
      system( "dir \\testtmp" );
      if( _rmdir( "\\testtmp" ) == 0 )
        printf( "Directory '\\testtmp' was successfully removed\n"  );
      else
         printf( "Problem removing directory '\\testtmp'\n" );
   }
   else
      printf( "Problem creating directory '\\testtmp'\n" );
}

Résultat de l'exemple

Directory '\testtmp' was successfully created
 Volume in drive C has no label.
 Volume Serial Number is E078-087A

 Directory of C:\testtmp

02/12/2002  09:56a      <DIR>          .
02/12/2002  09:56a      <DIR>          ..
               0 File(s)              0 bytes
               2 Dir(s)  15,498,690,560 bytes free
Directory '\testtmp' was successfully removed

Équivalent .NET Framework

Voir aussi

Référence

Contrôle de répertoire

_chdir, _wchdir

_rmdir, _wrmdir