_mkdir, _wmkdir
Cria um novo diretório.
int _mkdir(
const char *dirname
);
int _wmkdir(
const wchar_t *dirname
);
Parâmetros
- dirname
Caminho para um novo diretório.
Valor de retorno
Cada uma dessas funções retornará o valor 0 se o novo diretório foi criado.Em um erro, a função retorna – 1 e define errno sistema autônomo a seguir.
EEXIST
Diretório não foi criado porque dirname é o nome de um arquivo, diretório ou dispositivo.ENOENT
Caminho não encontrado.
Para obter mais informações sobre esses e outros códigos de retorno, consulte _doserrno, errno, _sys_errlist e _sys_nerr.
Comentários
The _mkdir function creates a new directory with the specified dirname. _mkdir can create only one new directory per call, so only the last component of dirname can name a new directory._mkdir não converte os delimitadores de caminho. No Windows NT, tanto barra / / / invertida (\) e barra / / / (/) são delimitadores de caminho válido em seqüências de caractere nas rotinas de time de execução.
_wmkdir é uma versão de caractere largo da _mkdir; o dirname argumento para _wmkdir é uma seqüência de caracteres largos. _wmkdir e _mkdir tenham comportamento idêntico caso contrário.
Mapeamentos de rotina de texto genérica
Rotina tchar.h |
_UNICODE e _MBCS não definido |
_MBCS definido |
_UNICODE definido |
---|---|---|---|
_tmkdir |
_mkdir |
_mkdir |
_wmkdir |
Requisitos
Rotina |
Cabeçalho necessário |
---|---|
_mkdir |
<direct.h> |
_wmkdir |
<direct.h> ou <wchar.h> |
Para obter mais informações de compatibilidade, consulte Compatibilidade na introdução.
Bibliotecas
Todas as versões do C em time de execução bibliotecas.
Exemplo
// 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" );
}
Saída de exemplo
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