_mkdir, _wmkdir

Membuat direktori baru.

Sintaks

int _mkdir(
   const char *dirname
);
int _wmkdir(
   const wchar_t *dirname
);

Parameter

dirname
Jalur untuk direktori baru.

Nilai hasil

Masing-masing fungsi ini mengembalikan nilai 0 jika direktori baru dibuat. Pada kesalahan, fungsi mengembalikan -1 dan mengatur errno sebagai berikut.

EEXIST Direktori tidak dibuat karena dirname merupakan nama file, direktori, atau perangkat yang sudah ada.

ENOENT Jalur tidak ditemukan.

Untuk informasi selengkapnya tentang kode pengembalian ini dan lainnya, lihat errno, , _doserrno_sys_errlist, dan _sys_nerr.

Keterangan

Fungsi ini _mkdir membuat direktori baru dengan yang ditentukan dirname. _mkdir hanya dapat membuat satu direktori baru per panggilan, jadi hanya komponen terakhir yang dirname dapat memberi nama direktori baru. _mkdir tidak menerjemahkan pemisah jalur. Di Windows NT, garis miring terbelakang (\) dan garis miring/ () adalah pemisah jalur yang valid dalam string karakter dalam rutinitas run-time.

_wmkdir adalah versi karakter luas dari _mkdir; dirname argumen ke _wmkdir adalah string karakter lebar. _wmkdir dan _mkdir berulah secara identik jika tidak.

Secara default, status global fungsi ini dicakup ke aplikasi. Untuk mengubah perilaku ini, lihat Status global di CRT.

Pemetaan rutin teks generik

Tchar.h Rutin	_UNICODE dan _MBCS tidak ditentukan	_MBCS Didefinisikan	_UNICODE Didefinisikan
_tmkdir	_mkdir	_mkdir	_wmkdir

Persyaratan

Rutin	Header yang diperlukan
_mkdir	<direct.h>
_wmkdir	<direct.h> atau <wchar.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Pustaka

Semua versi pustaka run-time C.

Contoh

// 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" );
}

Sampel 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

Baca juga

Kontrol direktori
_chdir, _wchdir
_rmdir, _wrmdir