_mkdir, _wmkdir
Crea una nuova directory.
int _mkdir(
const char *dirname
);
int _wmkdir(
const wchar_t *dirname
);
Parametri
- dirname
Percorso per una nuova directory.
Valore restituito
Ognuna di queste funzioni restituisce il valore 0 se la nuova directory è stata creata. In caso di errore, la funzione restituisce 1 ed imposta errno come segue.
EEXIST
La directory non è stata creata in quanto dirname è il nome di un file esistente, di una directory, o di un dispositivo.ENOENT
Percorso non trovato.
Per ulteriori informazioni su questi e altri codici restituiti, vedere _doserrno, errno, _sys_errlist, e _sys_nerr.
Note
La funzione _mkdir crea una nuova directory con il dirname specificato. _mkdir può creare solo una nuova directory per chiamata, in modo che solo l'ultima componente di dirname può denominare una nuova directory. _mkdir non converte i delimitatori del percorso. In Windows NT, sia la barra all'indietro (\) che la barra in avanti (/) sono delimitatori validi del percorso nelle stringhe di caratteri nelle routine a tempo di esecuzione.
_wmkdir è una versione a caratteri estesi di _mkdir; l'argomento dirname in _wmkdir è una stringa di caratteri estesi. _wmkdir e _mkdir si comportano in modo identico in caso contrario.
Mapping di routine di testo generico
Routine Tchar.h |
_UNICODE e _MBCS non definiti |
_MBCS definito |
_UNICODE definito |
---|---|---|---|
_tmkdir |
_mkdir |
_mkdir |
_wmkdir |
Requisiti
Routine |
Intestazione obbligatoria |
---|---|
_mkdir |
<direct.h> |
_wmkdir |
<direct.h> o <wchar.h> |
Per ulteriori informazioni sulla compatibilità, vedere Compatibilità nell'introduzione.
Librerie
Tutte le versioni delle Librerie di runtime C.
Esempio
// 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" );
}
Esempio di output
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