_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 retorna o valor 0 se o novo diretório foi criado. Em um erro, a função retornará – 1 e defina errno seguinte maneira.
EEXIST
O diretório não foi criado porque dirname é o nome de um arquivo existente, de um diretório, ou dispositivo.ENOENT
O caminho não foi encontrado.
Para obter mais informações sobre esses e outros códigos de retorno, consulte _doserrno, errno, _sys_errlist, and _sys_nerr.
Comentários
A função _mkdir cria um novo diretório com o dirname especificado. _mkdir só pode criar um novo diretório por chamada, de forma que apenas o componente o mais recente de dirname pode nomear um novo diretório. _mkdir não traduz delimitadores de caminho. No Windows NT, a barra invertida (\) e a barra (/) são válidos delimitadores de caminho em cadeias de caracteres em rotinas de tempo de execução.
_wmkdir é uma versão de caractere longo de _mkdir; o argumento dirname para _wmkdir é uma cadeia de caractere longo. Caso contrário, _wmkdir e _mkdir, ao contrário, se comportam de forma idêntica.
Mapeamentos da rotina de texto genérico
Rotina Tchar.h |
_UNICODE e _MBCS não definidos |
_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 sobre compatibilidade, consulte Compatibilidade na Introdução.
Bibliotecas
Todas as versões das Bibliotecas em tempo de execução C.
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