_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