_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 – 1 retorna de função e conjuntos de errno da seguinte maneira.

• EEXIST
  Diretório não foi criado porque dirname é o nome de um arquivo existente, diretório ou dispositivo.

• ENOENT
  Caminho não foi encontrado.

Para obter mais informações sobre esses e outros códigos de retorno, consulte _doserrno, errno, _sys_errlist e _sys_nerr.

Comentários

O _mkdir função cria uma nova pasta com o especificado dirname._mkdir pode criar apenas um novo diretório por chamada, para que somente o último componente do dirname pode nomear um novo diretório. _mkdirnão converte os delimitadores de caminho.No Windows NT, a barra invertida (\) e o da barra diagonal (/) são delimitadores de caminho válido em seqüências de caracteres nas rotinas de tempo de execução.

_wmkdiré uma versão de caractere largo de _mkdir; o dirname argumento para _wmkdir é uma seqüência de caracteres largos._wmkdire _mkdir tenham comportamento idêntico caso contrário.

Mapeamentos de rotina de texto genérico

Requisitos

Para obter mais informações de compatibilidade, consulte compatibilidade na introdução.

Bibliotecas

Todas as versões da bibliotecas de 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

Equivalência do .NET Framework

• System::IO::Directory::CreateDirectory

• System::IO::DirectoryInfo::CreateSubdirectory

Consulte também

Referência

Controle de diretório

_chdir, _wchdir

_rmdir, _wrmdir