Preview Ruby 4.1 is a preview. It can change before the final release. Switch to Ruby 4.0 →
class method
Dir.mkdir
(::path dirname, ?::int permissions) -> 0
Dir.mkdir(dirpath, permissions = 0775) → 0
dir.c
View on GitHub ↗
static VALUE
dir_s_mkdir(int argc, VALUE *argv, VALUE obj)
{
struct mkdir_arg m;
VALUE path, vmode;
int r;
if (rb_scan_args(argc, argv, "11", &path, &vmode) == 2) {
m.mode = NUM2MODET(vmode);
}
else {
m.mode = 0777;
}
path = check_dirname(path);
m.path = RSTRING_PTR(path);
r = IO_WITHOUT_GVL_INT(nogvl_mkdir, &m);
if (r < 0)
rb_sys_fail_path(path);
return INT2FIX(0);
}
Creates a directory in the underlying file system at dirpath with the given permissions; see File Permissions:
Example
Dir.mkdir('foo') File.stat(Dir.new('foo')).mode.to_s(8) # => "40775" Dir.mkdir('bar', 0644) File.stat(Dir.new('bar')).mode.to_s(8) # => "40644" Dir.rmdir('foo') Dir.rmdir('bar')
Argument permissions is ignored on Windows.