Ruby Dir Class and Methods
DirRepresents a directory stream for giving filenames in directories in the operating system. The Dir class also has directory-related operations, such as wildcard filename matching, changing the working directory, etc.
Class Methods
| No. | Method & Description |
|---|---|
| 1 | Dir[pat] Dir::glob( pat) Returns an array containing filenames that match the specified wildcard pattern pat:
Dir["foo.?"] # matches "foo.c", "foo.h", etc. |
| 2 | Dir::chdir( path) Changes the current directory. |
| 3 | Dir::chroot( path) Changes the root directory (allowed only for superusers). Not available on all platforms. |
| 4 | Dir::delete( path) Deletes the directory specified by path. The directory must be empty. |
| 5 | Dir::entries( path) Returns an array containing the filenames in the directory path. |
| 6 | Dir::foreach( path) {| f| ...} Executes the block once for each file in the directory specified by path. |
| 7 | Dir::getwd Dir::pwd Returns the current directory. |
| 8 | Dir::mkdir( path[, mode=0777]) Creates the directory specified by path. The permission mode can be modified by the value of File::umask and is ignored on Win32 platforms. |
| 9 | Dir::new( path) Dir::open( path) Dir::open( path) {| dir| ...} Returns a new directory object for path. If a block is given to open, the new directory object is passed to the block, and the block closes the directory object before terminating. |
| 10 | Dir::pwd See Dir::getwd. |
| 11 | Dir::rmdir( path) Dir::unlink( path) Dir::delete( path) Deletes the directory specified by path. The directory must be empty. |
Instance Methods
AssumedYesDirAn instance of the class:
| No. | Method & Description |
|---|---|
| 1 | d.close Closes the directory stream. |
| 2 | d.each {| f| ...} Executes the block once for each entry in d. |
| 3 | d.pos d.tell Returns the current position in d. |
| 4 | d.pos= offset Sets the position in the directory stream. |
| 5 | d.pos= pos d.seek(pos) Moves to a position in d. pos must be a value returned by d.pos or 0. |
| 6 | d.read Returns the next entry in d. |
| 7 | d.rewind Moves the position in d to the first entry. |
| 8 | d.seek(po s) See d.pos=pos. |
| 9 | d.tell See d.pos. |