_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 nouveau répertoire.
Valeur de retour
Chacune de ces fonctions retourne la valeur 0 si le répertoire a été créé. Sur une erreur, la fonction retourne – 1 et définit errno comme suit.
EEXIST
Le répertoire n'a pas été créé car dirname est le nom d'un fichier, d'un répertoire, ou d'une unité existant.ENOENT
Chemin d'accès introuvable.
Pour plus d'informations sur ces codes de retour et autres, consultez _doserrno, errno, _sys_errlist et _sys_nerr.
Notes
La fonction _mkdir crée un nouveau répertoire avec le dirname spécifié._mkdir peut uniquement créer un nouveau répertoire par appel, donc seul le dernier composant de dirname peut nommer un nouveau répertoire. _mkdir ne traduit pas les séparateurs de chemin d'accès. Dans 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 les routines de run-time.
_wmkdir est une version à caractères larges de _mkdir; l'argument dirname vers _wmkdir est une chaîne à caractères larges. _wmkdir et _mkdir se comportent sinon de manière identique.
Mappages de routines de texte générique
Routine 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> or <wchar.h> |
Pour plus d'informations sur la compatibilité, consultez Compatibilité dans l'introduction.
Bibliothèques
Toutes les versions des 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