Ruby Basic Tutorial

Ruby Advanced Tutorial

Ruby Exceptions Ruby File Class and Methods

Ruby Dir Class and Methods

Dir is a directory stream used to provide filenames in the directory of the operating system. The Dir class also has operations related to directories, such as wildcard filename matching, changing the working directory, etc.

Class method

Number	Methods & Descriptions
1	Dir[pat] Dir::glob( pat) Returns an array containing filenames that match the specified wildcard pattern pat: * - Matches any string containing a null string - Matches any string recursively ? - Matches any single character [...] - Matches any character within the enclosed characters {a,b...}** - Matches any character in the string Dir["foo.*"] # Matches "foo.c", "foo.rb", etc. Dir["foo.?"] # Matches "foo.c", "foo.h", etc.
2	Dir::chdir( path) Changes the current directory.
3	Dir::chroot( path) Changes the root directory (only allowed for superuser). Not available on all platforms.
4	Dir::delete( path) Delete 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\| ...} Execute a block for each file in the directory specified by path.
7	Dir::getwd Dir::pwd Returns the current directory.
8	Dir::mkdir( path[, mode=0)777]) Creates the directory specified by path. The permission mode can be modified by the value of File::umask, on Win32 is ignored on some platforms.
9	Dir::new( path) Dir::open( path) Dir::open( path) {\| dir\| ...} Returns a new directory object for path. If open yields a block, the new directory object is passed to the block, and the directory object is closed before the block terminates.
10	Dir::pwd See also Dir::getwd.
11	Dir::rmdir( path) Dir::unlink( path) Dir::delete( path) Delete the directory specified by path. The directory must be empty.

Example Method

Assuming d is Dir An example of a class:

Number	Methods & Descriptions
1	d.close Close the directory stream.
2	d.each {\| f\| ...} Execute a block for each entry in d.
3	d.pos d.tell Return the current position in d.
4	d.pos= offset Set the position in the directory stream.
5	d.pos= pos d.seek(pos) Move to a position in d. pos must be a value returned by d.pos or 0.
6	d.read Return the next entry of d.
7	d.rewind Move the position in d to the first entry.
8	d.seek(po s) See d.pos=pos.
9	d.tell See d.pos.

Ruby Exceptions Ruby File Class and Methods